Skip to content
looot docs
Esc
↑↓navigate↵open⌘Jpreview
On this page

AI Ark / Search people by contact or company filters

AI Ark tool ai-ark-people on looot: input fields, $0.00539 per result, output shape, and code to run it with curl, JavaScript or Python.

Searches 400+ million enriched, verified and active person profiles using contact and/or account (company) filters, the starting point for building outbound lead lists. Each result contains the full person profile and their company data. Results do not include emails or phone numbers, enrich them with the endpoints listed under Related Endpoints below. Credit Usage: 0.5 credits per returned result (e.g. size: 25 with 25 matches = 12.5 credits). You only pay for results actually returned. Track ID: The response includes a trackId. Pass it to Find Emails by Track ID to get verified emails for this exact result set. The trackId can be used once and expires 6 hours after this response, submit it promptly. Contact Filters: Profile: Full Name, Social Media Link, LinkedIn, Location, Language Skills, Profile Badge, LinkedIn Follower & Connection Count Professional: Current & Past Company, Seniority, Department and Function, Experience (Current/Previous Title, Duration) Skills & Education: Skills, Certifications, Education (School, Degree, Field of Study, Date), Keywords, Social Media Account Filters: Company Identification: Name or Domain, Domain, LinkedIn, URL, Name, Social Media Link, Phone Number Company Details: Industry, Location, Products and Services, Social Media, Company Type, Founded Year, Operation Language, Geo Location Financial & Size: Employee Size, Annual Revenue, Funding Advanced Filters: Keywords, Employee by Department, Headcount Growth

Inputs

Name Type Required Description
account object no
contact object no
lists object no Reference up to <strong>10 lists per request</strong> (each list holds up to <strong>10,000 items</strong>) to <strong>exclude</strong> the matching people from your results.
page integer yes Required on People Search and Company Search (default 0). Zero-based page number. Use with size to paginate. The full result set is capped at 10,000 records per search, see the Lists pagination pattern above to go deeper. Example: 0
size integer yes Required on People Search and Company Search. Results per page: max 100. Default 10 on People Search / Company Search, 25 on Preview. On Export People with Email, size is the total export size, up to 10,000. Example: 10

Output

Shape of the run’s result, checked against 23 real answers:

{ last, size, sort: { empty, sorted, unsorted }, empty, first, number, content: ... ...

The shape is cut here. Signed in, looot inspect ai-ark-people prints all of it.

Run it

Every call needs your API token in LOOOT_TOKEN; Sign in shows how to get one. Each run also needs a new idempotency key, so a retry never pays twice. With wait: 30 the answer comes back inline when the run ends within 30 seconds. Otherwise you get the running run back: poll GET /v1/runs/<runId>.

Example input with placeholder values:

curl -X POST "https://api.looot.ai/v1/runs" \
  -H "Authorization: Bearer $LOOOT_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"endpointId":"ai-ark-people","input":{"page":0,"size":10,"account":{"domain":{"any":{"include":["example.com"]}}}},"wait":30}'
const response = await fetch("https://api.looot.ai/v1/runs", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.LOOOT_TOKEN}`,
    "Content-Type": "application/json",
    "Idempotency-Key": crypto.randomUUID(),
  },
  body: JSON.stringify({
    endpointId: "ai-ark-people",
    input: {
      page: 0,
      size: 10,
      account: {
        domain: {
          any: {
            include: ["example.com"],
          },
        },
      },
    },
    wait: 30,
  }),
});
const run = await response.json();
console.log(run.status, run.result);
import os
import uuid

import requests

response = requests.post(
    "https://api.looot.ai/v1/runs",
    headers={
        "Authorization": f"Bearer {os.environ['LOOOT_TOKEN']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "endpointId": "ai-ark-people",
        "input": {
            "page": 0,
            "size": 10,
            "account": {
                "domain": {
                    "any": {
                        "include": ["example.com"],
                    },
                },
            },
        },
        "wait": 30,
    },
    timeout=90,
)
run = response.json()
print(run["status"], run.get("result"))

To let looot pick among every provider of this job instead, send job:people.search as endpointId; see the job page.

Was this page helpful?