# People Search API for Fast, Accurate Prospecting

Find decision-makers by LinkedIn URLs or filters and keep searches organized in your dashboard, with clear pagination and production-ready rate limits.

[Grab an API Key](https://app.redrob.io/developer-hub)

## Benefits that Make People Search Usable

Stop guessing and start targeting. Redrob turns people's search into usable lists with LinkedIn inputs, crisp filters, and results you can actually operationalize.

### Find People from LinkedIn Inputs

Search by a single LinkedIn URL or send LinkedIn URLs in bulk to power faster prospect search API flows.

### Build Targeted Lists with Filters

Create lead search API lists using fields like job title, seniority, skills, location, company, and industry.

### Keep Searches Organized in the Dashboard

All People Search API runs are visible on your dashboard. Use a readable title to find searches later.

### Scale Within Clear Limits

Designed for teams running a B2B prospecting API in production with defined per-minute call limits.

# Want to find your next buyers?

Use the People Search API as a decision maker search API built for prospecting workflows.

[Get started](https://app.redrob.io/)

# How the People Search API works

Choose your path - look up known profiles via LinkedIn URLs or discover new prospects with filters. Redrob returns structured results with navigation-ready pagination.

#### Search by LinkedIn URLs

Send multiple LinkedIn profile URLs in one request for faster list-building.

#### Search by LinkedIn URL

#### People Search by Filters

```bash
curl --request POST \
 --url https://developersapi.redrob.io/search/v2/api/people/by-filters \
 --header 'Content-Type: application/json' \
 --header 'Authorization: Bearer <token>' \
 --data '{
  "title":"Search for people by filters",
  "name":[
    "John Doe",
    "Jane Doe"
  ],
  "job_title":[
    "Software Engineer",
    "Product Manager"
  ],
  "seniority":[
    "Junior",
    "Senior"
  ],
  "skills":[
    "Javascript",
    "React"
  ],
  "degree":[
    "Bachelor of Science",
    "Master of Business Administration"
  ],
  "institution":[
    "Harvard University",
    "Stanford University"
  ],
  "location":[
    "New York, NY",
    "San Francisco, CA"
  ],
  "company":[
    "Google",
    ""
  ]
}'
```

## People Search Endpoints & Fields

Here’s the exact Redrob People Search API structure - Bearer auth, request fields for LinkedIn and filter searches, rate limits, and response metadata for pagination.

## Use a Bearer authentication header:
- **Header:** `Authorization: Bearer <token>`  
- `<token>` is your auth token.

## Search People by LinkedIn URLs

**Practical tip:** Use a readable **title** for each search. Example: `Firstname Lastname`

**Rate limit (shown):**
- **25 API calls per minute**
- Up to **100 contacts in one bulk**, enabling up to **2,500 contacts per minute**

**Body (application/json):**
- `title` _(string, required)_ — Example: `"Search John Doe"`
- `linkedinUrls` _(string[], required)_

```json
{  
  "title":"Search John Doe",
  "linkedinUrls":["https://www.linkedin.com/in/john-doe"]
}
```

// response

- `name` (string, required) — Example: "success"
- `message` (object[], required) — Example: "Success message"
- `error` (boolean) — Example: false
- `data` (object) with TBD (string) — Example: "67190b1b0000000000000000"

## Search People by LinkedIn URL

**Body (application/json):**
- `title` _(string, required)_ — Example: `"Search John Doe"`
- `linkedinUrl` _(string, required)_

```json
{  
  "title":"Search John Doe",
  "linkedinUrl":"https://www.linkedin.com/in/john-doe"
}
```

## People Search by Filters

**Rate limit (shown):**
- **25 API calls per minute**

**Body (application/json):**
- `title` _(string, required)_ - Example: `"Search John Doe"`
- `name` _(string[])` - Example: `"John Doe"`
- `job_title` _(string[])` - Example: `"Software Engineer"`
- `seniority` _(string[])` - Example: `"Senior"`
- `skills` _(string[])` - Example: `"React"`
- `degree` _(string[])` - Example: `"Master of Business Administration"`
- `institution` _(string[])` - Example: `"Harvard University"`
- `location` _(string[])` - Example: `"New York, NY"`
- `company` _(string[])` - Example: `"Google"`
- `industry` _(string[])` - Example: `"Technology"`
- `min_years_of_experience` _(number)_ - Example: `1`
- `max_years_of_experience` _(number)_ - Example: `10`
- `is_decision_maker` _(boolean)_ - Example: `false`
- `page` _(number, required, default: 1)_ - Example: `2`

```json
{
  "title":"Search John Doe",
  "job_title":["Software Engineer"],
  "seniority":["Senior"],
  "skills":["React"],
  "location":["New York, NY"],
  "industry":["Technology"],
  "min_years_of_experience":1,
  "max_years_of_experience":10,
  "is_decision_maker":false,
  "page":2
}
```

// response
- `message` (string) - Example: "Success"  
- `metadata` (object)  
  - `currentPage` (number) - Example: 1  
  - `hasNext` (boolean) - Example: true  
  - `lastPage` (number)  
  - `nextPage` (number) - Example: 2  
  - `perPage` (number) - Example: 10  
  - `prevPage` (number) - Example: 1  
  - `total` (number) - Example: 100  
- `people` (object[])  
  - `status` (string) - Example: "failed"  
  - `error` (boolean) - Example: true  
  - `errors` (object[])  
    - `code` (string) - Example: "DATA-EMPTY"  
    - `message` (string) - Example: "The data is empty"

# Need targeted lists for outreach?

Build lead search API lists using job title, seniority, skills, location, and company filters.

[Try filter search](https://app.redrob.io/)

# Frequently Asked Questions

**What should I use for the “title” field?**  
**What’s the difference between LinkedIn URL vs LinkedIn URLs?**  
**How do I authenticate requests?**  
**How does pagination work in filter search?**  
**What does the “DATA-EMPTY” error mean?**

Your B2B Lead Generation Solution!  
Find verified business emails and enrich  
company data effortlessly.