Ir para o conteúdo

Referência das ferramentas

Facebook

Facebook. 8 ferramentas, com seus parâmetros e exemplos de chamada.

Ferramentas do agente Facebook: anúncios do Marketplace e grupos públicos, lidos ao vivo.

Cada chamada é uma requisição POST com a chave em Authorization: Bearer. O corpo JSON é a entrada da ferramenta, e a resposta tem o formato { "tool": "nom", "output": … }. Os exemplos trazem apenas os parâmetros obrigatórios. As descrições dos parâmetros são as que os agentes leem.

findMarketplaceLocation#

Converte o nome de uma cidade ou região em coordenadas do Marketplace.

POSThttps://piqline.com/api/v1/tools/findMarketplaceLocation

Tipo: Leitura ao vivo. Scopes: explore.

ParâmetroTipoObrigatórioDescrição
querystringSimCity or area name, e.g. 'Lyon' or 'Austin, Texas'
curl -s https://piqline.com/api/v1/tools/findMarketplaceLocation \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"levée de fonds"}'

searchMarketplace#

Pesquisa anúncios públicos do Marketplace por palavra-chave em torno de um local (cidade ou coordenadas), em no máximo 3 páginas.

POSThttps://piqline.com/api/v1/tools/searchMarketplace

Tipo: Leitura ao vivo. Scopes: explore.

ParâmetroTipoObrigatórioDescrição
querystringSimSearch keyword(s)
locationstringNãoCity or area name; ignored when lat and lng are both given
latnumberNão
lngnumberNão
radiusKmintegerNão
minPricenumberNão
maxPricenumberNão
countintegerNão
pagesintegerNãoPages to chain in one call (1 credit each); dedupes listings
sortBysuggested | creation_time_descend | distance_ascend | price_ascend | price_descendNão
deliveryall | local_pickup | shippingNão
conditionnew | used_like_new | used_good | used_fairNão
dateListedall | last_24_hours | last_7_days | last_30_daysNão
availabilityavailable | sold | allNão
categoryIdstringNãoNumeric Marketplace category id, as returned in listings
excludearray<string>NãoDrop listings whose title contains any of these words (e.g. 'pièces', 'cadre seul')
includearray<string>NãoKeep only listings whose title contains at least one of these words
cursorstringNãoOpaque cursor from a previous page
curl -s https://piqline.com/api/v1/tools/searchMarketplace \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"levée de fonds"}'

getMarketplaceListing#

Detalhe de um anúncio: descrição, atributos, fotos, entrega, data exata quando o Facebook a fornece.

POSThttps://piqline.com/api/v1/tools/getMarketplaceListing

Tipo: Leitura ao vivo. Scopes: explore.

ParâmetroTipoObrigatórioDescrição
listingstringSimListing id or Marketplace item URL
curl -s https://piqline.com/api/v1/tools/getMarketplaceListing \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"listing":"texte"}'

getMarketplaceListings#

Detalhe de 2 a 6 anúncios de uma vez, em uma tabela comparativa.

POSThttps://piqline.com/api/v1/tools/getMarketplaceListings

Tipo: Leitura ao vivo. Scopes: explore.

ParâmetroTipoObrigatórioDescrição
listingsarray<string>SimListing ids or Marketplace item URLs
curl -s https://piqline.com/api/v1/tools/getMarketplaceListings \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"listings":["texte"]}'

getFacebookGroup#

Perfil público de um grupo: privacidade, tamanho, atividade, categorias, regras.

POSThttps://piqline.com/api/v1/tools/getFacebookGroup

Tipo: Leitura ao vivo. Scopes: explore.

ParâmetroTipoObrigatórioDescrição
groupstringSimGroup URL, numeric id, or vanity slug
curl -s https://piqline.com/api/v1/tools/getFacebookGroup \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"group":"texte"}'

getFacebookGroupPosts#

Posts de um grupo público, em páginas de 3 (6 páginas no máximo).

POSThttps://piqline.com/api/v1/tools/getFacebookGroupPosts

Tipo: Leitura ao vivo. Scopes: explore.

ParâmetroTipoObrigatórioDescrição
groupstringSimGroup URL, numeric id, or vanity slug
sortByCHRONOLOGICAL | CHRONOLOGICAL_LISTINGS | TOP_POSTS | RECENT_ACTIVITYNão
pagesintegerNão
keywordsarray<string>NãoKeep only posts containing at least one of these terms
sincestringNãoISO date; posts older than this are dropped and chronological paging stops there
cursorstringNão
curl -s https://piqline.com/api/v1/tools/getFacebookGroupPosts \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"group":"texte"}'

getFacebookPost#

Detalhe de um post público ou reel: texto, autor, data, reações, visualizações.

POSThttps://piqline.com/api/v1/tools/getFacebookPost

Tipo: Leitura ao vivo. Scopes: explore.

ParâmetroTipoObrigatórioDescrição
poststringSimPost or reel URL
curl -s https://piqline.com/api/v1/tools/getFacebookPost \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"post":"texte"}'

getFacebookPostComments#

Comentários de um post público, filtráveis por palavras-chave (3 páginas no máximo).

POSThttps://piqline.com/api/v1/tools/getFacebookPostComments

Tipo: Leitura ao vivo. Scopes: explore.

ParâmetroTipoObrigatórioDescrição
poststringSimPost or reel URL
pagesintegerNão
keywordsarray<string>Não
cursorstringNão
curl -s https://piqline.com/api/v1/tools/getFacebookPostComments \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"post":"texte"}'

Uma dúvida sobre a API, ou um erro nesta página? Escreva para nós.