Anúncios Classificados API

API ID 14552

Pesquisar Facebook Marketplace OLX Wallapop Leboncoin e Custojusto em uma API JSON: localizador de mais barato comparador de preços e detalhes completos da listagem

Documentação da API

Endpoints

Requisição
Retorna os marketplaces suportados com seu id, rótulo e país, para que você saiba quais valores de origem pode passar para os pontos finais de busca
Endpoint ID: 37262
GET https://zylalabs.com/api/14552/classifieds+listings+api/37262/list+sources
PARÂMETROS DE ENTRADA

Solicitações gratuitas de teste restantes: 3 de 3.

Este endpoint não requer parâmetros de entrada.

RESPOSTA DE EXEMPLO DA API
JSON
{
    "data": {
        "sources": [
            {
                "country": "PT",
                "id": "olx",
                "label": "OLX"
            },
            {
                "country": "ES",
                "id": "wallapop",
                "label": "Wallapop"
            },
            {
                "country": "FR",
                "id": "leboncoin",
                "label": "Leboncoin"
            },
            {
                "country": "PT",
                "id": "custojusto",
                "label": "Custojusto"
            },
            {
                "country": "GLOBAL",
                "id": "facebook",
                "label": "Facebook Marketplace"
            }
        ]
    },
    "error": null,
    "message": "Success"
}
Listar Fontes — TRECHOS DE CÓDIGO

curl --location --request GET 'https://zylalabs.com/api/14552/classifieds+listings+api/37262/list+sources' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Requisição
Pesquisa em um único marketplace (facebook, olx, wallapop, leboncoin ou custojusto) e retorna listagens normalizadas com preço, imagens, localização e vendedor
Endpoint ID: 37263
GET https://zylalabs.com/api/14552/classifieds+listings+api/37263/search+one+source
PARÂMETROS DE ENTRADA

Pesquisar Uma Fonte — Recursos do endpoint

Objeto Descrição
query Obrigatório Keyword search text for the listings.
category Opcional Source-specific category id to narrow the search.
location Opcional City, zip code or lat,lon depending on the source.
minPrice Opcional Minimum price in the source currency.
maxPrice Opcional Maximum price in the source currency.
sortBy Opcional One of relevance, price_asc, price_desc or date.
page Opcional Page number, default 1.
limit Opcional Results per page, default 30, maximum 100.
cursor Opcional Wallapop only: nextCursor token from the previous response.
source Obrigatório

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

query
category
location
minPrice
maxPrice
sortBy
page
limit
cursor
RESPOSTA DE EXEMPLO DA API
JSON
{
    "data": {
        "hasMore": true,
        "listings": [
            {
                "category": "Telefones e Acessorios",
                "currency": "EUR",
                "id": "custojusto:45469559",
                "images": [
                    "https://prod-images.custojusto.pt/example.jpg"
                ],
                "location": {
                    "county": "Esposende",
                    "district": "Braga"
                },
                "postedAt": "2026-10-27T13:05:33Z",
                "price": 300,
                "seller": {
                    "isCompany": false,
                    "name": "filipa07silva"
                },
                "source": "custojusto",
                "sourceId": "45469559",
                "title": "iPhone 14 Midnight 128GB com Caixa",
                "url": "https://www.custojusto.pt/braga/telemoveis/iphone-14-45469559"
            }
        ],
        "source": "custojusto",
        "total": null
    },
    "error": null,
    "message": "Success"
}
Pesquisar Uma Fonte — TRECHOS DE CÓDIGO

curl --location --request GET 'https://zylalabs.com/api/14552/classifieds+listings+api/37263/search+one+source?query=iphone&maxPrice=500&limit=10&source=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Requisição
Retorna o registro completo de uma listagem, incluindo todas as imagens e informações do vendedor. Use o sourceId para Wallapop e Facebook, ou o caminho de URL codificado para as outras fontes
Endpoint ID: 37264
GET https://zylalabs.com/api/14552/classifieds+listings+api/37264/get+listing+detail
PARÂMETROS DE ENTRADA

Solicitações gratuitas de teste restantes: 3 de 3.

