# Search LinkedIn companies

### Search LinkedIn companies

`POST /api/v1/linkedin/companies/search`

Operation ID: `searchLinkedinCompanies`

Company search by keywords or a company search URL, one or the other. Hits carry the numeric id, which the company endpoints accept as identifier.

**Request body** (required)

- `connectedAccountId` (string · uuid, required): Connected account to act as
- `keywords` (string, optional)
- `searchUrl` (string · uri, optional): A search URL copied from LinkedIn, searching for the same kind of entity this endpoint returns. Filters carried in the URL take precedence.
- `cursor` (string, optional)
- `limit` (integer, optional): Page size, capped at 10 for a company keyword search. Use cursor for the next page.

**200**: Companies and an optional cursor.

- `companies` (object[], required)
- `cursor` (string | null, required)
- `remainingUsage` (object, required): Remaining allowance for this action on the connected account across hourly, daily, and weekly windows. Each action type has its own limits.
  - `hour` (integer | null, required): Remaining hourly allowance for this action. Null when this action has no hourly cap.
  - `day` (integer, required): Remaining daily allowance for this action.
  - `week` (integer | null, required): Remaining weekly allowance for this action. Null when this action has no weekly cap.
- `requestId` (string · uuid, required): Id of this request, for support and troubleshooting

**Errors**

- `400`: Bad request
- `401`: Unauthorized: missing or invalid API key
- `403`: Forbidden
- `404`: Not found
- `422`: Invalid request payload
