// docs

OLX PDP

Extrai dados detalhados de um anúncio da OLX com hash LGPD para sellerName e telefones.

Nota importante: alguns campos podem retornar null em produção, dependendo da página de origem. Nesta documentação, os exemplos de output são preenchidos intencionalmente com valores não nulos para facilitar integração.

Chamada HTTP

cURL
curl -X POST https://api.geckoapi.com.br/v1/extract \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
  "target": "olx.com.br",
  "type": "pdp",
  "url": "https://pr.olx.com.br/regiao-de-curitiba-e-paranagua/celulares/iphone-17-pro-256gb-e-sim-laranja-loja-fisica-com-garantia-nota-foscam-br-cor-laranja-1470653416"
}'

Possibilidades de input

Campos suportados nesta API do POST /v1/extract, com regras específicas de obrigatoriedade e condicionais.

Campo Tipo Status Regra Default Exemplo
url
URL alvo da extração. Para alguns PLPs pode ser omitida quando a API monta a URL a partir de outros campos.
string (URL) Obrigatório URL do anúncio no domínio olx.com.br. - https://www.mercadolivre.com.br/p/MLB123456
target
Fonte alvo da extração.
enum Obrigatório Sempre obrigatorio e deve ser olx.com.br. - mercadolivre.com.br
type
Tipo da extração: pdp, plp, review ou places.
enum Obrigatório Sempre obrigatorio e deve ser pdp. - pdp

Exemplos de request

PDP por URL

Envie a URL pública do anúncio da OLX. O backend valida domínio e aplica hash nos dados sensíveis.

PDP por URL
{
  "target": "olx.com.br",
  "type": "pdp",
  "url": "https://pr.olx.com.br/regiao-de-curitiba-e-paranagua/celulares/iphone-17-pro-256gb-e-sim-laranja-loja-fisica-com-garantia-nota-foscam-br-cor-laranja-1470653416"
}

Schema de response (leaf paths)

Mapa de paths de saída com tipo esperado para esta API.

responseSchema
{
  "requestId": "string (uuid)",
  "executionId": "string (uuid)",
  "data.source": "string",
  "data.type": "string",
  "data.parser": "string",
  "data.requestUrl": "string",
  "data.extractedAt": "string (iso datetime)",
  "data.data.url": "string",
  "data.data.listingId": "string",
  "data.data.adId": "string",
  "data.data.title": "string",
  "data.data.description": "string",
  "data.data.price": "number",
  "data.data.currency": "string",
  "data.data.listedAt": "string (iso datetime)",
  "data.data.listedAtEpoch": "number",
  "data.data.category": "string",
  "data.data.mainCategory": "string",
  "data.data.subCategory": "string",
  "data.data.location.state": "string",
  "data.data.location.city": "string",
  "data.data.location.neighborhood": "string",
  "data.data.location.region": "string",
  "data.data.location.ddd": "string",
  "data.data.location.zipCode": "string",
  "data.data.seller.id": "string",
  "data.data.seller.isProfessional": "boolean",
  "data.data.seller.nameHash": "string",
  "data.data.phoneHashes[]": "string",
  "data.data.images[].url": "string",
  "data.data.attributes[].name": "string",
  "data.data.attributes[].label": "string",
  "data.data.attributes[].value": "string",
  "data.data.attributes[].url": "string",
  "data.data.olxPayEnabled": "boolean",
  "data.data.olxDeliveryEnabled": "boolean"
}

Exemplo de response

responseExample
{
  "requestId": "9d0db4f1-b7d8-4d71-9dbe-9d61a41b9521",
  "executionId": "9d0db4f1-b7d8-4d71-9dbe-9d61a41b9522",
  "data": {
    "source": "olx.com.br",
    "type": "pdp",
    "parser": "data_layer",
    "requestUrl": "https://pr.olx.com.br/regiao-de-curitiba-e-paranagua/celulares/iphone-17-pro-256gb-e-sim-laranja-loja-fisica-com-garantia-nota-foscam-br-cor-laranja-1470653416",
    "extractedAt": "2026-02-21T15:11:00.000Z",
    "data": {
      "url": "https://pr.olx.com.br/regiao-de-curitiba-e-paranagua/celulares/iphone-17-pro-256gb-e-sim-laranja-loja-fisica-com-garantia-nota-foscam-br-cor-laranja-1470653416",
      "listingId": "1470653416",
      "adId": "1744665066",
      "title": "iPhone 17 Pro 256GB | E-Sim - Laranja",
      "description": "Contato direto por WhatsApp para consulta de disponibilidade.",
      "price": 7749,
      "currency": "BRL",
      "listedAt": "2026-02-21T03:16:20.000Z",
      "listedAtEpoch": 1771598180,
      "category": "Celulares e Smartphones",
      "mainCategory": "Celulares e Telefonia",
      "subCategory": "Celulares e Smartphones",
      "location": {
        "state": "PR",
        "city": "Curitiba",
        "neighborhood": "Agua Verde",
        "region": "Curitiba e região",
        "ddd": "41",
        "zipCode": "80220202"
      },
      "seller": {
        "id": "4cdc1953-0588-40e9-80d4-60b79a307fe1",
        "isProfessional": true,
        "nameHash": "35ad2fcfe8d16f39d3f0cc9e4e4f6104c4f2f6f5968e45a15bf955cfec1487ca"
      },
      "phoneHashes": [
        "be5334a94ecdf42f2a191b53063de78907a3d128ec83034e8e82a4890f4f6ba7"
      ],
      "images": [
        {
          "url": "https://img.olx.com.br/images/20/201655000258589.jpg"
        }
      ],
      "attributes": [
        {
          "name": "electronics_brand",
          "label": "Marca",
          "value": "APPLE",
          "url": "https://www.olx.com.br/celulares/estado-pr/regiao-de-curitiba-e-paranagua/matriz"
        }
      ],
      "olxPayEnabled": false,
      "olxDeliveryEnabled": false
    }
  }
}