RESPOSTA DE EXEMPLO DA API
JSON
{
    "data": {
        "currency": "EUR",
        "id": "wallapop:wzvg1qglddzl",
        "images": [
            "https://cdn.wallapop.com/example.jpg"
        ],
        "price": 120,
        "seller": {
            "isCompany": false,
            "name": "maria"
        },
        "source": "wallapop",
        "title": "Sofa 3 plazas",
        "url": "https://es.wallapop.com/item/sofa-wzvg1qglddzl"
    },
    "error": null,
    "message": "Success"
}
Obter Detalhes do Anúncio — TRECHOS DE CÓDIGO

curl --location --request GET 'https://zylalabs.com/api/14552/classifieds+listings+api/37264/get+listing+detail&source=Required&/listing/=Required&id=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Requisição
Os fãs enviam uma consulta para vários mercados em paralelo e retornam uma lista mesclada e classificada Uma fonte que falha é reportada como erro sem falhar a solicitação
Endpoint ID: 37265
GET https://zylalabs.com/api/14552/classifieds+listings+api/37265/search+multiple+sources
PARÂMETROS DE ENTRADA

Pesquisar Múltiplas Fontes — Recursos do endpoint

Objeto Descrição
query Obrigatório Keyword search text for the listings.
sources Opcional Comma separated sources, all five if omitted.
minPrice Opcional Minimum price in the source currency.
maxPrice Opcional Maximum price in the source currency.
limit Opcional Results per source, default 30, maximum 100.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

query
sources
minPrice
maxPrice
limit
RESPOSTA DE EXEMPLO DA API
JSON
{
    "data": {
        "count": 10,
        "errors": [],
        "listings": [
            {
                "currency": "EUR",
                "id": "olx:123",
                "price": 150,
                "source": "olx",
                "title": "Sofa de canto",
                "url": "https://www.olx.pt/d/anuncio/sofa-123"
            }
        ],
        "sources": {
            "olx": {
                "count": 5,
                "hasMore": true,
                "ok": true
            },
            "wallapop": {
                "count": 5,
                "hasMore": true,
                "ok": true
            }
        }
    },
    "error": null,
    "message": "Success"
}
Pesquisar Múltiplas Fontes — TRECHOS DE CÓDIGO

curl --location --request GET 'https://zylalabs.com/api/14552/classifieds+listings+api/37265/search+multiple+sources?query=sofa&sources=olx,wallapop&limit=5' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Requisição
Mesma coisa que busca por múltiplas fontes, mas pré-classificada por preço ascendente, respondendo qual é o item mais barato no momento em todos os mercados
Endpoint ID: 37266
GET https://zylalabs.com/api/14552/classifieds+listings+api/37266/find+cheapest+listings
PARÂMETROS DE ENTRADA

Encontre Listagens Mais Baratas — Recursos do endpoint

Objeto Descrição
query Obrigatório Keyword search text for the listings.
sources Opcional Comma separated sources, all five if omitted.
maxPrice Opcional Maximum price in the source currency.
limit Opcional Results per source, default 30, maximum 100.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

query
sources
maxPrice
limit
RESPOSTA DE EXEMPLO DA API
JSON
{
    "data": {
        "count": 2,
        "errors": [],
        "listings": [
            {
                "currency": "EUR",
                "id": "wallapop:abc",
                "price": 210,
                "source": "wallapop",
                "title": "iPhone 13 128GB",
                "url": "https://es.wallapop.com/item/abc"
            },
            {
                "currency": "EUR",
                "id": "olx:456",
                "price": 230,
                "source": "olx",
                "title": "iPhone 13 azul",
                "url": "https://www.olx.pt/d/anuncio/456"
            }
        ]
    },
    "error": null,
    "message": "Success"
}
Encontre Listagens Mais Baratas — TRECHOS DE CÓDIGO

curl --location --request GET 'https://zylalabs.com/api/14552/classifieds+listings+api/37266/find+cheapest+listings?query=iphone 13&sources=olx,wallapop&maxPrice=400&limit=10' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Requisição
Agrupa a mesma consulta por marketplace com contagem preço mínimo preço máximo e preço médio mais um total geral mostrando onde um item é mais barato
Endpoint ID: 37267
GET https://zylalabs.com/api/14552/classifieds+listings+api/37267/compare+prices+by+source
PARÂMETROS DE ENTRADA

