API Facebook

Facebook Recherche de pages API

Cherchez des pages Facebook par mot-clé, éventuellement restreintes à un lieu, et obtenez des profils de pages structurés (nom, catégorie, abonnés, coordonnées).

10,00 $US/1k résultats, paiement à la requête, sans abonnement.

fcoffee roasters | Facebook Search
facebook.com/search/pages?q=coffee%20roasters

Pages

Kreuzberg Coffee Roasters

Coffee Shop

18.4K followers

Ce que l’API a renvoyéitems[0]
{
"id": "108827441652390",
"title": "Kreuzberg Coffee Roasters",
"url": "https://www.facebook.com/kreuzbergcoffeeroasters",
"category": "Coffee Shop",
"followers": 18400,
"likes": 17900,
"phone": "+49 30 5550 1873",
"website": "https://kreuzbergroasters.de",
... 9 champs de plus
}
Disponibilité
82,11%
30d · 1 794 appels
Requêtes
1 795
30 j · par semaine, 12 dernières sem.
Réponse
45,6s
médiane · 30d

L’appeler

Obtenez Facebook Recherche de pages en une requête

import os, requests

res = requests.post(
    "https://api.getanyapi.com/v1/run/facebook.search_pages",
    headers={"Authorization": f"Bearer {os.environ['ANYAPI_KEY']}"},
    json={
        "query": "nike",
        "limit": 3
    },
)
print(res.json())
Ouvrir dans
Obtenir une clé gratuite
Exemple de réponse

Cet exemple affiche 19 champs sur 21. Voir tous les champs

{
  "found": true,
  "data": {
    "items": [
      {
        "id": "108827441652390",
        "title": "Kreuzberg Coffee Roasters",
        "url": "https://www.facebook.com/kreuzbergcoffeeroasters",
        "category": "Coffee Shop",
        "followers": 18400,
        "likes": 17900,
        "phone": "+49 30 5550 1873",
        "website": "https://kreuzbergroasters.de",
        "image": "https://scontent.xx.fbcdn.net/v/t39.30808-1/kreuzberg_avatar.jpg",
        "pageAlias": "kreuzbergcoffeeroasters",
        "about": "Small-batch coffee roasted daily in Kreuzberg since 2014. Wholesale and cafe pickup.",
        "coverPhotoUrl": "https://scontent.xx.fbcdn.net/v/t39.30808-1/kreuzberg_cover.jpg",
        "createdUtc": 1391212800,
        "adStatus": "This Page is not currently running ads.",
        "owner": "",
        "categories": [
          "Coffee Shop",
          "Coffee Roastery"
        ]
      },
      {
        "id": "241093887761204",
        "title": "Nordlicht Rostkaffee",
        "url": "https://www.facebook.com/nordlichtrostkaffee",
        "category": "Coffee Roastery",
        "followers": 6250,
        "likes": 6010,
        "phone": "+49 30 5550 2946",
        "website": "https://nordlicht-kaffee.de",
        "image": "https://scontent.xx.fbcdn.net/v/t39.30808-1/nordlicht_avatar.jpg",
        "pageAlias": "nordlichtrostkaffee",
        "about": "Direct-trade single-origin roaster based in Prenzlauer Berg.",
        "coverPhotoUrl": "https://scontent.xx.fbcdn.net/v/t39.30808-1/nordlicht_cover.jpg",
        "createdUtc": 1476403200,
        "adStatus": "This Page is currently running ads.",
        "owner": "",
        "categories": [
          "Coffee Roastery"
        ]
      },
      {
        "id": "365710428839112",
        "title": "Spandau Bean Co.",
        "url": "https://www.facebook.com/spandaubeanco",
        "category": "Coffee Shop",
        "followers": 2870,
        "likes": 2790,
        "phone": "",
        "website": "https://spandaubean.co",
        "image": "https://scontent.xx.fbcdn.net/v/t39.30808-1/spandau_avatar.jpg",
        "pageAlias": "spandaubeanco",
        "about": "Neighborhood roastery and cafe on Wilhelmstrasse.",
        "coverPhotoUrl": "https://scontent.xx.fbcdn.net/v/t39.30808-1/spandau_cover.jpg",
        "createdUtc": 1552608000,
        "adStatus": "This Page is not currently running ads.",
        "owner": "",
        "categories": [
          "Coffee Shop"
        ]
      }
    ]
  }
}

Référence complète des paramètres et de la réponse : chaque champ, type et exemple de cet endpoint.

Référence

Une requête, une seule forme de réponse.

Chaque champ que vous envoyez et chaque champ que vous recevez, avec un vrai exemple.

Dernière vérification : 2026-11-21 · disponibilité et latence mesurées sur 30d

Corps de la requête

JSON, envoyé à cet endpoint.

  • querystring

    coffee roasters

    Mot-clé pour chercher des pages Facebook (p. ex. 'coffee roasters').

  • limitinteger

    3

    Nombre maximal de résultats à renvoyer (1-10, 10 par défaut). Vous êtes facturé par résultat renvoyé, donc une limite plus basse coûte moins.

  • locationstring

    Berlin

    Lieu libre facultatif pour affiner la recherche : une ville, une province ou un pays (p. ex. 'Berlin').

Vous envoyez. Un petit corps JSON. Les valeurs affichées sont des exemples à remplacer par les vôtres.

Réponse

JSON, une valeur d’exemple par champ.

each itemdata.items[]

