Search LinkedIn groups

Search for LinkedIn groups by keywords. Groups are communities where professionals discuss industry topics, share insights, and network. LinkedIn's group search offers a keyword box and nothing else — there are no filters — so `filters.memberCount` is accepted for backward compatibility but never applied; sort/filter the returned `memberCount` client-side instead. Results are paged internally to satisfy `count`. Page sizes vary (8-10 rows), so a short page is not the end of the result set — use `hasMore`, never the length of the returned array, to decide whether to keep paging. Rate limit: no per-account search quota is enforced on this endpoint — only the general 30-calls-per-minute velocity limit.

POST/search/groups

Authentication requiredSearch

Code Examples

curl -X POST 'https://api.connectsafely.ai/linkedin/search/groups' \
  -H 'Authorization: Bearer <your_api_key>' \
  -H 'Content-Type: application/json' \
  -d '{"accountId":"acc_12345","keywords":"","count":25,"start":0,"filters":{"memberCount":"example_value"}}'

Search for LinkedIn groups by keywords. Groups are communities where professionals discuss industry topics, share insights, and network.

LinkedIn's group search offers a keyword box and nothing else — there are no filters — so filters.memberCount is accepted for backward compatibility but never applied; sort/filter the returned memberCount client-side instead.

Results are paged internally to satisfy count. Page sizes vary (8-10 rows), so a short page is not the end of the result set — use hasMore, never the length of the returned array, to decide whether to keep paging.

Rate limit: no per-account search quota is enforced on this endpoint — only the general 30-calls-per-minute velocity limit.

Parameters

No parameters.

Request Body

Field	Type	Required	Description
`accountId`	string	No	LinkedIn account ID to use for the search. If not provided, uses the default account.
`keywords`	string	No	Search keywords for group name or description
`count`	number	No	Number of results to return per page
`start`	number	No	Pagination offset (0-indexed)
`filters`	object	No	Optional filters to narrow down search results

Example

{
  "accountId": "acc_12345",
  "keywords": "",
  "count": 25,
  "start": 0,
  "filters": {
    "memberCount": "example_value"
  }
}

Responses

Status	Description
200	Groups retrieved successfully
400	Bad Request - Invalid request parameters
401	Unauthorized - Invalid or missing API key
500	Internal Server Error - Failed to get LinkedIn credentials or search failed

200 Response Parameters

Name	Type	Description
`success`	boolean
`groups`	array
`pagination`	any
`hasMore`	boolean	Whether more results are available past this batch. Derived by fetching one row beyond the requested `count`, so it is exact — not a guess from the page being full.

200 Example

{
  "success": true,
  "groups": [
    {
      "groupId": "9121382",
      "name": "AI & GTM (News, Jobs, Tools and everything in between)",
      "memberCount": 1000,
      "logoUrl": "https://media.licdn.com/dms/image/.../group-logo",
      "groupUrl": "https://www.linkedin.com/groups/9121382/",
      "isPrivate": false
    },
    {
      "groupId": "8645802",
      "name": "GTM AI",
      "memberCount": 813,
      "logoUrl": "https://media.licdn.com/dms/image/.../group-logo",
      "groupUrl": "https://www.linkedin.com/groups/8645802/",
      "isPrivate": true
    }
  ],
  "pagination": {
    "count": 10,
    "start": 0,
    "total": 580
  },
  "hasMore": true
}

400 Response Parameters

Name	Type	Description
`success`	boolean
`error`	object

400 Example

{
  "success": false,
  "error": {
    "issues": [
      {
        "code": "invalid_type",
        "expected": "string",
        "received": "undefined",
        "path": [
          "keywords"
        ],
        "message": "Required"
      }
    ],
    "name": "ZodError"
  }
}

401 Response Parameters

Name	Type	Description
`error`	string

401 Example

{
  "error": "Unauthorized - Invalid credentials"
}

500 Response Parameters

Name	Type	Description
`error`	string

500 Example

{
  "error": "Failed to search groups",
  "success": false
}

Code Examples

On this page