InsightSocial API
Facebook

Profile

GET
/v1/facebook/profile

Returns a Facebook page's public profile: page id, display name, profile image, bio, follower count, and page-like count.

Use it when you have a page URL and want a quick snapshot before pulling that page's posts, photos, or reels.

20 credits per call.

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

Authorization

apiKey
x-api-key<token>

Your key from the dashboard. It starts with isk_.

In: header

Query Parameters

url*string

Full URL of the Facebook page or profile

get_business_hours?string

Get the business's hours

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/profile?url=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}

Profile › Reels GET

Returns a page or profile's reels, each with a reel id, description, thumbnail, permalink, publish time, and a rounded public view count. Use it for a cheap reel listing; when you need exact views plus likes, comments, and shares, use profile/reels/full instead. **20 credits** per call. Re-running the exact same call within 6h is free. Paginates by `cursor` — see [Pagination](/docs/pagination).

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).