Matching Facebook Page records for the query. Populated whenever the provider has data for the entity.

  • aboutstring

    Small-batch coffee roasted daily in Kreuzberg since 2014. Wholesale and cafe pickup.

    The page's intro text.

  • adLibraryPageIdstring

    The page's Facebook Ad Library id, the `pageId` facebook.company_ads takes. It differs from `id`. Absent when Facebook shows none.

  • adStatusstring

    This Page is not currently running ads.

    Facebook Ad Library status sentence for the page, e.g. whether it is currently running ads.

  • categoriesstring[]

    Categories Facebook lists the page under.

  • categorystring

    Coffee Shop

    The page's primary category (e.g. "Sportswear Store"). Empty when the upstream omits it.

  • coverPhotoUrlstring

    https://scontent.xx.fbcdn.net/v/t39.30808-1/kreuzberg_cover.jpg

    Cover photo image URL of the page.

  • createdUtcnumber

    1391212800

    UTC epoch timestamp in seconds (Unix time) the page was created. Multiply by 1000 for a JS Date in milliseconds.

  • followersinteger

    18400

    The page's follower count.

  • idstring

    108827441652390

    The page's numeric Facebook ID, as a string. Populated whenever the provider has data for the entity.

  • imagestring

    https://scontent.xx.fbcdn.net/v/t39.30808-1/kreuzberg_avatar.jpg

    URL of the page's profile picture, a signed CDN URL whose query must be kept. Empty when the upstream omits it.

  • likesinteger

    17900

    The page's like count.

  • ownerstring

    Confirmed owner of the page, when Facebook publishes one.

  • pageAliasstring

    kreuzbergcoffeeroasters

    The page's vanity URL alias, e.g. "nikesportswear".

  • phonestring

    +49 30 5550 1873

    The page's public phone number. Empty when the upstream omits it.

  • titlestring

    Kreuzberg Coffee Roasters

    The page's public name. Populated whenever the provider has data for the entity.

  • urlstring

    https://www.facebook.com/kreuzbergcoffeeroasters

    Canonical URL of the Facebook Page, with tracking query params stripped. Populated whenever the provider has data for the entity.

  • websitestring

    https://kreuzbergroasters.de

    The page's public website URL. Empty when the upstream omits it.

top level
  • foundboolean

    true

    Whether any matching pages were returned for the query.

  • 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.

Vous recevez. Des champs nommés et typés, dans la même forme quelle que soit la source qui répond.

FAQ

À propos de l’API Facebook Recherche de pages

L’API Facebook Recherche de pages d’AnyAPI renvoie des données Facebook en JSON normalisé à partir d’un appel POST à /v1/run/facebook.search_pages. Cherchez des pages Facebook par mot-clé, éventuellement restreintes à un lieu, et obtenez des profils de pages structurés (nom, catégorie, abonnés, coordonnées). AnyAPI renvoie un schéma normalisé unique quelle que soit la source qui répond. Elle coûte 10 $US pour 1 000 résultats, et jamais plus de 0,11 $US pour une seule requête, en dollars US, sans abonnement et sans minimum mensuel. Ces 30 derniers jours, 82,1% des appels Facebook Recherche de pages passés par AnyAPI ont réussi, avec un temps de réponse médian de 45,6 secondes, sur 1 794 appels mesurés.

Elle coûte 10 $US pour 1 000 résultats, et jamais plus de 0,11 $US pour une seule requête, en dollars US, sans abonnement et sans minimum mensuel. Vous alimentez un portefeuille en USD et chaque appel le débite. Certaines requêtes échouées financées par le portefeuille entraînent des frais de traitement que nous répercutons au prix coûtant, sans marge ; la réponse d’erreur indique le montant facturé.

Cherchez des pages Facebook par mot-clé, éventuellement restreintes à un lieu, et obtenez des profils de pages structurés (nom, catégorie, abonnés, coordonnées). La réponse est du JSON normalisé avec la même enveloppe que celle de tous les endpoints AnyAPI, donc analyser un second endpoint revient à changer l’URL et rien d’autre.

Ces 30 derniers jours, 82,1% des appels Facebook Recherche de pages passés par AnyAPI ont réussi, avec un temps de réponse médian de 45,6 secondes, sur 1 794 appels mesurés. Ce sont les propres mesures d’AnyAPI du trafic passant par la passerelle, recalculées en continu, et non un objectif de niveau de service publié.

Oui. Un nouveau compte AnyAPI démarre avec 0,10 $US de solde gratuit, sans carte.

Envoyez une requête POST à https://api.getanyapi.com/v1/run/facebook.search_pages avec votre clé AnyAPI dans un en-tête « Authorization: Bearer » et l’entrée en corps JSON. La même clé et le même portefeuille fonctionnent sur tous les endpoints AnyAPI.

Non. Vous ajoutez des dollars US à un solde AnyAPI prépayé unique et chaque requête le débite. Il n’y a ni forfait mensuel ni minimum, et le même solde paie tous les endpoints AnyAPI.

Oui. Installez @getanyapi/sdk depuis npm pour TypeScript ou getanyapi depuis pip pour Python. Les deux appellent chaque endpoint AnyAPI avec la même clé, et n’importe quel client HTTP fonctionne aussi.

Oui. Un agent peut se connecter au serveur MCP d’AnyAPI à https://api.getanyapi.com/mcp, ou créer sa propre clé d’essai gratuit avec un seul POST non authentifié vers https://api.getanyapi.com/agent/signup et appeler cet endpoint en HTTP.