// 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.