InsightSocial API
Facebook

Profile › Events

GET
/v1/facebook/profile/events

Returns a Facebook page's upcoming and past events, each with a title, link, the start time, the venue, the city, the rendered time line, and the cancelled, past and online flags.

Use it for one page's own events; events covers a city. The start time sits on published_at and is often in the future. Optional include=details adds the description, hosts, cover and RSVP counts.

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 public Facebook page.

cursor?string

Cursor returned by the previous response for pagination.

include?"details"

Set to details (one token only) to fill, on every event in this one call, post.ext.event.description, address, latitude, longitude, hosts, host_context_text, category, privacy, attendance_count, interested_count and going_count, the cover image on post.content.thumbnail_url, and the RSVP counts on post.engagement.views (interested) and .likes (going). 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/events?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}

Post GET

Returns one Facebook post in full: the post text, like, comment and share counts, a reactions breakdown, media attachments, and author info. Use it when you have a single post URL and need more than profile/posts gives, such as the reactions breakdown. **20 credits** per call. Re-running the exact same call within 6h is free.

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