API Facebook

Facebook Recherche de publications API

Cherchez des publications Facebook publiques par mot-clé, éventuellement filtrées par lieu, et obtenez des fiches de publications structurées (texte, auteur, engagement).

16,00 $US/1k req, paiement à la requête, sans abonnement.

fharvest festival | Facebook Search
facebook.com/search/posts?q=harvest%20festival

Riverside Community Market

Sep 26, 2024

Fall Harvest Festival is back this Saturday! Live music, a pumpkin patch, cider pressing and over 40 local vendors. Free entry, 10am to 5pm at Riverside Park.

84296 comments
LikeCommentShare
Ce que l’API a renvoyéitems[0]
{
"id": "743920185640217",
"url": "https://www.facebook.com/riversidecommunitymarket/posts/743920185640217",
"text": "Fall Harvest Festival is back this Saturday! Live music, a pumpkin patch, cider pressing and over 40 local vendors. Free entry, 10am to 5pm at Riverside Park.",
"authorName": "Riverside Community Market",
"authorUrl": "https://www.facebook.com/riversidecommunitymarket",
"reactionCount": 842,
"commentCount": 96,
"shareCount": 213,
... 8 champs de plus
}
Disponibilité
99,28%
30d · 21 836 appels
Requêtes
22 033
30 j · par semaine, 12 dernières sem.
Réponse
19,9s
médiane · 30d

Tarifs et fournisseurs

Tarifs de l’API Facebook Recherche de publications : une API, 3 fournisseurs interchangeables

Le fournisseur le moins cher répond en premier. S’il échoue, le suivant prend le relais dans le même appel.

Vous payez
160,00 $US
16,00 $US/1k req, seulement pour ce que vous utilisez. Aucun forfait mensuel.
Vos 6 premières requêtes sont gratuites avec le solde de départ de 0,10 $US.

Essayer

Obtenez Facebook Recherche de publications en une requête

requireFieldsarray
Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `imagesCount` or `albumPreview`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. A named field can still be absent on a post that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge.
Ouvrir dans
Obtenir une clé gratuite
Exemple de réponse
Les exécutions gratuites ne renvoient que les 3 premiers résultats. Alimentez une clé pour obtenir la réponse complète.

Cet exemple affiche 13 champs sur 31. Voir tous les champs

{
  "found": true,
  "data": {
    "items": [
      {
        "id": "743920185640217",
        "url": "https://www.facebook.com/riversidecommunitymarket/posts/743920185640217",
        "text": "Fall Harvest Festival is back this Saturday! Live music, a pumpkin patch, cider pressing and over 40 local vendors. Free entry, 10am to 5pm at Riverside Park.",
        "authorName": "Riverside Community Market",
        "authorUrl": "https://www.facebook.com/riversidecommunitymarket",
        "reactionCount": 842,
        "commentCount": 96,
        "shareCount": 213,
        "image": "https://scontent.xx.fbcdn.net/v/t39.30808-6/harvest_festival_banner.jpg",
        "createdUtc": 1727366400,
        "type": "post",
        "authorId": "187204093312",
        "authorImage": "https://scontent.xx.fbcdn.net/v/t39.30808-1/riverside_market_avatar.jpg",
        "imagesCount": 3,
        "reactions": {
          "like": 610,
          "love": 178,
          "care": 22,
          "haha": 9,
          "wow": 14,
          "sad": 2,
          "angry": 1
        },
        "albumPreview": [
          {
            "id": "743920182306884",
            "type": "photo",
            "url": "https://www.facebook.com/photo/?fbid=743920182306884",
            "image": "https://scontent.xx.fbcdn.net/v/t39.30808-6/harvest_festival_1.jpg"
          },
          {
            "id": "743920182306901",
            "type": "photo",
            "url": "https://www.facebook.com/photo/?fbid=743920182306901",
            "image": "https://scontent.xx.fbcdn.net/v/t39.30808-6/harvest_festival_2.jpg"
          }
        ]
      },
      {
        "id": "601487723190845",
        "url": "https://www.facebook.com/oldtownfarmers/posts/601487723190845",
        "text": "Harvest Festival vendor lineup is confirmed. Come say hi to us at booth 12!",
        "authorName": "Old Town Farmers Collective",
        "authorUrl": "https://www.facebook.com/oldtownfarmers",
        "reactionCount": 214,
        "commentCount": 18,
        "shareCount": 31,
        "image": "",
        "createdUtc": 1726934400,
        "type": "post",
        "authorId": "220981473052",
        "authorImage": "https://scontent.xx.fbcdn.net/v/t39.30808-1/oldtown_farmers_avatar.jpg",
        "imagesCount": 0,
        "reactions": {
          "like": 180,
          "love": 24,
          "care": 4,
          "haha": 3,
          "wow": 2,
          "sad": 0,
          "angry": 1
        },
        "albumPreview": []
      },
      {
        "id": "918204573110982",
        "url": "https://www.facebook.com/mapleridgeschool/posts/918204573110982",
        "text": "Our 3rd grade class made scarecrows for the Harvest Festival parade this weekend. So proud of this crew!",
        "authorName": "Maple Ridge Elementary PTA",
        "authorUrl": "https://www.facebook.com/mapleridgeschool",
        "reactionCount": 356,
        "commentCount": 42,
        "shareCount": 8,
        "image": "https://scontent.xx.fbcdn.net/v/t39.30808-6/scarecrow_parade.jpg",
        "createdUtc": 1726761600,
        "type": "post",
        "authorId": "339812065521",
        "authorImage": "https://scontent.xx.fbcdn.net/v/t39.30808-1/maple_ridge_avatar.jpg",
        "imagesCount": 1,
        "reactions": {
          "like": 290,
          "love": 55,
          "care": 8,
          "haha": 2,
          "wow": 1,
          "sad": 0,
          "angry": 0
        },
        "albumPreview": []
      }
    ]
  }
}

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

    harvest festival

    Mot-clé ou expression pour chercher des publications Facebook (p. ex. 'product launch').

  • endDatestring

    Ne renvoie que les publications publiées jusqu’à cette date, au format AAAA-MM-JJ (p. ex. 2024-12-31).

  • limitinteger

    3

    Nombre maximal de résultats à renvoyer (1-20, 20 par défaut).

  • locationstring

    Portland, United States

    Optional place name; include both city and country for best matches (e.g. 'Paris, France'). Uses Facebook's place filter, which favors posts tagged at that place rather than every post by people who live there, and can still return some posts from elsewhere.

  • requireFieldsarray

    Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `imagesCount` or `albumPreview`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. A named field can still be absent on a post that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge.

  • startDatestring

    Ne renvoie que les publications publiées à partir de cette date, au format AAAA-MM-JJ (p. ex. 2024-01-01).

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 albumPreviewdata.albumPreview[]