Referência completa de campos

Path Tipo Descrição Exemplo
data.data.adId string ID interno do anúncio. 1744665066
data.data.attributes[].label string Rótulo legível do atributo. Marca
data.data.attributes[].name string Identificador técnico do atributo. electronics_brand
data.data.attributes[].url string URL de navegação relacionada ao atributo quando disponível. https://www.olx.com.br/celulares/estado-pr/regiao-de-curitiba-e-paranagua/matriz
data.data.attributes[].value string Valor do atributo. APPLE
data.data.category string Categoria do anúncio. Celulares e Smartphones
data.data.currency string Moeda do anúncio. BRL
data.data.description string Descrição normalizada do anúncio. Contato direto por WhatsApp para consulta de disponibilidade.
data.data.images[].url string URL de imagem do anúncio. https://img.olx.com.br/images/20/201655000258589.jpg
data.data.listedAt string (iso datetime) Data/hora ISO de publicação. 2026-02-21T03:16:20.000Z
data.data.listedAtEpoch number Timestamp unix (segundos) de publicação. 1771598180
data.data.listingId string ID da listagem OLX. 1470653416
data.data.location.city string Cidade do anúncio. Curitiba
data.data.location.ddd string DDD associado ao anúncio. 41
data.data.location.neighborhood string Bairro do anúncio. Agua Verde
data.data.location.region string Região informada no anúncio. Curitiba e região
data.data.location.state string UF do anúncio. PR
data.data.location.zipCode string CEP associado ao anúncio. 80220202
data.data.mainCategory string Categoria principal do anúncio. Celulares e Telefonia
data.data.olxDeliveryEnabled boolean Indica se OLX Delivery está habilitado. false
data.data.olxPayEnabled boolean Indica se OLX Pay está habilitado. false
data.data.phoneHashes[] string Lista de hashes SHA-256 de telefones detectados no anúncio. be5334a94ecdf42f2a191b53063de78907a3d128ec83034e8e82a4890f4f6ba7
data.data.price number Preço numérico normalizado. 7749
data.data.seller.id string Identificador público da conta vendedora. 4cdc1953-0588-40e9-80d4-60b79a307fe1
data.data.seller.isProfessional boolean Indica se o vendedor é profissional. true
data.data.seller.nameHash string Hash SHA-256 do nome do vendedor (LGPD). 35ad2fcfe8d16f39d3f0cc9e4e4f6104c4f2f6f5968e45a15bf955cfec1487ca
data.data.subCategory string Subcategoria do anúncio. Celulares e Smartphones
data.data.title string Título principal do anúncio. iPhone 17 Pro 256GB | E-Sim - Laranja
data.data.url string URL pública do anúncio. https://pr.olx.com.br/regiao-de-curitiba-e-paranagua/celulares/iphone-17-pro-256gb-e-sim-laranja-loja-fisica-com-garantia-nota-foscam-br-cor-laranja-1470653416
data.extractedAt string (iso datetime) Timestamp UTC da extração. 2026-02-21T15:11:00.000Z
data.parser string Parser utilizado no backend (data_layer ou jsonld). data_layer
data.requestUrl string URL efetivamente consultada no upstream. https://pr.olx.com.br/regiao-de-curitiba-e-paranagua/celulares/iphone-17-pro-256gb-e-sim-laranja-loja-fisica-com-garantia-nota-foscam-br-cor-laranja-1470653416
data.source string Fonte da extração. olx.com.br
data.type string Tipo da extração. pdp
executionId string (uuid) Campo executionId retornado no payload de resposta. 9d0db4f1-b7d8-4d71-9dbe-9d61a41b9522
requestId string (uuid) Campo requestId retornado no payload de resposta. 9d0db4f1-b7d8-4d71-9dbe-9d61a41b9521

Erros comuns

Status errorCode Quando acontece
400 INVALID_PAYLOAD JSON inválido ou violação das regras de validação do payload.
401 UNAUTHORIZED Header Authorization ausente ou token/chave inválida.
402 INSUFFICIENT_CREDITS Saldo de créditos insuficiente para a API solicitada.
403 FORBIDDEN Usuário sem acesso ou API temporariamente desabilitada.
409 EXECUTION_CONFLICT executionId conflita com uma execução em estado incompatível.
429 RATE_LIMIT_EXCEEDED / TOO_MANY_INFLIGHT_REQUESTS Limite de taxa ou limite de requisições em voo excedido.
5xx UPSTREAM_TIMEOUT / UPSTREAM_HTTP_ERROR / WORKER_INVOCATION_FAILED / WORKER_FUNCTION_ERROR / WORKER_INVALID_RESPONSE / INTERNAL_ERROR Falha de servidor no worker, provider/proxy ou gateway. Nesses casos os créditos são estornados automaticamente.
WhatsApp