Facebook API: Search public posts (v1)

Searches public Facebook posts by free text and returns each post's text, author, creation time, photos and reaction, comment and share counts. Paginate with cursor from pageInfo. An empty posts array means no public match.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

query*string

Free-text search phrase.

Length1 <= length <= 200

cursor?string

Opaque pagination cursor from a previous response.

count?integer

Records per page. Facebook caps most surfaces well below this.

Range1 <= value <= 50

curl -X GET "https://example.com/v1/facebook/search/posts?query=nasa" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "posts": [      {        "postId": "string",        "url": "string",        "text": "string",        "createdTime": 0,        "author": {          "id": "string",          "name": "string",          "url": "string"        },        "media": [          {            "id": "string",            "type": "string",            "url": "string",            "imageUrl": "string",            "altText": "string"          }        ],        "reactionCount": 0,        "commentCount": 0,        "shareCount": 0      }    ],    "pageInfo": {      "cursor": "string",      "hasNextPage": true    }  },  "details": {    "reason": "string",    "message": "string"  }}