Zum Inhalt springen

Tool-Referenz

Facebook

Facebook. 8 Tools, mit ihren Parametern und Aufrufbeispielen.

Tools des Facebook-Agenten: Marketplace-Anzeigen und öffentliche Gruppen, live gelesen.

Jeder Aufruf ist eine POST-Anfrage mit dem Schlüssel in Authorization: Bearer. Der JSON-Body ist die Eingabe des Tools, und die Antwort hat die Form { "tool": "nom", "output": … }. Die Beispiele enthalten nur die erforderlichen Parameter. Die Parameterbeschreibungen sind die, die die Agenten lesen.

findMarketplaceLocation#

Wandelt den Namen einer Stadt oder Gegend in Marketplace-Koordinaten um.

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

Typ: Live-Lesen. Scopes: explore.

ParameterTypErforderlichBeschreibung
querystringJaCity 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#

Durchsucht öffentliche Marketplace-Anzeigen nach Stichwort rund um einen Ort (Stadt oder Koordinaten), über höchstens 3 Seiten.

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

Typ: Live-Lesen. Scopes: explore.

ParameterTypErforderlichBeschreibung
querystringJaSearch keyword(s)
locationstringNeinCity or area name; ignored when lat and lng are both given
latnumberNein
lngnumberNein
radiusKmintegerNein
minPricenumberNein
maxPricenumberNein
countintegerNein
pagesintegerNeinPages to chain in one call (1 credit each); dedupes listings
sortBysuggested | creation_time_descend | distance_ascend | price_ascend | price_descendNein
deliveryall | local_pickup | shippingNein
conditionnew | used_like_new | used_good | used_fairNein
dateListedall | last_24_hours | last_7_days | last_30_daysNein
availabilityavailable | sold | allNein
categoryIdstringNeinNumeric Marketplace category id, as returned in listings
excludearray<string>NeinDrop listings whose title contains any of these words (e.g. 'pièces', 'cadre seul')
includearray<string>NeinKeep only listings whose title contains at least one of these words
cursorstringNeinOpaque 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#

Detail einer Anzeige: Beschreibung, Attribute, Fotos, Lieferung, genaues Datum, wenn Facebook es liefert.

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

Typ: Live-Lesen. Scopes: explore.

ParameterTypErforderlichBeschreibung
listingstringJaListing 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#

Detail von 2 bis 6 Anzeigen auf einmal, als Vergleichstabelle.

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

Typ: Live-Lesen. Scopes: explore.

ParameterTypErforderlichBeschreibung
listingsarray<string>JaListing 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#

Öffentliches Profil einer Gruppe: Datenschutz, Größe, Aktivität, Kategorien, Regeln.

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

Typ: Live-Lesen. Scopes: explore.

ParameterTypErforderlichBeschreibung
groupstringJaGroup 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#

Beiträge einer öffentlichen Gruppe, in Seiten zu 3 (höchstens 6 Seiten).

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

Typ: Live-Lesen. Scopes: explore.

ParameterTypErforderlichBeschreibung
groupstringJaGroup URL, numeric id, or vanity slug
sortByCHRONOLOGICAL | CHRONOLOGICAL_LISTINGS | TOP_POSTS | RECENT_ACTIVITYNein
pagesintegerNein
keywordsarray<string>NeinKeep only posts containing at least one of these terms
sincestringNeinISO date; posts older than this are dropped and chronological paging stops there
cursorstringNein
curl -s https://piqline.com/api/v1/tools/getFacebookGroupPosts \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"group":"texte"}'

getFacebookPost#

Detail eines öffentlichen Beitrags oder Reels: Text, Autor, Datum, Reaktionen, Aufrufe.

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

Typ: Live-Lesen. Scopes: explore.

ParameterTypErforderlichBeschreibung
poststringJaPost 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#

Kommentare zu einem öffentlichen Beitrag, filterbar nach Stichwörtern (höchstens 3 Seiten).

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

Typ: Live-Lesen. Scopes: explore.

ParameterTypErforderlichBeschreibung
poststringJaPost or reel URL
pagesintegerNein
keywordsarray<string>Nein
cursorstringNein
curl -s https://piqline.com/api/v1/tools/getFacebookPostComments \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"post":"texte"}'

Eine Frage zur API oder ein Fehler auf dieser Seite? Schreiben Sie uns.