People Search

Apollo

Search people by company, role and location with masked contact details.

Capability: People discovery
Current price: $0.0050/call
Availability: Ready to run

What this API does

Search one page of up to 100 people by company domain, employee range, job title, seniority and location. Returns Apollo person IDs, first names, masked surnames, roles and available company information. Email and phone details are not revealed. Each successful call, including an empty page, costs $0.005. Pages are requested separately and the result window ends at page 500.

Agents select this operation with tool ID apollo.people-search, then check its current inputs and price before a run.

Inputs and outputs

Input

company_domainsarray · optional

Value supplied for company domains.

minItems: 1 · maxItems: 20

company_locationsarray · optional

Value supplied for company locations.

minItems: 1 · maxItems: 20

employee_rangesarray · optional

Value supplied for employee ranges.

minItems: 1 · maxItems: 10

limitinteger · optional

Value supplied for limit.

minimum: 1 · maximum: 100

locationsarray · optional

Value supplied for locations.

minItems: 1 · maxItems: 20

pageinteger · optional

Value supplied for page.

minimum: 1 · maximum: 500

senioritiesarray · optional

Value supplied for seniorities.

minItems: 1 · maxItems: 11

titlesarray · optional

Value supplied for titles.

minItems: 1 · maxItems: 20

Output

limitnumber

Returned limit value.

next_pagenumber

Returned next page value.

pagenumber

Returned page value.

resultsarray

Returned results value.

returned_resultsnumber

Returned returned results value.

total_entriesnumber

Returned total entries value.

Example request and output

Inspect returns this reviewed example, its estimated cost and the current input schema. Run calculates the estimate for your actual input.

Request

{
  "tool_id": "apollo.people-search",
  "input": {
    "limit": 1,
    "company_domains": [
      "apple.com"
    ]
  }
}

Output

{
  "page": 1,
  "limit": 1,
  "results": [
    {
      "id": "54a2eb6874686938250efd46",
      "title": "Editor in Chief",
      "company": {
        "name": "Apple"
      },
      "has_email": true,
      "first_name": "Philip",
      "last_name_obfuscated": "El***t"
    }
  ],
  "next_page": 2,
  "total_entries": 146878,
  "returned_results": 1
}

Errors and limitations

invalid_input: The lookup fields or limits are invalid.example: {"company_domains":["apple.com"],"limit":1}
upstream_error: The data provider could not complete a verified result; the wallet was not charged.Check the input and contact Scrollport support with the run ID if the problem persists.

Use People Search with Scrollport

Get started

Use verified tools with pay-per-use pricing. Provider access is included. Tools that work in your own apps ask you to connect that account.

Connect your first agent to receive $1 trial credit.