InsightSocial APIFacebook Search Groups API reference
Your first 10 calls are free, no card needed. Pricing and FAQ
Get a free API keycurl "https://api.insightsocial.app/v1/facebook/search/groups?query=vintage%20cars" \ -H "x-api-key: $INSIGHTSOCIAL_API_KEY"
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: 10–110 credits. We reserve the ceiling when the call starts and charge what it actually used when it finishes.
Paginates by cursor: see Pagination.
Authorization
apiKey Your key from the dashboard. It starts with isk_.
In: header
Query Parameters
Keywords describing the groups to find, for example vintage cars. Keywords only: the search is already limited to public Facebook groups, so a site: operator is refused before billing.
Page number, starting at 1. Forwarding pagination.next_cursor as cursor does the same.
1 <= valueSet to details (one token only) to fill, on every group in this one call, author.followers (members), author.bio (the description), author.joined_at, author.ext.group.privacy_label, visibility_label, activity and id (the numeric group id), and the name where it was null. Without it the call is unchanged.
Value in
- "details"
Set to 1 to get the price of this call without making it: data.dry_run carries credits_min and credits_max. Nothing is charged.
Value in
- "1"
The pagination.next_cursor from the previous page, sent back unchanged. Omit it for the first page.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api.insightsocial.app/v1/facebook/search/groups?query=string"{ "success": true, "platform": "string", "endpoint": "string", "schema_version": "2", "pagination": { "next_cursor": "string", "has_more": true, "page_size": 0, "stopped_at": "since" }, "unavailable": [ "string" ], "credits_used": 0, "credits_remaining": 0, "request_id": "string", "cached": true, "idempotent_replay": true, "charge_reason": "string", "free_call": true, "data": { "items": [ { "author": { "id": "string", "username": "string", "display_name": "string", "avatar_url": "http://example.com", "bio": "string", "verified": true, "followers": 0, "followers_approximate": true, "following": 0, "posts_count": 0, "likes_count": 0, "url": "http://example.com", "location": "string", "external_url": "http://example.com", "private": true, "joined_at": "2019-08-24T14:15:22Z", "last_post_at": "2019-08-24T14:15:22Z", "ext": { "property1": null, "property2": null } } } ], "total": 0, "truncated": true, "ext": { "property1": null, "property2": null } }}