Facebook / Search

Search All

Search Facebook's All tab. Each returned post or video-post card costs 4 credits; other cards are free.

Request

POST /api/facebook/search/all with your bearer API key.

query	Required search text.
recent	Optional boolean: newest results first.
location_id	Optional numeric Facebook location ID.
start_date	First posted date, inclusive, YYYY-MM-DD. Send with end_date.
end_date	Last posted date, inclusive, YYYY-MM-DD. Send with start_date.
cursor	Omit initially. Send data.pagination.cursor unchanged with the same query and filters to continue.

▸ ▾ request {}

{"query":"gardening","recent":true}

Each call returns one page. Stop when data.pagination.has_next_page is false. A page without post or video-post cards costs nothing. A wallet that cannot cover the page receives 402; failed fetches are refunded.

Response sample

▸ ▾ response {} — illustrative; native card shortened

{
  "cost": 4,
  "created_at": 1790812800,
  "request_duration": 310,
  "parse_duration": 1,
  "data": {
    "posts": [
      {
        "id": "1574024561426306",
        "url": "https://www.facebook.com/TMZ/posts/1574024561426306/",
        "created_at": 1790812800,
        "text": "An update from our community.",
        "author": {
          "id": "100000000000001",
          "name": "Community Updates",
          "url": "https://www.facebook.com/communityupdates/"
        },
        "group": {
          "id": null,
          "name": null,
          "url": null
        },
        "engagement": {
          "reaction_count": 10,
          "comment_count": 3,
          "share_count": 1
        },
        "media": [],
        "shared_post": null
      }
    ],
    "users": [],
    "results": [
      {
        "role": "TOP_PUBLIC_POSTS",
        "type": "SearchRichPostRenderingStrategy",
        "data": {
          "__typename": "SearchRichPostRenderingStrategy",
          "view_model": {
            "click_model": {
              "story": {
                "post_id": "1574024561426306"
              }
            }
          }
        }
      }
    ],
    "pagination": {
      "has_next_page": true,
      "cursor": "<opaque cursor>"
    }
  }
}

Fields

Responses include cost, created_at, request_duration and parse_duration alongside data. Missing optional fields are null.

data.posts []

idtextFacebook post ID.

urltextPost permalink.

texttextPost body, or null.

created_atnumberUnix timestamp in seconds.

authorobjectAuthor ID, name and profile URL.

groupobjectGroup ID, name and URL, when the post belongs to a group.

engagementobjectReaction, comment and share counts.

mediaobject[]Image, video, album and link attachment details.

shared_postobjectEmbedded original when available, or null.

data.users []

idtextProfile ID.

nametextDisplay name.

urltextProfile URL.

profile_picture_urltextProfile picture URL, or null.

is_verifiedbooleanVerification mark when supplied.

data.results []

roletextFacebook result role.

typetextFacebook card type.

dataobjectNative card data. Includes videos, pages, groups, Marketplace and nested modules when returned.

data.pagination {}

has_next_pagebooleanWhether another page is available.

cursortextOpaque continuation; null at the end.