Facebook API: Search top results (v1)

Searches Facebook's top results for free text and returns a mixed list of posts and profiles. Each result has a type field naming its shape. Paginate with cursor from pageInfo. An empty results 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/top?query=nasa" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "results": [      {        "type": "post",        "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"  }}