InsightSocial API
Facebook

Search › Pages

GET
/v1/facebook/search/pages

Returns Facebook pages matching a keyword, each with page id, display name, permalink, avatar, and verified flag.

Use it to find pages by name; follower counts are not on this card, so take author.url to profile for the full page.

20 credits per call.

Re-running the exact same call within 1h is free.

Paginates by cursor — see Pagination.

Authorization

apiKey
x-api-key<token>

Your key from the dashboard. It starts with isk_.

In: header

Query Parameters

query*string

Keyword or phrase to search for.

cursor?string

Cursor from the previous response.

location_uid?string

Facebook location id to scope the search.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/facebook/search/pages?query=string"
{  "success": true,  "platform": "instagram",  "endpoint": "/v1/instagram/profile/posts",  "data": {    "items": [      "…"    ],    "dropped": 0  },  "pagination": {    "next_cursor": "is2.eyJwIjoyfQ",    "has_more": true,    "page_size": 12  },  "credits_used": 20,  "credits_remaining": 9980,  "request_id": "req_1a2b3c4d5e6f",  "cached": false,  "idempotent_replay": false,  "charge_reason": "miss",  "free_call": false}

Search › Groups GET

Returns public Facebook groups matching your keywords, one row per group, with the group's name, id and URL in the same shape the group endpoints take. Use it when you need to find the groups to read before pulling their posts. Add include=details for member counts, descriptions and privacy. **Metered: 20–300 credits.** We reserve the ceiling when the call starts and charge what it actually used when it finishes. Re-running the exact same call within 1h is free. Paginates by `cursor` — see [Pagination](/docs/pagination).

Search › People GET

Returns Facebook people matching a keyword, each with profile id, display name, permalink, avatar, and verified flag. Use it to find people by name. The id is often a pfbid token, not a numeric user id, and follower counts are not on this card. **20 credits** per call. Re-running the exact same call within 1h is free. Paginates by `cursor` — see [Pagination](/docs/pagination).