API para Facebook

API para Facebook: Marketplace

Busque anúncios do Facebook Marketplace por palavra-chave perto de uma localização, filtre por preço, condição, entrega, recência e disponibilidade, e receba título, preço, localização e imagem em JSON normalizado.

Comece grátisBaixar amostraou JSON

US$ 1,20/mil req., pague por requisição, sem assinatura.

fMarketplace | Facebook
facebook.com/marketplace

Results for "bike"

PriceLocationCategory

$285

Trek FX 2 Hybrid Bike - Size Medium

Austin, TX

O que a API retornoulistings[0]
{
"id": "1029384756102938",
"url": "https://www.facebook.com/marketplace/item/1029384756102938/",
"title": "Trek FX 2 Hybrid Bike - Size Medium",
"priceFormatted": "$285",
"priceAmount": 285,
"locationName": "Austin, TX",
"photoUrl": "https://scontent.xx.fbcdn.net/v/t45.5328-4/marketplace_1029384756102938.jpg",
"isSold": false,
... 11 campos a mais
}
Disponibilidade
100,00%
30d · 10.471 chamadas
Requisições
10.477
30d · semanal, últimas 12 sem.
Resposta
2,1s
mediana · 30d

Preços e provedores

Preços do endpoint Marketplace da API para Facebook: uma API, 2 provedores intercambiáveis

O provedor mais barato atende primeiro. Se ele falhar, o próximo assume na mesma chamada.

Você paga
US$ 12,00
US$ 1,20/mil req., só pelo que você usar. Sem plano mensal.
Suas primeiras 83 requisições são grátis com o saldo inicial de US$ 0,10.

Teste

Obtenha Marketplace do Facebook em uma só requisição

Abrir em
Obter chave grátis
Resposta de exemplo
Execuções grátis retornam só os primeiros 3 resultados. Recarregue uma chave para receber a resposta completa.

Este exemplo mostra 24 de 25 campos. Ver todos os campos

{
  "found": true,
  "data": {
    "nextCursor": "AbYq2_marketplace_cursor_04",
    "hasNextPage": true,
    "listings": [
      {
        "id": "1029384756102938",
        "url": "https://www.facebook.com/marketplace/item/1029384756102938/",
        "title": "Trek FX 2 Hybrid Bike - Size Medium",
        "priceFormatted": "$285",
        "priceAmount": 285,
        "locationName": "Austin, TX",
        "photoUrl": "https://scontent.xx.fbcdn.net/v/t45.5328-4/marketplace_1029384756102938.jpg",
        "isSold": false,
        "createdUtc": 1790884800,
        "listingDateText": "Listed 4 days ago",
        "city": "Austin",
        "state": "Texas",
        "cityPageId": "110683425619321",
        "photoId": "5920184736501928",
        "categoryId": "1020384756192837",
        "deliveryTypes": [
          "IN_PERSON",
          "SHIPPING"
        ],
        "isLive": true,
        "isPending": false,
        "isHidden": false
      },
      {
        "id": "2938475610293847",
        "url": "https://www.facebook.com/marketplace/item/2938475610293847/",
        "title": "Kids 20 inch BMX Bike - Barely Used",
        "priceFormatted": "$120",
        "priceAmount": 120,
        "locationName": "Round Rock, TX",
        "photoUrl": "https://scontent.xx.fbcdn.net/v/t45.5328-4/marketplace_2938475610293847.jpg",
        "isSold": false,
        "createdUtc": 1791057600,
        "listingDateText": "Listed 2 days ago",
        "city": "Round Rock",
        "state": "Texas",
        "cityPageId": "129384756019283",
        "photoId": "6019283746501928",
        "categoryId": "1020384756192837",
        "deliveryTypes": [
          "IN_PERSON"
        ],
        "isLive": true,
        "isPending": false,
        "isHidden": false
      }
    ]
  }
}

Referência completa de parâmetros e resposta - todos os campos, tipos e exemplos deste endpoint.

Referência

Uma requisição, um formato de resposta.

Cada campo que você envia e cada campo que você recebe, cada um com um exemplo real.

Última verificação em 2026-11-14 · disponibilidade e latência medidas em 30d

Corpo da requisição

