Saltar al contenido

Referencia de herramientas

Facebook

Facebook. 8 herramientas, con sus parámetros y ejemplos de llamada.

Herramientas del agente de Facebook: anuncios de Marketplace y grupos públicos, leídos en directo.

Cada llamada es una petición POST con la clave en Authorization: Bearer. El cuerpo JSON es la entrada de la herramienta, y la respuesta tiene la forma { "tool": "nom", "output": … }. Los ejemplos solo incluyen los parámetros obligatorios. Las descripciones de los parámetros son las que leen los agentes.

findMarketplaceLocation#

Convierte el nombre de una ciudad o zona en coordenadas de Marketplace.

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

Tipo: Lectura en directo. Scopes: explore.

ParámetroTipoObligatorioDescripción
querystringSíCity 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#

Busca anuncios públicos de Marketplace por palabra clave en torno a un lugar (ciudad o coordenadas), en 3 páginas como máximo.

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

Tipo: Lectura en directo. Scopes: explore.

ParámetroTipoObligatorioDescripción
querystringSíSearch keyword(s)
locationstringNoCity or area name; ignored when lat and lng are both given
latnumberNo
lngnumberNo
radiusKmintegerNo
minPricenumberNo
maxPricenumberNo
countintegerNo
pagesintegerNoPages to chain in one call (1 credit each); dedupes listings
sortBysuggested | creation_time_descend | distance_ascend | price_ascend | price_descendNo
deliveryall | local_pickup | shippingNo
conditionnew | used_like_new | used_good | used_fairNo
dateListedall | last_24_hours | last_7_days | last_30_daysNo
availabilityavailable | sold | allNo
categoryIdstringNoNumeric Marketplace category id, as returned in listings
excludearray<string>NoDrop listings whose title contains any of these words (e.g. 'pièces', 'cadre seul')
includearray<string>NoKeep only listings whose title contains at least one of these words
cursorstringNoOpaque 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#

Detalle de un anuncio: descripción, atributos, fotos, envío, fecha exacta cuando Facebook la proporciona.

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

Tipo: Lectura en directo. Scopes: explore.

ParámetroTipoObligatorioDescripción
listingstringSíListing 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#

Detalle de 2 a 6 anuncios a la vez, como tabla comparativa.

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

Tipo: Lectura en directo. Scopes: explore.

ParámetroTipoObligatorioDescripción
listingsarray<string>SíListing 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 un grupo: privacidad, tamaño, actividad, categorías, reglas.

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

Tipo: Lectura en directo. Scopes: explore.

ParámetroTipoObligatorioDescripción
groupstringSíGroup 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#

Publicaciones de un grupo público, en páginas de 3 (6 páginas como máximo).

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

Tipo: Lectura en directo. Scopes: explore.

ParámetroTipoObligatorioDescripción
groupstringSíGroup URL, numeric id, or vanity slug
sortByCHRONOLOGICAL | CHRONOLOGICAL_LISTINGS | TOP_POSTS | RECENT_ACTIVITYNo
pagesintegerNo
keywordsarray<string>NoKeep only posts containing at least one of these terms
sincestringNoISO date; posts older than this are dropped and chronological paging stops there
cursorstringNo
curl -s https://piqline.com/api/v1/tools/getFacebookGroupPosts \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"group":"texte"}'

getFacebookPost#

Detalle de una publicación o reel público: texto, autor, fecha, reacciones, visualizaciones.

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

Tipo: Lectura en directo. Scopes: explore.

ParámetroTipoObligatorioDescripción
poststringSíPost 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#

Comentarios de una publicación pública, filtrables por palabras clave (3 páginas como máximo).

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

Tipo: Lectura en directo. Scopes: explore.

ParámetroTipoObligatorioDescripción
poststringSíPost or reel URL
pagesintegerNo
keywordsarray<string>No
cursorstringNo
curl -s https://piqline.com/api/v1/tools/getFacebookPostComments \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"post":"texte"}'

¿Tienes una pregunta sobre la API o has encontrado un error en esta página? Escríbenos.