InsightSocial API
Facebook

Events

GET
/v1/facebook/events

Returns the events listed on a Facebook city or region events page, each with a title, link, cover image, the start time, the venue, and the going and interested counts.

Use it to see what is on in a place, optionally narrowed by a time filter; use profile/events for one page's own events. The optional include=details adds the description, address and hosts.

Metered: 20–260 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 city's Facebook Events page.

time?string

Relative time window. Defaults to all time when omitted.

Value in

  • "today"
  • "this_week"
  • "next_week"
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, city, latitude, longitude, hosts, host_context_text, category, privacy, is_canceled and attendance_count, and the host credit on post.author.display_name. 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/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}

Events › Search GET

Returns public Facebook events matching a keyword, each with name, date sentence, venue, cover photo, interested and going counts, and online and past flags. Use it to find events by topic anywhere; filter on is_past yourself, since the directory also returns events that have already happened. **20 credits** per call. Re-running the exact same call within 1h is free. Paginates by `cursor` — see [Pagination](/docs/pagination).

Group › Posts GET

Returns posts from a Facebook group, 3 to 4 per page, each with the post text, reaction count, comment count, the per-reaction breakdown, and author info. Use it for group content, since profile/posts covers pages only. Send next_cursor back as cursor for older posts. Share counts are not on this surface; read one with post. **20 credits** per call. Re-running the exact same call within 6h is free. Paginates by `cursor` — see [Pagination](/docs/pagination).