Skip to main content
POST
/
v1
/
enrichment
/
persons
/
search
Person Search
curl --request POST \
  --url https://api.scrapin.io/v1/enrichment/persons/search \
  --header 'Content-Type: application/json' \
  --data '{
  "firstName": "<string>",
  "lastName": "<string>",
  "headline": "<string>",
  "companyName": "<string>",
  "currentPositionTitle": "<string>",
  "locationCity": "<string>",
  "locationCountryCode": "<string>",
  "page": 1
}'
{
  "success": true,
  "credits_consumed": 0.1,
  "credits_left": 99.9,
  "rate_limit_left": 99,
  "daily_rate_limit_left": 999,
  "minute_rate_limit_left": 19,
  "next_minute_rate_limit_reset": "2024-10-31T12:46:00.000Z",
  "metadata": {
    "source": "fresh"
  },
  "pagination": {
    "currentPage": 1,
    "totalPages": 5,
    "totalResults": 98,
    "resultsPerPage": 20
  },
  "persons": [
    {
      "publicIdentifier": "johndoe",
      "linkedInUrl": "https://www.linkedin.com/in/johndoe",
      "firstName": "John",
      "lastName": "Doe",
      "headline": "Software Engineer at Google",
      "currentPositionTitle": "Senior Software Engineer",
      "currentCompanyName": "Google",
      "updateDate": "2025-10-02T00:00:00.000Z"
    },
    {
      "publicIdentifier": "janedoe",
      "linkedInUrl": "https://www.linkedin.com/in/janedoe",
      "firstName": "Jane",
      "lastName": "Doe",
      "headline": "Product Manager | Tech Enthusiast",
      "currentPositionTitle": "Senior Product Manager",
      "currentCompanyName": "Microsoft",
      "updateDate": "2025-09-15T00:00:00.000Z"
    }
  ]
}
Each search costs 0.10 credits per page (maximum 20 results per page). Perfect for bulk lead generation and talent sourcing.

​
Overview

Search for profiles in our DataLake using advanced filters. This endpoint allows you to find multiple profiles matching specific criteria from our existing database.
DataLake Search: This endpoint searches our existing database with historical data. Check the updateDate field in each result to see when the profile was last refreshed.

​
🚀 Need Fresh Data?

The search results include an updateDate field showing when each profile was last updated. If the data isn’t recent enough for your needs, you can get live, real-time data using our other endpoints:

Person Profile Data

Extract fresh profile data directly in real-time from the profile URL.

Person Profile Match

Extract fresh profile data directly in real-time from first name, last name, company, email.
Smart Workflow: Use Person Search to discover candidates, then check the updateDate. If the data is recent enough (e.g., within last 30 days), use it directly. If not, fetch fresh data using the profile endpoints for critical contacts.

​
Use Cases

Search for potential clients or partners based on job title and company:
{
  "currentPositionTitle": "CTO",
  "companyName": "Tech"
}
Find candidates with specific skills and location:
{
  "headline": "React Developer",
  "locationCity": "New York",
  "locationCountryCode": "US"
}
Identify professionals in specific industries:
{
  "currentPositionTitle": "Product Manager",
  "companyName": "Startup"
}
Find alumni or people in your network:
{
  "companyName": "Previous Company",
  "locationCity": "Your City"
}

​
Best Practices

​
Efficient Searching

  • Be specific: Use multiple filters to narrow down results and improve relevance
  • Monitor costs: Each page costs 0.10 credits (20 results per page). Accessing multiple pages will consume additional credits.
  • Check data freshness: Always review the updateDate field. For time-sensitive use cases, consider refreshing older profiles with live scraping.

​
Hybrid Approach: Search + Live Enrichment

Maximize efficiency and accuracy with this workflow:
  1. Search - Use this endpoint to find relevant profiles at 0.10 credits per page
  2. Filter - Review the updateDate to identify which profiles need refreshing
  3. Enrich - Use Person Profile Data or Person Match to get the freshest data for the profiles you need
Example Cost Comparison:
  • Search 100 profiles (5 pages): 0.50 credits
  • Live-scrape all 100 profiles: 100 credits 💸
  • Smart approach: Search 100 + refresh 10 most important: 0.50 + 10 = 10.50 credits ✅
This hybrid approach saves up to 90% on credits while maintaining data quality where it matters most!

​
Credit Consumption

Per Page

0.10 credits per page (maximum 20 results per page)
Cost-effective for finding multiple profiles. Each page costs 0.10 credits regardless of the number of results (up to 20). Use pagination wisely to manage your credit consumption.
Important: Fetching multiple pages will consume 0.10 credits per page. For example, accessing pages 1, 2, and 3 will cost 0.30 credits total (3 pages × 0.10 credits).

Authorizations

​
apikey
string
query
required

This required parameter is a string. It represents the APIKEY obtained from the developer dashboard. You must use it in the query string of your request as ?apikey=YOUR_API_KEY or in the headers as x-api-key: YOUR_API_KEY

Body

application/json
​
firstName
string

First name of the person (starts with matching). Optional but at least one filter must be provided.

​
lastName
string

Last name of the person (starts with matching). Optional but at least one filter must be provided.

​
headline
string

Headline (contains matching). Optional but at least one filter must be provided.

​
companyName
string

Current company name (starts with matching). Optional but at least one filter must be provided.

​
currentPositionTitle
string

Current job title (contains matching). Optional but at least one filter must be provided.

​
locationCity
string

City location (starts with matching). Optional but at least one filter must be provided.

​
locationCountryCode
string

Country code(s), comma-separated (e.g., 'US,GB,FR'). Optional but at least one filter must be provided.

​
page
integer
default:1

Page number for pagination (default: 1). Results are limited to 20 per page.

Response

The endpoint returns a list of persons matching the search criteria.

​
success
boolean

Indicates if the request was successful.

​
credits_consumed
number

Credits consumed by this request (always 0.1).

​
credits_left
number

Remaining credits in your account.

​
rate_limit_left
integer

Remaining API calls for the current period.

​
daily_rate_limit_left
integer

Remaining daily API calls.

​
minute_rate_limit_left
integer

Remaining API calls for the current minute.

​
next_minute_rate_limit_reset
string<date-time>

Timestamp when minute rate limit resets.

​
metadata
object
​
pagination
object
​
persons
object[]

Array of person results.