JSON, enviado via POST para este endpoint.

  • latstring

    30.2677

    Latitude da localização da busca (ex.: '30.2677').

  • lngstring

    -97.7475

    Longitude da localização da busca (ex.: '-97.7475').

  • querystring

    bike

    Palavra-chave de busca para anúncios do Marketplace (ex.: 'bike').

  • availabilityenum

    Filtra por disponibilidade: available (padrão), sold ou all (ex.: sold).

  • conditionenum

    Retorna apenas anúncios nesta condição (ex.: used_good).

  • cursorstring

    Cursor de paginação de uma resposta anterior para buscar a próxima página.

  • dateListedenum

    Retorna apenas anúncios publicados dentro desta janela (ex.: last_7_days).

  • deliveryMethodenum

    Retorna apenas anúncios que oferecem este método de entrega (ex.: shipping).

  • priceMaxinteger

    500

    Preço máximo do anúncio em unidades inteiras da moeda, ex.: 500 para $500. O Facebook pode misturar alguns anúncios sugeridos fora da faixa.

  • priceMininteger

    100

    Preço mínimo do anúncio em unidades inteiras da moeda, ex.: 100 para $100. O Facebook pode misturar alguns anúncios sugeridos fora da faixa.

  • sortenum

    Ordenação dos anúncios retornados (ex.: price_ascend).

Você envia. Um corpo JSON pequeno. Os valores mostrados são exemplos para você trocar pelos seus.

Resposta

JSON, um valor de exemplo por campo.

datadata
  • hasNextPageboolean

    true

  • nextCursorstring

    AbYq2_marketplace_cursor_04

    Opaque cursor for the next page of listings, or null when this lane has no more. Pass it back as cursor to continue.

each listingdata.listings[]
  • categoryIdstring

    1020384756192837

    Numeric Facebook Marketplace category id, as a string.

  • citystring

    Austin

    City the listing is located in.

  • cityPageIdstring

    110683425619321

    Numeric Facebook id of the city page, as a string.

  • createdUtcnumber

    1790884800

    UTC epoch timestamp in seconds (Unix time) the listing was created. Multiply by 1000 for a JS Date in milliseconds. Null when the source does not report it.

  • deliveryTypesstring[]

    Delivery options the seller offers, e.g. "IN_PERSON" or "SHIPPING".

  • idstring

    1029384756102938

    Populated whenever the provider has data for the entity.

  • isHiddenboolean

    false

    Whether the listing is hidden.

  • isLiveboolean

    true

    Whether the listing is currently live.

  • isPendingboolean

    false

    Whether the listing is marked pending.

  • isSoldboolean

    false

  • listingDateTextstring

    Listed 4 days ago

    Human-readable listing age Facebook shows, e.g. "Listed 2 weeks ago".

  • locationNamestring

    Austin, TX

    Populated whenever the provider has data for the entity.

  • photoIdstring

    5920184736501928

    Numeric Facebook id of the listing's primary photo, as a string.

  • photoUrlstring

    https://scontent.xx.fbcdn.net/v/t45.5328-4/marketplace_1029384756102938.jpg

    Populated whenever the provider has data for the entity.

  • priceAmountnumber

    285

    Populated whenever the provider has data for the entity.

  • priceFormattedstring

    $285

    Populated whenever the provider has data for the entity.

  • statestring

    Texas

    State or region the listing is located in.

  • titlestring

    Trek FX 2 Hybrid Bike - Size Medium

    Populated whenever the provider has data for the entity.

  • urlstring

    https://www.facebook.com/marketplace/item/1029384756102938/

    Populated whenever the provider has data for the entity.

top level
  • foundboolean

    true

  • reason"not_found"

    Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.

Você recebe. Campos nomeados e tipados, no mesmo formato, seja qual for a fonte que responder.

Dúvidas frequentes

Sobre o endpoint Marketplace da API para Facebook

O endpoint Marketplace da AnyAPI para Facebook retorna dados de Facebook em JSON normalizado com uma chamada POST para /v1/run/facebook.marketplace. Busque anúncios do Facebook Marketplace por palavra-chave perto de uma localização, filtre por preço, condição, entrega, recência e disponibilidade, e receba título, preço, localização e imagem em JSON normalizado. A AnyAPI distribui cada requisição entre 2 fontes, com failover automático quando uma falha. Custa a partir de US$ 1,20 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 100,0% das chamadas ao endpoint Marketplace da API para Facebook feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 2,1 segundos, em 10.471 chamadas medidas.

