> ## Documentation Index
> Fetch the complete documentation index at: https://docs.linkupapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Search Profiles

> Search LinkedIn profiles with multiple criteria

## Description

This endpoint allows you to search LinkedIn profiles using different search criteria.

<Note>
  **Credit Usage:** 1 credit per 10 results (or fraction thereof). For example:

  * 1-10 results = 1 credit
  * 11-20 results = 2 credits
  * 300 results = 30 credits
</Note>

## Headers

<ParamField header="x-api-key" type="string" required>
  Your API key for authentication
</ParamField>

## Body Parameters

<ParamField body="keyword" type="string">
  Main search keyword (name, position, skills, etc.)
</ParamField>

<ParamField body="job_title" type="string">
  Job title to search for
</ParamField>

<ParamField body="industry" type="string">
  Industry sector (e.g., "technology", "finance", "healthcare")
</ParamField>

<ParamField body="school" type="string">
  School or university
</ParamField>

<ParamField body="location" type="string">
  Location (city, country)
</ParamField>

<ParamField body="current_company" type="string">
  Current company
</ParamField>

<ParamField body="total_results" type="integer" default="10">
  Number of results to return

  * Minimum: 1
  * Maximum: 50,000
  * Default: 10
</ParamField>

<Note>
  At least one search criteria must be provided among: `keyword`, `job_title`, `industry`, `school`, `location`, or `current_company`.
</Note>

## Response

<ResponseField name="status" type="string">
  Response status ("success" or "error")
</ResponseField>

<ResponseField name="data" type="object">
  <Expandable title="Response Data">
    <ResponseField name="total_results" type="integer">
      Total count of all matching results
    </ResponseField>

    <ResponseField name="profiles" type="array">
      List of found profiles

      <Expandable title="Profile Structure">
        <ResponseField name="url" type="string">
          LinkedIn profile URL
        </ResponseField>

        <ResponseField name="title" type="string">
          Profile title/name from LinkedIn
        </ResponseField>

        <ResponseField name="description" type="string">
          Profile description/summary
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="message" type="string">
  Error message (if status = "error")
</ResponseField>

## Request Example

```python theme={null}
import requests

url = "https://api.linkupapi.com/v1/data/search/profiles"

payload = {
    "keyword": "developer",
    "job_title": "Software Engineer",
    "industry": "Technology",
    "location": "Paris",
    "current_company": "Microsoft",
    "total_results": 15
}
headers = {
    "x-api-key": "your-api-key-here",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())
```

```json theme={null}
{
  "keyword": "developer",
  "job_title": "Software Engineer",
  "industry": "Technology",
  "location": "Paris",
  "current_company": "Microsoft",
  "total_results": 15
}
```

## Request Example with Arrays

```python theme={null}
import requests

url = "https://api.linkupapi.com/v1/data/search/profiles"

payload = {
    "keyword": ["developer", "engineer", "programmer"],
    "job_title": ["Software Engineer", "Frontend Developer"],
    "industry": ["Technology", "Finance"],
    "location": ["Paris", "Lyon", "Marseille"],
    "current_company": ["Microsoft", "Google", "Apple"],
    "total_results": 20
}
headers = {
    "x-api-key": "your-api-key-here",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())
```

```json theme={null}
{
  "keyword": ["developer", "engineer", "programmer"],
  "job_title": ["Software Engineer", "Frontend Developer"],
  "industry": ["Technology", "Finance"],
  "location": ["Paris", "Lyon", "Marseille"],
  "current_company": ["Microsoft", "Google", "Apple"],
  "total_results": 20
}
```

## Response Example

<ResponseExample>
  ```json theme={null}
  {
    "status": "success",
    "data": {
      "total_results": 1523,
      "profiles": [
        {
          "url": "https://www.linkedin.com/in/johnperez",
          "title": "John M P. - CRM Experts Online - LinkedIn",
          "description": "As the founder of CRM Experts Online, I leverage my 19+ years of experience in enterprise… · Experience: CRM Experts Online · Education: New York College Of ..."
        },
        {
          "url": "https://www.linkedin.com/in/brentleary",
          "title": "Brent Leary - CRM Essentials - LinkedIn",
          "description": "Brent Leary is Co-founder and Partner of CRM Essentials LLC, a CRM consulting/advisory… · Experience: CRM Essentials · Location: Stockbridge · 500+ ..."
        },
        {
          "url": "https://www.linkedin.com/in/jsrosenth",
          "title": "Jeff Rosenthal - Head of CRM GTM, North America - monday.com",
          "description": "I lead GTM for an emerging portfolio of CRM & AI products at monday.com. Deep expertise in CRM & AI GTM as a trusted advisor to global go to market, sales, ..."
        }
      ]
    }
  }
  ```
</ResponseExample>

<ResponseExample>
  ```json theme={null}
  {
    "status": "error",
    "message": "At least one search criteria must be provided"
  }
  ```
</ResponseExample>

## Usage Examples

### Search by position and location

```json theme={null}
{
  "job_title": "Data Scientist",
  "location": "Lyon",
  "total_results": 10
}
```

### Search by school and industry

```json theme={null}
{
  "school": "Harvard University",
  "industry": "Finance",
  "total_results": 20
}
```

### Search by company and keyword

```json theme={null}
{
  "current_company": "Microsoft",
  "keyword": "artificial intelligence",
  "total_results": 25
}
```

### Batch search with multiple keywords

```json theme={null}
{
  "keyword": ["data scientist", "machine learning engineer", "AI researcher"],
  "location": ["Paris", "Lyon"],
  "industry": ["Technology", "Healthcare"],
  "total_results": 50
}
```

### Advanced search with multiple criteria

```json theme={null}
{
  "job_title": ["Software Engineer", "Full Stack Developer"],
  "current_company": ["Google", "Microsoft", "Apple"],
  "location": ["Paris", "London", "Berlin"],
  "industry": "Technology",
  "total_results": 40
}
```

### Search with specific number of results

```json theme={null}
{
  "keyword": "data scientist",
  "location": "Paris",
  "total_results": 15
}
```

## Important Notes

* Credit consumption is based on the number of results: 1 credit for 1-10 results, 2 credits for 11-20 results, etc.
* Credits are only deducted on successful searches
* **Single keyword**: Advanced search with optional filters for precise results
* **Multiple keywords**: Automatically activates batch mode for parallel searching
* Too many keywords can hurt search relevance - it's better to focus on 2-3 key terms rather than overloading the query.
* All search parameters support both single strings and arrays for flexible searching