# Search LinkedIn industries (https://snitchfeed.com/docs/api/linkedin/industries/search)

**Authentication:** All requests require `Authorization: Bearer <api_key>` header. Obtain your API key from the SnitchFeed platform under Integrations → API Keys.

## `GET /data/linkedin/industries`

**Full URL:** `https://api.snitchfeed.com/v1/data/linkedin/industries`

**Summary:** Search LinkedIn industries

Look up LinkedIn industry IDs by name for the author_industry filter on LinkedIn post search. Paginated, read-only, and free of credits.

Returns matching industries with their numeric ID, label, and hierarchy path. Use the returned `id` values as the `author_industry` filter when calling `POST /data/linkedin/posts/search`.

**Read-only:** this endpoint does not consume credits.

### Query Parameters

| Name | Type | Required | Description |
|------|------|:--------:|-------------|
| `q` | string |  | Search term to filter industries by name, hierarchy, or description. |
| `page` | integer |  | Page number (1-indexed). Defaults to 1. Default: `1`. |

### Responses

#### `200`: Matching industries

#### Response fields

Successful `GET /data/linkedin/industries` response.

| Field | Type | Required | Description |
|-------|------|:--------:|-------------|
| `requestId` | string | ✓ | Server-generated id for this request (logging / support). |
| `industries` | object[] | ✓ |  |
| `meta` | object | ✓ |  |
| `total` | integer | ✓ | Total matching industries for this query. |
| `page` | integer | ✓ | Current page (1-indexed). |
| `pageCount` | integer | ✓ | Total number of pages. |
| `pageSize` | integer | ✓ | Results per page (always 25). |

#### `401`: Unauthorized

#### Response fields

Unauthorized

| Field | Type | Required | Description |
|-------|------|:--------:|-------------|
| `requestId` | string | ✓ | Server-generated id for this request (logging / support). |
| `error` | object | ✓ |  |
| `code` | "unauthorized" | ✓ |  |
| `message` | string | ✓ |  |

**Example:**
```json
{
  "requestId": "01HXYZABCDEF",
  "error": {
    "code": "unauthorized",
    "message": "Invalid or revoked API key."
  }
}
```

#### `403`: Forbidden: the credential lacks the `search:read` scope, the organization's plan does not include API access (API keys only), or the authorizing user's role lacks the required permission.

#### Response fields

Forbidden — the API key lacks a required scope, or its owner's role lacks the underlying permission.

| Field | Type | Required | Description |
|-------|------|:--------:|-------------|
| `requestId` | string | ✓ | Server-generated id for this request (logging / support). |
| `error` | object | ✓ |  |
| `code` | "forbidden" | ✓ |  |
| `message` | string | ✓ |  |

**Example:**
```json
{
  "requestId": "01HXYZABCDEF",
  "error": {
    "code": "forbidden",
    "message": "This credential does not have the \"search:read\" scope."
  }
}
```

#### `429`: Rate limited (20 requests per minute per surface) or too many concurrent in-flight requests (max 2 per organization)

#### Response fields

Rate limited or too many concurrent in-flight requests

| Field | Type | Required | Description |
|-------|------|:--------:|-------------|
| `requestId` | string | ✓ | Server-generated id for this request (logging / support). |
| `error` | object | ✓ |  |
| `code` | "rate_limited" | ✓ |  |
| `message` | string | ✓ |  |
| `retryAfter` | integer | ✓ | Seconds until the rate limit resets (same value as the `Retry-After` response header). |

**Example:**
```json
{
  "requestId": "01HXYZABCDEF",
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded for linkedin. Try again later.",
    "retryAfter": 42
  }
}
```
