# LinkedIn Industries Finder

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/finder/linkedin-industries` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 0 credits per call |
| **Documentation** | https://www.piloterr.com/library/finder-linkedin-industries |

## Description

Search LinkedIn industry taxonomy to retrieve industry IDs and hierarchies for use in LinkedIn API calls and data enrichment.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/finder/linkedin-industries' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Search by query 'software development'

```json
[
  {
    "id": 356,
    "label": "Software Development",
    "level": "3",
    "hierarchie": "Retail > Professional Services > Services for Renewable Energy > Technology, Information and Media > Technology, Information and Internet > Software Development",
    "description": "This industry includes entities that publish computer software and carry out operations necessary for production and distribution, such as design, documentation, installation, and support services. They may design, develop, and publish, or publish only; they may publish and distribute remotely through subscriptions and downloads.",
    "industry_id": "4"
  },
  {
    "id": 107,
    "label": "Embedded Software Products",
    "level": "4",
    "hierarchie": "Education > Utilities > Electric Power Transmission, Control, and Distribution > Consumer Services > Repair and Maintenance > Electronic and Precision Equipment Maintenance > Technology, Information and Media > Technology, Information and Internet > Software Development > Embedded Software Products",
    "description": "This industry includes entities that produce software (or \"firmware\") for machines or devices that are not usually thought of as computers, ex: routers, refrigerators, display systems, washing machines, etc. such as, software for the internet of things but do not produce these devices.",
    "industry_id": "3099"
  },
  {
    "id": 91,
    "label": "Data Security Software Products",
    "level": "4",
    "hierarchie": "Consumer Services > Financial Services > Credit Intermediation > Technology, Information and Media > Technology, Information and Internet > Data Infrastructure and Analytics > Technology, Information and Media > Technology, Information and Internet > Software Development > Data Security Software Products",
    "description": "This industry includes entities that produce software to ensure security of data and computing systems.",
    "industry_id": "3130"
  },
  {
    "id": 95,
    "label": "Desktop Computing Software Products",
    "level": "4",
    "hierarchie": "Consumer Services > Professional Services > Design Services > Hospitals and Health Care > Medical Practices > Dentists > Technology, Information and Media > Technology, Information and Internet > Software Development > Desktop Computing Software Products",
    "description": "This industry includes entities that produce software which runs on desktop or laptop computers.",
    "industry_id": "3101"
  },
  {
    "id": 189,
    "label": "IT System Custom Software Development",
    "level": "3",
    "hierarchie": "Hospitals and Health Care > Professional Services > IT Services and IT Consulting > Professional Services > IT Services and IT Consulting > IT System Custom Software Development",
    "description": "This industry includes entities that focus on creating, modifying, testing, and supporting software to meet the needs of a particular customer.",
    "industry_id": "3102"
  }
]
```

## Documentation

## Overview
The LinkedIn Industries Finder endpoint allows you to search for Piloterr-supported LinkedIn industries. Results are ordered by reach: industries covering the most professionals appear first. This endpoint is free to use and is designed to help you discover the correct industry IDs before filtering LinkedIn profiles, companies, or job searches.

## Quickstart
```
GET https://api.piloterr.com/v2/finder/linkedin-industries?query=software+development
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | String to search for in industry names |

## Response fields
| Field | Type | Description |
|---|---|---|
| `id` | number | Internal Piloterr industry identifier |
| `industry_id` | string | LinkedIn industry identifier |
| `level` | string | Industry hierarchy depth level |
| `label` | string | Industry display name |
| `hierarchie` | string | Full industry hierarchy path |
| `description` | string | LinkedIn industry description |

## Notes
- Results are ordered by professional reach on LinkedIn
- Use `industry_id` as the industry filter in LinkedIn Company Info or Job Search API calls
- The `level` field indicates depth in the LinkedIn taxonomy (1=top level, 5=most specific)

## Main use cases
- Resolve industry names to LinkedIn IDs for filtering company or profile searches
- Build industry pickers for B2B prospecting and lead generation tools
- Segment LinkedIn data by industry for market intelligence and competitive analysis
- Validate industry inputs for CRM enrichment workflows using LinkedIn data