Compare Preços Por Fonte — Recursos do endpoint

Objeto Descrição
query Obrigatório Keyword search text for the listings.
sources Opcional Comma separated sources, all five if omitted.
minPrice Opcional Minimum price in the source currency.
maxPrice Opcional Maximum price in the source currency.
limit Opcional Results per source, default 30, maximum 100.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

query
sources
minPrice
maxPrice
limit
RESPOSTA DE EXEMPLO DA API
JSON
{
    "data": {
        "bySource": {
            "olx": {
                "avg": 380.5,
                "count": 20,
                "max": 900,
                "min": 100
            },
            "wallapop": {
                "avg": 450.1,
                "count": 20,
                "max": 1200,
                "min": 85
            }
        },
        "errors": [],
        "overall": {
            "avg": 412.3,
            "count": 40,
            "max": 1200,
            "min": 85
        }
    },
    "error": null,
    "message": "Success"
}
Compare Preços Por Fonte — TRECHOS DE CÓDIGO

curl --location --request GET 'https://zylalabs.com/api/14552/classifieds+listings+api/37267/compare+prices+by+source?query=iphone 13&limit=20' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Requisição
Retorna toda a árvore de categorias do Leboncoin para que você possa escolher um id de categoria para buscas no Leboncoin
Endpoint ID: 37268
GET https://zylalabs.com/api/14552/classifieds+listings+api/37268/leboncoin+categories
PARÂMETROS DE ENTRADA

Solicitações gratuitas de teste restantes: 3 de 3.

Este endpoint não requer parâmetros de entrada.

RESPOSTA DE EXEMPLO DA API
JSON
{
    "data": {
        "categories": [
            {
                "id": "2",
                "name": "Vehicules"
            },
            {
                "id": "9",
                "name": "Immobilier"
            }
        ]
    },
    "error": null,
    "message": "Success"
}
Categorias do Leboncoin — TRECHOS DE CÓDIGO

curl --location --request GET 'https://zylalabs.com/api/14552/classifieds+listings+api/37268/leboncoin+categories' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Requisição
Retorna o breadcrumb e a árvore de categorias do Custojusto para uma determinada consulta e localização
Endpoint ID: 37269
GET https://zylalabs.com/api/14552/classifieds+listings+api/37269/custojusto+categories
PARÂMETROS DE ENTRADA

Categorias Custojusto — Recursos do endpoint

Objeto Descrição
query Opcional Keyword used to build the category tree.
location Opcional City name used to narrow the category tree.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

query
location
RESPOSTA DE EXEMPLO DA API
JSON
{
    "data": {
        "categories": [
            {
                "id": "telemoveis",
                "name": "Telefones e Acessorios"
            }
        ]
    },
    "error": null,
    "message": "Success"
}
Categorias Custojusto — TRECHOS DE CÓDIGO

curl --location --request GET 'https://zylalabs.com/api/14552/classifieds+listings+api/37269/custojusto+categories?query=iphone' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Requisição
Retorna o registro completo bruto da listagem OLX, com todas as imagens e informações completas do vendedor, para um ID de listagem ou URL codificada
Endpoint ID: 37270
GET https://zylalabs.com/api/14552/classifieds+listings+api/37270/olx+raw+listing+state
PARÂMETROS DE ENTRADA

Estado da Listagem Bruta OLX — Recursos do endpoint

Objeto Descrição
id Obrigatório OLX listing id or the URL encoded listing URL.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

id
RESPOSTA DE EXEMPLO DA API
JSON
{
    "data": {
        "id": "123456",
        "images": [
            "https://ireland.apollo.olxcdn.com/example.jpg"
        ],
        "title": "Sofa de canto",
        "user": {
            "name": "Joao"
        }
    },
    "error": null,
    "message": "Success"
}
Estado da Listagem Bruta OLX — TRECHOS DE CÓDIGO

curl --location --request GET 'https://zylalabs.com/api/14552/classifieds+listings+api/37270/olx+raw+listing+state?id=123456' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Requisição
Pesquisa somente de veículos no Wallapop na categoria de Carros filtrável por marca faixa de ano e faixa de preço
Endpoint ID: 37271
GET https://zylalabs.com/api/14552/classifieds+listings+api/37271/wallapop+cars+search
PARÂMETROS DE ENTRADA

