Search LinkedIn groups

Search for LinkedIn groups by keywords. Groups are communities where professionals discuss industry topics, share insights, and network. Filter by group size to find active communities. Rate Limit: 300 searches per account per month (resets on the 1st of each month).

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"}}'

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

200 Example

{
  "success": true,
  "groups": [
    {
      "groupId": "6732842",
      "name": "Startup Founders, CEOs & Investors – Tech Innovation Network",
      "description": "Community for Startup Founders, CEOs, CXOs, Investors, VCs...",
      "logoUrl": "https://media.licdn.com/dms/image/.../group-logo",
      "groupUrl": "https://www.linkedin.com/groups/6732842/",
      "isPrivate": false
    },
    {
      "groupId": "45151",
      "name": "Cloud Computing, SaaS, Data Centre & Virtualization",
      "description": "A group for Cloud Computing professionals...",
      "logoUrl": "https://media.licdn.com/dms/image/.../group-logo",
      "groupUrl": "https://www.linkedin.com/groups/45151/",
      "isPrivate": false
    }
  ],
  "pagination": {
    "count": 25,
    "start": 0,
    "total": 1000
  },
  "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
}

Search LinkedIn groups

Code Examples

On this page