Custa a partir de US$ 1,20 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Você recarrega uma carteira em dólares e cada chamada desconta dela. Algumas requisições pagas pela carteira que falham geram cobranças de processamento, que repassamos pelo custo, sem margem; a resposta de erro mostra o valor cobrado.

Busque anúncios do Facebook Marketplace por palavra-chave perto de uma localização, filtre por preço, condição, entrega, recência e disponibilidade, e receba título, preço, localização e imagem em JSON normalizado. A resposta é JSON normalizado, com o mesmo envelope que todo endpoint da AnyAPI retorna, então processar um segundo endpoint é só trocar a URL, e nada mais.

Nos últimos 30 dias, 100,0% das chamadas ao endpoint Marketplace da API para Facebook feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 2,1 segundos, em 10.471 chamadas medidas. Estas são medições da própria AnyAPI sobre o tráfego que passa pelo gateway, recalculadas continuamente, e não uma meta de nível de serviço publicada.

Sim. Uma conta nova da AnyAPI começa com US$ 0,10 de saldo grátis, sem cartão, o que cobre 83 chamadas de Marketplace do Facebook a US$ 0,0012 cada.

A AnyAPI consulta a próxima das suas 2 fontes na mesma requisição, começando pela mais barata, então a queda de uma fonte não derruba sua chamada.

Envie uma requisição POST para https://api.getanyapi.com/v1/run/facebook.marketplace com sua chave da AnyAPI em um cabeçalho "Authorization: Bearer" e a entrada como corpo JSON. A mesma chave e a mesma carteira funcionam em todos os endpoints da AnyAPI.

Não. Você adiciona dólares a um único saldo pré-pago da AnyAPI e cada requisição desconta dele. Não há plano mensal nem mínimo, e o mesmo saldo paga todos os endpoints da AnyAPI.

Sim. Instale @getanyapi/sdk pelo npm para TypeScript ou getanyapi pelo pip para Python. Os dois chamam todos os endpoints da AnyAPI com a mesma chave, e qualquer cliente HTTP também funciona.

Sim. Um agente pode se conectar ao servidor MCP da AnyAPI em https://api.getanyapi.com/mcp, ou criar a própria chave de teste grátis com um único POST sem autenticação para https://api.getanyapi.com/agent/signup e chamar este endpoint por HTTP.
Mais para chamar

Outros endpoints de Facebook

Perfila partir de US$ 1,20 /mil req.Posts do perfila partir de US$ 1,20 /mil req.Posta partir de US$ 1,20 /mil req.Comentários do posta partir de US$ 1,20 /mil req.Reels do perfila partir de US$ 1,20 /mil req.Detalhes do anúncioa partir de US$ 1,20 /mil req.Detalhes do anúncio (versão completa)a partir de US$ 3,74 /mil req.Transcrição do anúncioa partir de US$ 1,20 /mil req.Busca de anúnciosa partir de US$ 1,10 /mil req.Respostas a comentáriosa partir de US$ 1,20 /mil req.Anúncios da empresaa partir de US$ 1,10 /mil req.Detalhes do eventoa partir de US$ 1,20 /mil req.Eventosa partir de US$ 1,20 /mil req.Busca de eventosa partir de US$ 1,20 /mil req.Seguidoresa partir de US$ 3,15 /mil resultadosPosts do grupoa partir de US$ 1,20 /mil req.Item do Marketplacea partir de US$ 1,20 /mil req.Busca de localização no Marketplacea partir de US$ 1,20 /mil req.Contato da páginaa partir de US$ 1,20 /mil req.Consultar páginaa partir de US$ 9,75 /mil req.Fotosa partir de US$ 1,20 /mil req.Transcrição do posta partir de US$ 1,20 /mil req.Eventos do perfila partir de US$ 1,20 /mil req.Buscar empresasa partir de US$ 1,10 /mil req.Buscar páginasa partir de US$ 9,18 /mil resultadosBuscar postsa partir de US$ 30,00 /mil req.