Import por URL

Visão geral

O Import por URL permite criar produtos colando a URL de uma página de produto. A Alana usa a infraestrutura de scraping do Bright Data para extrair dados estruturados da página, mapeá-los para o schema da Alana e executar automaticamente o pipeline Bronze → Silver.

Como funciona

Você submete a URL de uma página de produto
O Bright Data busca a página (lidando com renderização JavaScript, CAPTCHAs e restrições geográficas)
O scraper extrai: título, descrição, imagens, preço, marca, especificações
Os dados extraídos são mapeados para o schema de produto da Alana (Bronze)
O Silver normaliza o resultado automaticamente
O produto aparece no seu catálogo

Métodos de scraping

Método	Descrição	Melhor para
`web_scraper`	Renderização completa de JavaScript, extração de dados estruturados	Páginas de produto com conteúdo dinâmico
`web_unlocker`	Contorna proteções anti-bot	Varejistas com detecção agressiva de bots
`crawl`	Segue links para extrair múltiplos produtos de uma página de categoria	Páginas de categoria ou coleção

Importar uma única URL

Via UI

Abra seu catálogo
Clique em Adicionar Produtos → Importar por URL
Cole a URL da página de produto
Selecione o método de scraping (padrão: web_scraper)
Clique em Importar
Um job é criado — o produto aparece no catálogo em 30–90 segundos

Via API

curl -X POST "https://app.alana.shopping/api/workspace/WORKSPACE_ID/url-import" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.exemplo.com/produtos/tenis-running-pro",
    "catalogId": "CATALOG_ID",
    "method": "web_scraper"
  }'

const response = await fetch(
  `https://app.alana.shopping/api/workspace/${workspaceId}/url-import`,
  {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${apiKey}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      url: 'https://www.exemplo.com/produtos/tenis-running-pro',
      catalogId,
      method: 'web_scraper',
    }),
  }
);
const { jobId, status } = await response.json();
console.log(`Job de import ${jobId} iniciado com status: ${status}`);

import requests

response = requests.post(
    f"https://app.alana.shopping/api/workspace/{workspace_id}/url-import",
    headers={"Authorization": f"Bearer {api_key}"},
    json={
        "url": "https://www.exemplo.com/produtos/tenis-running-pro",
        "catalogId": catalog_id,
        "method": "web_scraper",
    }
)
job = response.json()
print(f"Job de import {job['jobId']} iniciado")

Resposta

{
  "jobId": "job_9x8k2m",
  "status": "processing",
  "url": "https://www.exemplo.com/produtos/tenis-running-pro",
  "estimatedSeconds": 45
}

Importar múltiplas URLs (em lote)

curl -X POST "https://app.alana.shopping/api/workspace/WORKSPACE_ID/url-import/bulk" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": [
      "https://www.exemplo.com/produtos/item-1",
      "https://www.exemplo.com/produtos/item-2",
      "https://www.exemplo.com/produtos/item-3"
    ],
    "catalogId": "CATALOG_ID",
    "method": "web_scraper"
  }'

const response = await fetch(
  `https://app.alana.shopping/api/workspace/${workspaceId}/url-import/bulk`,
  {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${apiKey}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      urls: [
        'https://www.exemplo.com/produtos/item-1',
        'https://www.exemplo.com/produtos/item-2',
        'https://www.exemplo.com/produtos/item-3',
      ],
      catalogId,
      method: 'web_scraper',
    }),
  }
);
const { batchJobId, urlCount } = await response.json();

import requests

response = requests.post(
    f"https://app.alana.shopping/api/workspace/{workspace_id}/url-import/bulk",
    headers={"Authorization": f"Bearer {api_key}"},
    json={
        "urls": [
            "https://www.exemplo.com/produtos/item-1",
            "https://www.exemplo.com/produtos/item-2",
        ],
        "catalogId": catalog_id,
        "method": "web_scraper",
    }
)
batch = response.json()
print(f"Job em lote {batch['batchJobId']} para {batch['urlCount']} URLs")

Rastrear uma página de categoria

Use o método crawl para importar todos os produtos de uma página de categoria ou coleção:

