Search schools

Search LinkedIn school IDs by name. Use it to find the `schoolId` that `POST /search/people` accepts in `filters.schoolIds`. 1. `POST /search/schools` with `{ "keywords": "Stanford" }` returns `{ "schoolId": "1792", "name": "Stanford University" }`. 2. `POST /search/people` with `{ "filters": { "schoolIds": ["1792"] } }`. Results come from the same typeahead the LinkedIn people-search "Schools" filter uses, so the ids are exactly the ones the filter accepts. Returns up to 10 matches, in LinkedIn's own ranking order. Rate Limit: 300 searches per account per month (resets on the 1st of each month).

POST/search/schools

Authentication requiredSearch

Code Examples

curl -X POST 'https://api.connectsafely.ai/linkedin/search/schools' \
  -H 'Authorization: Bearer <your_api_key>' \
  -H 'Content-Type: application/json' \
  -d '{"keywords":"software engineer"}'

Search LinkedIn school IDs by name. Use it to find the schoolId that POST /search/people accepts in filters.schoolIds.

POST /search/schools with { "keywords": "Stanford" } returns { "schoolId": "1792", "name": "Stanford University" }.
POST /search/people with { "filters": { "schoolIds": ["1792"] } }.

Results come from the same typeahead the LinkedIn people-search "Schools" filter uses, so the ids are exactly the ones the filter accepts. Returns up to 10 matches, in LinkedIn's own ranking order.

Rate Limit: 300 searches per account per month (resets on the 1st of each month).

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	Yes	School name to search for (e.g., "Stanford", "Pune", "MIT")

Example

{
  "keywords": "software engineer"
}

Responses

Status	Description
200	Schools retrieved successfully
400	Bad Request - Missing required keywords parameter
401	Unauthorized
500	Failed to search schools

200 Response Parameters

Name	Type	Description
`success`	boolean
`schools`	array
`count`	number	Number of schools returned

200 Example

{
  "success": true,
  "schools": [
    {
      "name": "Stanford University",
      "schoolId": "1792"
    },
    {
      "name": "Stanford Graduate School of Business",
      "schoolId": "2742"
    }
  ],
  "count": 2
}

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

Code Examples

On this page