API para Facebook: Marketplace

POST/v1/run/facebook.marketplace

Disponibilidade

100,00%

30d · 88 chamadas

Requisições

30d · semanal, últimas 12 sem.

Resposta

1,9s

mediana · 30d

Rede de provedores

Provedores ordenados por tráfego

ProvedoresParcela das chamadas

GiraffeTentado primeiro85 atendidas96,59% de disponibilidade1710ms p5096,6%96,6%96,59% (88 chamadas)1710ms (85 chamadas)85US$ 1,20/mil req.preço fixo

Fox3 atendidas100,00% de disponibilidade11129ms p503,4%3,4%100,00% (3 chamadas)11129ms (3 chamadas)3US$ 3,60/mil req.preço fixo

Teste

Faça sua primeira requisição

lat*stringLatitude da localização da busca (ex.: '30.2677').lng*stringLongitude da localização da busca (ex.: '-97.7475').query*stringPalavra-chave de busca para anúncios do Marketplace (ex.: 'bike').availabilityenumFiltra por disponibilidade: available (padrão), sold ou all (ex.: sold).conditionenumRetorna apenas anúncios nesta condição (ex.: used_good).cursorstringCursor de paginação de uma resposta anterior para buscar a próxima página.dateListedenumRetorna apenas anúncios publicados dentro desta janela (ex.: last_7_days).deliveryMethodenumRetorna apenas anúncios que oferecem este método de entrega (ex.: shipping).priceMaxinteger 0-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 0-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.sortenumOrdenação dos anúncios retornados (ex.: price_ascend).

Abrir emPrompt copiado

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.

{
  "data": {
    "hasNextPage": true,
    "listings": [
      {
        "categoryId": "general",
        "city": "San Francisco",
        "cityPageId": "San Francisco",
        "createdUtc": 12.5,
        "deliveryTypes": [
          "general"
        ],
        "id": "a1b2c3d4",
        "isHidden": false,
        "isLive": true,
        "isPending": true,
        "isSold": true,
        "listingDateText": "A short example description of this item.",
        "locationName": "Example title",
        "photoId": "https://example.com/image.jpg",
        "photoUrl": "https://example.com/image.jpg",
        "priceAmount": 19.99,
        "priceFormatted": "19.99",
        "state": "CA",
        "title": "Example title",
        "url": "https://example.com/page"
      }
    ],
    "nextCursor": "example"
  },
  "found": true,
  "reason": "not_found"
}

Interface da resposta

interface FacebookMarketplaceResponse {
  data: {
    hasNextPage: boolean;
    listings: {
      categoryId?: string;
      city?: string;
      cityPageId?: string;
      createdUtc?: number | null;
      deliveryTypes?: string[];
      id: string;
      isHidden?: boolean;
      isLive?: boolean;
      isPending?: boolean;
      isSold: boolean;
      listingDateText?: string;
      locationName: string;
      photoId?: string;
      photoUrl: string;
      priceAmount: number;
      priceFormatted: string;
      state?: string;
      title: string;
      url: string;
    }[];
    nextCursor: string | null;
  } | null;
  found: boolean;
  reason?: "not_found";
}

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

Referência

Requisição, resposta e preço

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

POST /v1/run/facebook.marketplace

curl -X POST https://api.getanyapi.com/v1/run/facebook.marketplace \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lat":"30.2677","lng":"-97.7475","priceMax":500,"priceMin":100,"query":"bike"}'

Campo	Tipo	Valor de exemplo
Corpo da requisição
lat	string	"30.2677"Latitude da localização da busca (ex.: '30.2677').
lng	string	"-97.7475"Longitude da localização da busca (ex.: '-97.7475').
query	string	"bike"Palavra-chave de busca para anúncios do Marketplace (ex.: 'bike').
availability	enum	Filtra por disponibilidade: available (padrão), sold ou all (ex.: sold).
condition	enum	Retorna apenas anúncios nesta condição (ex.: used_good).
cursor	string	Cursor de paginação de uma resposta anterior para buscar a próxima página.
dateListed	enum	Retorna apenas anúncios publicados dentro desta janela (ex.: last_7_days).
deliveryMethod	enum	Retorna apenas anúncios que oferecem este método de entrega (ex.: shipping).
priceMax	integer	500Preç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.
priceMin	integer	100Preç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.
sort	enum	Ordenação dos anúncios retornados (ex.: price_ascend).
Resposta
data	object
data.hasNextPage	boolean
data.listings	object[]
data.listings[].categoryId	string	Numeric Facebook Marketplace category id, as a string.
data.listings[].city	string	City the listing is located in.
data.listings[].cityPageId	string	Numeric Facebook id of the city page, as a string.
data.listings[].createdUtc	number	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.
data.listings[].deliveryTypes	string[]	Delivery options the seller offers, e.g. "IN_PERSON" or "SHIPPING".
data.listings[].id	string	Populated whenever the provider has data for the entity.
data.listings[].isHidden	boolean	Whether the listing is hidden.
data.listings[].isLive	boolean	Whether the listing is currently live.
data.listings[].isPending	boolean	Whether the listing is marked pending.
data.listings[].isSold	boolean
data.listings[].listingDateText	string	Human-readable listing age Facebook shows, e.g. "Listed 2 weeks ago".
data.listings[].locationName	string	Populated whenever the provider has data for the entity.
data.listings[].photoId	string	Numeric Facebook id of the listing's primary photo, as a string.
data.listings[].photoUrl	string	Populated whenever the provider has data for the entity.
data.listings[].priceAmount	number	Populated whenever the provider has data for the entity.
data.listings[].priceFormatted	string	Populated whenever the provider has data for the entity.
data.listings[].state	string	State or region the listing is located in.
data.listings[].title	string	Populated whenever the provider has data for the entity.
data.listings[].url	string	Populated whenever the provider has data for the entity.
data.nextCursor	string	Opaque cursor for the next page of listings, or null when this lane has no more. Pass it back as cursor to continue.
found	boolean
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.
Preço
Preço por requisição	USD	US$ 0,0012
Preço /mil req.	USD	US$ 1,20

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 1,9 segundos, em 88 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 1,9 segundos, em 88 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.

Mais para chamar

Outros endpoints de Facebook

Uma chave, uma carteira e
sua primeira chamada de Facebook.

Ganhe ~150 requisições grátis

API para Facebook: Marketplace

Provedores ordenados por tráfego

Faça sua primeira requisição

Requisição, resposta e preço

Sobre o endpoint Marketplace da API para Facebook

Quanto custa o endpoint Marketplace da API para Facebook?

O que o endpoint Marketplace da API para Facebook retorna?

Quão confiável é o endpoint Marketplace da API para Facebook?

Outros endpoints de Facebook

Uma chave, uma carteira esua primeira chamada de Facebook.

Uma chave, uma carteira e
sua primeira chamada de Facebook.