Preview of the photos attached to the post.

  • idstring

    Numeric Facebook id of the photo, as a string.

  • imagestring

    Image URL of the photo.

  • typestringpeut exiger

    Kind of attachment, e.g. "photo".

  • urlstring

    Canonical Facebook URL of the photo.

datadata
  • authorIdstring

    Numeric Facebook id of the page or profile that posted, as a string.

  • authorImagestring

    Profile picture URL of the page or profile that posted.

  • imagesCountintegerpeut exiger

    Number of images attached to the post. Null when the source does not report it.

  • typestringpeut exiger

    Kind of record Facebook returned, e.g. "post".

each itemdata.items[]

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

  • authorNamestring

    Riverside Community Market

    Display name of the post's author. Empty when the upstream omits it.

  • authorUrlstring

    https://www.facebook.com/riversidecommunitymarket

    Canonical profile URL of the post's author, with tracking query params stripped. Empty when the upstream omits it.

  • commentCountinteger

    96

    Total number of comments on the post.

  • createdUtcnumber

    1727366400

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

  • idstring

    743920185640217

    The post'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-6/harvest_festival_banner.jpg

    URL of the post's primary image, a signed CDN URL whose query must be kept. Empty for text-only or video posts.

  • reactionCountinteger

    842

    Total number of reactions on the post.

  • shareCountinteger

    213

    Total number of shares/reshares of the post.

  • textstring

    Fall Harvest Festival is back this Saturday! Live music, a pumpkin patch, cider pressing and over 40 local vendors. Free entry, 10am to 5pm at Riverside Park.

    The post's text/message. Empty for media-only posts with no caption.

  • urlstring

    https://www.facebook.com/riversidecommunitymarket/posts/743920185640217

    Canonical URL of the post. A post with no page path keeps the query that identifies it (permalink.php?story_fbid=...&id=...). Populated whenever the provider has data for the entity.

reactionsdata.reactions

Reaction counts on the post, broken down by reaction type.

  • angryinteger

    Angry reactions.

  • careinteger

    Care reactions.

  • hahainteger

    Haha reactions.

  • likeinteger

    Like reactions.

  • loveinteger

    Love reactions.

  • sadinteger

    Sad reactions.

  • wowinteger

    Wow reactions.

top level
  • foundboolean

    true

    Whether any matching posts 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 publications

L’API Facebook Recherche de publications d’AnyAPI renvoie des données Facebook en JSON normalisé à partir d’un appel POST à /v1/run/facebook.search_posts. Cherchez des publications Facebook publiques par mot-clé, éventuellement filtrées par lieu, et obtenez des fiches de publications structurées (texte, auteur, engagement). AnyAPI route chaque requête sur 3 sources et bascule automatiquement quand l’une échoue. Elle coûte à partir de 16 $US pour 1 000 requêtes, en dollars US, sans abonnement et sans minimum mensuel. Ces 30 derniers jours, 99,3% des appels Facebook Recherche de publications passés par AnyAPI ont réussi, avec un temps de réponse médian de 19,9 secondes, sur 21 836 appels mesurés.

Elle coûte à partir de 16 $US pour 1 000 requêtes, 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 publications Facebook publiques par mot-clé, éventuellement filtrées par lieu, et obtenez des fiches de publications structurées (texte, auteur, engagement). 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, 99,3% des appels Facebook Recherche de publications passés par AnyAPI ont réussi, avec un temps de réponse médian de 19,9 secondes, sur 21 836 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, ce qui couvre 6 appels Facebook Recherche de publications à 0,016 $US chacun.

AnyAPI interroge la suivante de ses 3 sources dans la même requête, la moins chère d’abord, donc la panne d’une source ne fait pas échouer votre appel.

Envoyez une requête POST à https://api.getanyapi.com/v1/run/facebook.search_posts 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.