API de Facebook

API de Facebook: Buscar publicaciones

Busca publicaciones públicas de Facebook por palabra clave, opcionalmente filtradas por ubicación, y obtén registros de publicaciones estructurados (texto, autor, interacción).

US$30.00/1k solic., pagas por solicitud, sin suscripción.

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
Lo que devolvió la APIitems[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 campos más
}
Disponibilidad
99.17%
30d · 17,172 llamadas
Solicitudes
17,300
30d · semanal, últimas 12 sem.
Respuesta
19.6s
mediana · 30d

Pruébalo

Obtén Buscar publicaciones de Facebook en una sola solicitud

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.
Abrir en
Respuesta de ejemplo
Las ejecuciones gratis devuelven solo los primeros 3 resultados. Agrega fondos a una clave para obtener la respuesta completa.

Este ejemplo muestra 13 de 31 campos. Ver todos los campos

{
  "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": []
      }
    ]
  }
}

Referencia completa de parámetros y respuesta: cada campo, tipo y ejemplo de este endpoint.

Referencia

Una solicitud, un formato de respuesta.

Cada campo que envías y cada campo que recibes, cada uno con un ejemplo real.

Verificado por última vez el 2026-11-14 · disponibilidad y latencia medidas en 30d

Cuerpo de la solicitud

JSON, enviado por POST a este endpoint.

  • querystring

    harvest festival

    Palabra clave o frase para buscar publicaciones de Facebook (p. ej., 'product launch').

  • endDatestring

    Devuelve solo publicaciones hechas en esta fecha o antes, formato YYYY-MM-DD (p. ej., 2024-12-31).

  • limitinteger

    3

    Número máximo de resultados que se devuelven (1-20, predeterminado 20).

  • 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

    Devuelve solo publicaciones hechas en esta fecha o después, formato YYYY-MM-DD (p. ej., 2024-01-01).

Envías. Un cuerpo JSON pequeño. Los valores que se muestran son ejemplos para reemplazar por los tuyos.

Respuesta

JSON, un valor de ejemplo por campo.

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.

  • typestringse puede exigir

    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.

  • imagesCountintegerse puede exigir

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

  • typestringse puede exigir

    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.

Recibes. Campos con nombre y tipo, con el mismo formato sin importar qué fuente responda.

Preguntas frecuentes

Acerca del endpoint Buscar publicaciones de la API de Facebook

El endpoint Buscar publicaciones de AnyAPI para Facebook devuelve datos de Facebook como JSON normalizado con una sola llamada POST a /v1/run/facebook.search_posts. Busca publicaciones públicas de Facebook por palabra clave, opcionalmente filtradas por ubicación, y obtén registros de publicaciones estructurados (texto, autor, interacción). AnyAPI enruta cada solicitud entre 3 fuentes y recurre automáticamente a otra cuando una falla. Cuesta desde US$30 por cada 1,000 solicitudes, en dólares estadounidenses, sin suscripción y sin mínimo mensual. En los últimos 30 días, el 99.2% de las llamadas al endpoint Buscar publicaciones de la API de Facebook a través de AnyAPI tuvo éxito, con un tiempo de respuesta mediano de 19.6 segundos en 17.172 llamadas medidas.

Cuesta desde US$30 por cada 1,000 solicitudes, en dólares estadounidenses, sin suscripción y sin mínimo mensual. Agregas fondos a una billetera en dólares y cada llamada descuenta de ella. Algunas solicitudes fallidas pagadas con la billetera generan cargos de procesamiento que trasladamos al costo, sin margen; la respuesta de error muestra el monto cobrado.

Busca publicaciones públicas de Facebook por palabra clave, opcionalmente filtradas por ubicación, y obtén registros de publicaciones estructurados (texto, autor, interacción). La respuesta es JSON normalizado con el mismo envoltorio que devuelve cada endpoint de AnyAPI, así que procesar un segundo endpoint es solo cambiar la URL.

En los últimos 30 días, el 99.2% de las llamadas al endpoint Buscar publicaciones de la API de Facebook a través de AnyAPI tuvo éxito, con un tiempo de respuesta mediano de 19.6 segundos en 17.172 llamadas medidas. Estas son mediciones propias de AnyAPI sobre el tráfico que pasa por el gateway, recalculadas continuamente, no un objetivo de nivel de servicio publicado.

Sí. Una cuenta nueva de AnyAPI empieza con US$0.10 de saldo gratis, sin tarjeta, que alcanza para 3 llamadas a Buscar publicaciones de Facebook a US$0.03 cada una.

AnyAPI consulta la siguiente de sus 3 fuentes en la misma solicitud, empezando por la más barata, así que la caída de una fuente no hace fallar tu llamada.

Envía una solicitud POST a https://api.getanyapi.com/v1/run/facebook.search_posts con tu clave de AnyAPI en un encabezado "Authorization: Bearer" y la entrada como cuerpo JSON. La misma clave y la misma billetera sirven para todos los endpoints de AnyAPI.

No. Agregas dólares a un solo saldo prepagado de AnyAPI y cada solicitud descuenta de él. No hay plan mensual ni mínimo, y el mismo saldo paga todos los endpoints de AnyAPI.

Sí. Instala @getanyapi/sdk desde npm para TypeScript o getanyapi desde pip para Python. Ambos llaman a todos los endpoints de AnyAPI con la misma clave, y también sirve cualquier cliente HTTP.

Sí. Un agente puede conectarse al servidor MCP de AnyAPI en https://api.getanyapi.com/mcp, o crear su propia clave de prueba gratis con un solo POST sin autenticar a https://api.getanyapi.com/agent/signup y llamar a este endpoint por HTTP.