Skip to content
Company & B2B

Prospect Search

Find people by title, seniority, location and company, 25 per search.

POST/v1/prospect-search
2 credits / searchGlobal
Request
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"}'
Response
{
  "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>required

Your 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.

titlestringrequired

Job title. Example: Head of Revenue Operations

seniorityenum<string>required

Seniority. One of: any, c-suite, vp, director, manager, individual. Example: director

company_domainstring

Company domain. Example: northwind.example

freshboolean

Skip the 7-day cache and run a new lookup. Charged as a normal lookup.

referencestring

Your 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.

successboolean

true when the lookup ran.

data.people[].profile_idvalue

An identifier for the person that enrichment products accept as input.

data.people[].full_namevalue

The person's full name.

data.people[].titlevalue

Their current job title.

data.people[].seniorityvalue

The level the title maps to, matching the seniority filter values.

data.people[].company.namevalue

The current employer, with its domain in the same object.

data.people[].locationvalue

Where the person is based.

data.result_countnumber

How many people the search returned, up to 25.

meta.credits_usednumber

Credits charged for this call.

meta.credits_remainingnumber

Your balance after the call.

meta.cachedboolean

true when the result came from the 7-day cache.

meta.request_idstring

Quote 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.

HTTPCodeMeaning
401unauthorizedThe key is missing, malformed or revoked.
402insufficient_creditsYour credits are used up and pay as you go is off or at its limit.
422invalid_inputA field is missing or malformed. The field property names it.
429rate_limitedToo many requests for this key. Wait for the Retry-After interval.
500internal_errorSomething failed on our side. Safe to retry.
503source_unavailableAn 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