curl -X POST "https://app.alana.shopping/api/workspace/WORKSPACE_ID/url-import" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.exemplo.com/categoria/tenis-running",
    "catalogId": "CATALOG_ID",
    "method": "crawl",
    "crawlOptions": {
      "maxProducts": 100,
      "followPagination": true
    }
  }'

const response = await fetch(
  `https://app.alana.shopping/api/workspace/${workspaceId}/url-import`,
  {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${apiKey}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      url: 'https://www.exemplo.com/categoria/tenis-running',
      catalogId,
      method: 'crawl',
      crawlOptions: { maxProducts: 100, followPagination: true },
    }),
  }
);

import requests

response = requests.post(
    f"https://app.alana.shopping/api/workspace/{workspace_id}/url-import",
    headers={"Authorization": f"Bearer {api_key}"},
    json={
        "url": "https://www.exemplo.com/categoria/tenis-running",
        "catalogId": catalog_id,
        "method": "crawl",
        "crawlOptions": {"maxProducts": 100, "followPagination": True},
    }
)

Verificar status do job

curl "https://app.alana.shopping/api/workspace/WORKSPACE_ID/url-import/JOB_ID" \
  -H "Authorization: Bearer SUA_API_KEY"

const response = await fetch(
  `https://app.alana.shopping/api/workspace/${workspaceId}/url-import/${jobId}`,
  { headers: { 'Authorization': `Bearer ${apiKey}` } }
);
const { status, productId, error } = await response.json();

import requests

response = requests.get(
    f"https://app.alana.shopping/api/workspace/{workspace_id}/url-import/{job_id}",
    headers={"Authorization": f"Bearer {api_key}"}
)
job = response.json()
print(f"Status: {job['status']}, Product ID: {job.get('productId')}")

Valores de status do job

Status	Descrição
`processing`	O Bright Data está buscando e analisando a página
`success`	Produto criado no catálogo
`partial`	Produto criado com alguns campos ausentes
`failed`	A página não pôde ser raspada (veja o campo `error`)

Limites de uso e custos

Métrica	Limite
Imports de URL única	100/hora por workspace
Imports em lote	500 URLs/requisição
Máximo de produtos por crawl	500/crawl
Jobs simultâneos	10 por workspace

O custo por import é debitado do seu saldo de créditos Bright Data. Os custos variam por método:

Método	Custo aproximado
`web_scraper`	0,001 créditos/página
`web_unlocker`	0,005 créditos/página
`crawl`	0,001 créditos/produto encontrado

Veja seu uso de créditos Bright Data em Configurações → Integrações → Bright Data.

Boas práticas

Teste com uma única URL antes do import em lote

Sempre teste uma URL primeiro para confirmar que o scraper extrai corretamente os campos que você precisa. Varejistas diferentes têm estruturas de página diferentes.

Use web_unlocker para grandes varejistas

Sites como Amazon, Mercado Livre e grandes varejistas de moda têm detecção de bot. Use web_unlocker para evitar imports com falha.

Use crawl para imports no nível de categoria

Quando quiser todos os produtos de uma categoria, crawl é mais eficiente do que colar a URL de cada produto individualmente.

Verifique resultados parciais

Um status partial significa que o produto foi criado mas alguns campos não puderam ser extraídos. Revise esses produtos no Canvas e preencha os campos ausentes manualmente.

Primeiros Passos

Conceitos Fundamentais

Guias

Visão geral

Como funciona

Métodos de scraping

Importar uma única URL

Via UI

Via API

Resposta

Importar múltiplas URLs (em lote)

Rastrear uma página de categoria

Verificar status do job

Valores de status do job

Limites de uso e custos

Boas práticas

​Visão geral

​Como funciona

​Métodos de scraping

​Importar uma única URL

​Via UI

​Via API

​Resposta

​Importar múltiplas URLs (em lote)

​Rastrear uma página de categoria

​Verificar status do job

​Valores de status do job

​Limites de uso e custos

​Boas práticas

Visão geral

Como funciona

Métodos de scraping

Importar uma única URL

Via UI

Via API

Resposta

Importar múltiplas URLs (em lote)

Rastrear uma página de categoria

Verificar status do job

Valores de status do job

Limites de uso e custos

Boas práticas