Busca de Carros Wallapop — Recursos do endpoint

Objeto Descrição
query Opcional Keyword search text for the cars.
brand Opcional Car brand to filter by.
minYear Opcional Minimum registration year.
maxYear Opcional Maximum registration year.
minPrice Opcional Minimum price in euros.
maxPrice Opcional Maximum price in euros.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

query
brand
minYear
maxYear
minPrice
maxPrice
RESPOSTA DE EXEMPLO DA API
JSON
{
    "data": {
        "hasMore": true,
        "listings": [
            {
                "currency": "EUR",
                "id": "wallapop:car1",
                "price": 9500,
                "title": "Renault Clio 2019",
                "url": "https://es.wallapop.com/item/car1"
            }
        ],
        "source": "wallapop"
    },
    "error": null,
    "message": "Success"
}
Busca de Carros Wallapop — TRECHOS DE CÓDIGO

curl --location --request GET 'https://zylalabs.com/api/14552/classifieds+listings+api/37271/wallapop+cars+search?brand=Renault&minYear=2018' --header 'Authorization: Bearer YOUR_API_KEY' 


    

Chave de acesso à API e autenticação

Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a Anúncios Classificados API basta incluir seu token Bearer no cabeçalho Authorization.

Cabeçalhos
Cabeçalho Descrição
Authorization Obrigatório Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito.

Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento.

A partir de
$10.000/Ano


  • Volume personalizado
  • Limite de taxa personalizado
  • Suporte ao cliente especializado
  • Monitoramento de API em tempo real

Visão Geral

Pesquise no Facebook Marketplace, OLX, Wallapop, Leboncoin e Custojusto em uma API JSON: encontrador de preços mais baixos, comparação de preços e detalhes completos da lista

Anúncios Classificados API FAQs

Facebook Marketplace OLX Wallapop Leboncoin e Custojusto tudo através de um único formulário de solicitação e um objeto de listagem normalizado

Sim Cada resposta é obtida dos marketplaces quando você chama não de um banco de dados desatualizado

Você ainda recebe resultados dos outros e a fonte com falha está listada no array de erros Leboncoin e Wallapop usam proteção contra bots então uma tentativa ocasional pode ser necessária

Chame o endpoint Encontrar Listagens Mais Baratas com uma consulta Ele mescla todas as fontes e classifica por preço em ordem crescente

Use Get Listing Detail Passe o sourceId para Wallapop e Facebook ou o caminho da listagem codificado em URL para OLX Custojusto e Leboncoin

Entre em contato com o suporte no Telegram @pintoflow para perguntas novas fontes campos personalizados ou limites maiores

Perguntas Frequentes Gerais

O Zyla API Hub é como uma grande loja de APIs, onde você pode encontrar milhares delas em um só lugar. Também oferecemos suporte dedicado e monitoramento em tempo real de todas as APIs. Após se cadastrar, você pode escolher quais APIs deseja usar. Lembre-se apenas de que cada API precisa de sua própria assinatura. Mas se você se inscrever em várias, usará a mesma chave para todas elas, facilitando as coisas para você.
Os preços são listados em USD (Dólar Americano), EUR (Euro), CAD (Dólar Canadense), AUD (Dólar Australiano) e GBP (Libra Esterlina). Aceitamos todos os principais cartões de débito e crédito. Nosso sistema de pagamento usa a mais recente tecnologia de segurança e é operado pela Stripe, uma das empresas de pagamento mais confiáveis do mundo. Se tiver problemas para pagar com cartão, entre em contato conosco em [email protected]

