Prospect Search
Find people by title, seniority, location and company, 25 per search.
curl -X POST https://api.1lookup.dev/v1/prospect-search \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"title":"Head of Revenue Operations","seniority":"director"}'{
"success": true,
"data": {
"filters": {
"title": "Head of Revenue Operations",
"seniority": "director",
"location": null,
"company_domain": null
},
"result_count": 3,
"people": [
{
"profile_id": "prs_8f2k1m9x",
"full_name": "Jordan Avery",
"title": "Director of Revenue Operations",
"seniority": "director",
"company": {
"name": "Northwind Logistics",
"domain": "northwind.example"
},
"location": "Austin, TX, US"
},
{
"profile_id": "prs_3c7d5q2w",
"full_name": "Priya Raman",
"title": "Head of Revenue Operations",
"seniority": "director",
"company": {
"name": "Fabrikam Health",
"domain": "fabrikam.example"
},
"location": "Denver, CO, US"
},
{
"profile_id": "prs_6n4t8b1z",
"full_name": "Marcus Bell",
"title": "Director, Revenue Operations",
"seniority": "director",
"company": {
"name": "Contoso Roasters",
"domain": "contoso.example"
},
"location": "Seattle, WA, US"
}
]
},
"meta": {
"credits_used": 2,
"credits_remaining": 999,
"cached": false,
"request_id": "req_8f3a2c1e9b7d"
}
}Authorization
Authorizationstring<bearer>requiredYour API key as a Bearer token. Live keys start with 1lk_live_. Test keys start with 1lk_test_ and return this endpoint's sample response without spending credits. See authentication.
Body
Send the fields as a JSON object with Content-Type: application/json.
titlestringrequiredJob title. Example: Head of Revenue Operations
seniorityenum<string>requiredSeniority. One of: any, c-suite, vp, director, manager, individual. Example: director
company_domainstringCompany domain. Example: northwind.example
freshbooleanSkip the 7-day cache and run a new lookup. Charged as a normal lookup.
referencestringYour own identifier, echoed back in meta and shown in lookup history.
Response
A 200 response carries the result in data and the cost of the call in meta. These are the fields most integrations read.
successbooleantrue when the lookup ran.
data.people[].profile_idvalueAn identifier for the person that enrichment products accept as input.
data.people[].full_namevalueThe person's full name.
data.people[].titlevalueTheir current job title.
data.people[].seniorityvalueThe level the title maps to, matching the seniority filter values.
data.people[].company.namevalueThe current employer, with its domain in the same object.
data.people[].locationvalueWhere the person is based.
data.result_countnumberHow many people the search returned, up to 25.
meta.credits_usednumberCredits charged for this call.
meta.credits_remainingnumberYour balance after the call.
meta.cachedbooleantrue when the result came from the 7-day cache.
meta.request_idstringQuote this when you contact support.
Errors
A failed request returns success: false with an error object, and is never charged. The full list is on the errors page.
| HTTP | Code | Meaning |
|---|---|---|
| 401 | unauthorized | The key is missing, malformed or revoked. |
| 402 | insufficient_credits | Your credits are used up and pay as you go is off or at its limit. |
| 422 | invalid_input | A field is missing or malformed. The field property names it. |
| 429 | rate_limited | Too many requests for this key. Wait for the Retry-After interval. |
| 500 | internal_error | Something failed on our side. Safe to retry. |
| 503 | source_unavailable | An upstream source did not answer in time. Safe to retry. |
Billing
2 credits / search. Charged when the lookup runs and returns a result. Errors are never charged, and repeating the same input within 7 days is served from cache at no charge.
Product overview and use cases