InsightSocial API
Facebook

Profile › Photos

GET
/v1/facebook/profile/photos

Returns a page or profile's photos, each with a photo id, permalink, full-size image URL, thumbnail, and accessibility caption when available.

Use it for a page's photo gallery. The plain row carries no author, engagement or publish time, so add the optional include=details to fill them from each photo's own post in the same call.

Metered: 20–180 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 6h 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

url*string

Full URL of the Facebook page or profile

next_page_id?string

To paginate through to the next page

include?"details"

Set to details (one token only) to fill post.author.display_name, post.author.avatar_url, post.ext.author_id, post.engagement.likes, .comments and .shares, and post.published_at on every photo in this one call. A photo inside a multi-photo post carries its own counts, not the post's. Without it the call is unchanged.

Value in

  • "details"

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/photos?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 › Full GET

Returns a page's profile plus its latest 3 posts and computed figures: engagement rate by views and by followers, posting cadence, top post, and format mix. Use it instead of calling profile and profile/posts yourself; the profile still comes back even if the posts part fails. **100 credits** per call. Re-running the exact same call within 6h is free. Paginates by `cursor` — see [Pagination](/docs/pagination).

Profile › Posts GET

Returns recent posts from a Facebook page or profile, each with the post text, like and comment counts, the per-reaction breakdown, media, and publish time. Share counts are null on a plain call. Use it to pull a page's recent content by url or pageId. The optional include=engagement fills each row's share count, and a reel's exact views and duration, in the same call. **Metered: 20–80 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 6h is free. Paginates by `cursor` — see [Pagination](/docs/pagination).