Além disso, se você já tiver uma assinatura ativa em qualquer uma dessas moedas (USD, EUR, CAD, AUD, GBP), essa moeda será mantida para assinaturas subsequentes. Você pode alterar a moeda a qualquer momento, desde que não tenha assinaturas ativas.
A moeda local exibida na página de preços é baseada no país do seu endereço IP e é fornecida apenas como referência. Os preços reais são em USD (Dólar Americano). Ao efetuar o pagamento, a cobrança aparecerá no extrato do seu cartão em USD, mesmo que você veja o valor equivalente em sua moeda local em nosso site. Isso significa que você não pode pagar diretamente com sua moeda local.
Ocasionalmente, o banco pode recusar a cobrança devido às configurações de proteção contra fraude. Sugerimos contatar seu banco inicialmente para verificar se estão bloqueando nossas cobranças. Você também pode acessar o Portal de Cobrança e alterar o cartão associado para realizar o pagamento. Se isso não funcionar e precisar de mais ajuda, entre em contato com nossa equipe em [email protected]
Os preços são determinados por uma assinatura recorrente mensal ou anual, dependendo do plano escolhido.
As chamadas de API são descontadas do seu plano com base nas requisições bem-sucedidas. Cada plano possui um número específico de chamadas por mês. Apenas chamadas bem-sucedidas, indicadas por uma resposta com Status 200, serão contabilizadas, garantindo que falhas não afetem sua cota mensal.
O Zyla API Hub funciona com um sistema de assinatura mensal recorrente. Seu ciclo de cobrança começa no dia em que você compra um dos planos pagos e será renovado no mesmo dia do mês seguinte. Portanto, cancele sua assinatura com antecedência se quiser evitar cobranças futuras.
Para fazer upgrade do seu plano atual, acesse a página de preços da API e selecione o novo plano desejado. O upgrade é instantâneo, permitindo aproveitar imediatamente os recursos do novo plano. Observe que as chamadas restantes do plano anterior não serão transferidas; você será cobrado pelo valor integral do novo plano.
Para verificar quantas chamadas de API restam para o mês atual, consulte o campo 'X-Zyla-API-Calls-Monthly-Remaining' no cabeçalho da resposta. Por exemplo, se seu plano permite 1.000 requisições por mês e você usou 100, este campo no cabeçalho da resposta indicará 900 chamadas restantes.
Para ver o número máximo de requisições de API que seu plano permite, verifique o cabeçalho de resposta 'X-Zyla-RateLimit-Limit'. Por exemplo, se seu plano inclui 1.000 requisições por mês, este cabeçalho exibirá 1.000.
O cabeçalho 'X-Zyla-RateLimit-Reset' mostra o número de segundos até seu limite de taxa ser redefinido. Isso informa quando sua contagem de requisições começará do zero. Por exemplo, se exibir 3.600, significa que restam 3.600 segundos até o limite ser redefinido.
Sim, você pode cancelar seu plano a qualquer momento acessando sua conta e selecionando a opção de cancelamento na página de Cobrança. Observe que upgrades, downgrades e cancelamentos têm efeito imediato. Além disso, após o cancelamento, você não terá mais acesso ao serviço, mesmo que ainda tenha chamadas restantes na sua cota.
Para oferecer a oportunidade de experimentar nossas APIs sem compromisso, oferecemos um teste gratuito de 7 dias que permite realizar até 50 chamadas de API sem custo. Esse teste pode ser usado apenas uma vez; recomendamos aplicá-lo à API que mais interessa. Embora a maioria das APIs ofereça teste gratuito, algumas podem não oferecer. O teste termina após 7 dias ou quando você atingir 50 requisições, o que ocorrer primeiro. Se atingir o limite, será necessário "Iniciar seu plano pago" para continuar. Você encontra esse botão no perfil em Assinatura -> Escolha a API -> aba Preços. Se não cancelar até o 7º dia, sua assinatura será cobrada automaticamente, liberando todas as chamadas do plano.
Após 7 dias, será cobrado o valor total do plano ao qual você estava inscrito durante o teste. Portanto, é importante cancelar antes do término do período. Solicitações de reembolso por esquecimento de cancelamento não são aceitas.
Ao assinar um teste gratuito de API, você pode fazer até 50 chamadas. Se desejar fazer chamadas adicionais além desse limite, a API solicitará que você "Inicie seu plano pago". Você encontra o botão no perfil em Assinatura -> Escolha a API -> aba Preços.
As Ordens de Pagamento são processadas entre os dias 20 e 30 de cada mês. Se você enviar sua solicitação antes do dia 20, seu pagamento será processado dentro desse período.
Você pode nos contatar via chat para receber assistência imediata. Estamos online de 8h às 17h (EST). Se nos contatar após esse horário, retornaremos o mais rápido possível. Além disso, você pode enviar um e-mail para [email protected]

APIs relacionadas