← APIs / Prospect Research
Verified

Prospect Research

Apiosk Basicsby Apiosk Basics · General

One company lookup an AI sales agent can buy instantly: name in, standardized firmographics out (employees, country, website, LinkedIn, industry).

dataapi
Price per request
$0.17
About

Prospect Research turns a company name (or domain) into a single, structured record an agent can act on. It merges two live sources — the company's own website (homepage title and description) and People Data Labs Company Enrichment (employee count, size band, country, industry, founding year, LinkedIn URL, summary and tags) — into one JSON response. Built for the thousands of AI sales agents that research companies, qualify leads and build prospect lists: one paid call returns reliable, structured, agent-ready data instead of scraping or guessing. Stateless POST metered per call via x402; the caller authenticates by payment (X-Payment header) and needs no API key of its own.

Base URL
https://gateway.apiosk.com/prospect-research
Technical Specs
Auth Methodx402
Response FormatJSON
Endpoints4
Endpoints
MethodPathDescriptionCost
POST / Research a company by name (or domain) and return a standardized firmographics record merged from the company website and People Data Labs.
$0.17 default
View details
POST /company-enrichment Enrich a single company from PeopleDataLabs. Provide a name, website, LinkedIn profile or ticker and get firmographics back (employee count, industry, location, founded, tags, etc.).
$0.15 default
View details
POST /person-enrichment Enrich a single person from PeopleDataLabs. Provide any combination of identifiers (email, phone, LinkedIn profile, or name + company) and get a full professional profile back.
$0.15 default
View details
POST /person-search Search the PeopleDataLabs person dataset with SQL or an Elasticsearch query and get a list of matching people. `size` is capped at 25 (default 10) since PDL bills one credit per record returned.
$0.20 default
View details
Endpoint documentation
POST/
$0.17 default
Description

Research a company by name (or domain) and return a standardized firmographics record merged from the company website and People Data Labs.

Pricing
$0.17 default
Request schema
{
  "anyOf": [
    {
      "required": [
        "company"
      ]
    },
    {
      "required": [
        "domain"
      ]
    },
    {
      "required": [
        "website"
      ]
    }
  ],
  "description": "Provide a company name and/or a domain/website (at least one).",
  "properties": {
    "company": {
      "description": "Company name, e.g. \"Mollie\". A bare domain (\"mollie.com\") is also accepted.",
      "type": "string"
    },
    "domain": {
      "description": "Explicit domain, e.g. \"mollie.com\". Takes precedence over website.",
      "type": "string"
    },
    "website": {
      "description": "Explicit website URL, e.g. \"https://www.mollie.com\".",
      "type": "string"
    }
  },
  "type": "object"
}
Response schema
{
  "properties": {
    "country": {
      "type": [
        "string",
        "null"
      ]
    },
    "description": {
      "type": [
        "string",
        "null"
      ]
    },
    "employees": {
      "description": "Estimated employee count",
      "type": [
        "integer",
        "null"
      ]
    },
    "founded": {
      "description": "Founding year",
      "type": [
        "integer",
        "null"
      ]
    },
    "industry": {
      "type": [
        "string",
        "null"
      ]
    },
    "linkedin": {
      "type": [
        "string",
        "null"
      ]
    },
    "location": {
      "properties": {
        "country": {
          "type": [
            "string",
            "null"
          ]
        },
        "locality": {
          "type": [
            "string",
            "null"
          ]
        },
        "region": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "type": [
        "object",
        "null"
      ]
    },
    "name": {
      "type": [
        "string",
        "null"
      ]
    },
    "query": {
      "properties": {
        "company": {
          "type": [
            "string",
            "null"
          ]
        },
        "domain": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "type": "object"
    },
    "size": {
      "description": "Employee size band, e.g. 501-1000",
      "type": [
        "string",
        "null"
      ]
    },
    "sources": {
      "description": "Per-source provenance for the website scrape and the People Data Labs match.",
      "properties": {
        "peopledatalabs": {
          "type": "object"
        },
        "website": {
          "type": "object"
        }
      },
      "type": "object"
    },
    "tags": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "website": {
      "type": [
        "string",
        "null"
      ]
    }
  },
  "type": "object"
}
Example request
{
  "company": "Mollie"
}
Example response
{
  "country": "netherlands",
  "description": "Start growing your business with Mollie Payments, for online and in-person payments.",
  "employees": 998,
  "founded": 2004,
  "industry": "financial services",
  "linkedin": "linkedin.com/company/mollie",
  "location": {
    "country": "netherlands",
    "locality": "amsterdam",
    "region": "north holland"
  },
  "name": "Mollie",
  "query": {
    "company": "Mollie",
    "domain": "mollie.com"
  },
  "size": "501-1000",
  "sources": {
    "peopledatalabs": {
      "id": "2WNhA53nWJBVAHCTOCSy1Qt5zf6U",
      "matched": true,
      "status": 200
    },
    "website": {
      "description": "Start growing your business with Mollie Payments.",
      "fetched": true,
      "finalUrl": "https://www.mollie.com/",
      "status": 200,
      "title": "Mollie – Online and in-person payments built for businesses of every size",
      "url": "https://mollie.com"
    }
  },
  "tags": [
    "online payments",
    "ideal",
    "paypal",
    "mastercard",
    "visa"
  ],
  "website": "https://mollie.com"
}
POST/company-enrichment
$0.15 default
Description

Enrich a single company from PeopleDataLabs. Provide a name, website, LinkedIn profile or ticker and get firmographics back (employee count, industry, location, founded, tags, etc.).

Pricing
$0.15 default
Request schema
{
  "anyOf": [
    {
      "required": [
        "name"
      ]
    },
    {
      "required": [
        "website"
      ]
    },
    {
      "required": [
        "profile"
      ]
    },
    {
      "required": [
        "ticker"
      ]
    }
  ],
  "description": "At least one identifier required.",
  "properties": {
    "location": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "profile": {
      "description": "LinkedIn company URL",
      "type": "string"
    },
    "ticker": {
      "type": "string"
    },
    "website": {
      "type": "string"
    }
  },
  "type": "object"
}
Response schema
{
  "properties": {
    "employee_count": {
      "type": "integer"
    },
    "founded": {
      "type": "integer"
    },
    "industry": {
      "type": "string"
    },
    "linkedin_url": {
      "type": "string"
    },
    "location": {
      "type": "object"
    },
    "name": {
      "type": "string"
    },
    "status": {
      "type": "integer"
    },
    "website": {
      "type": "string"
    }
  },
  "type": "object"
}
Example request
{
  "website": "mollie.com"
}
Example response
{
  "employee_count": 998,
  "founded": 2004,
  "industry": "financial services",
  "linkedin_url": "linkedin.com/company/mollie",
  "location": {
    "country": "netherlands",
    "locality": "amsterdam"
  },
  "name": "mollie",
  "status": 200,
  "website": "mollie.com"
}
POST/person-enrichment
$0.15 default
Description

Enrich a single person from PeopleDataLabs. Provide any combination of identifiers (email, phone, LinkedIn profile, or name + company) and get a full professional profile back.

Pricing
$0.15 default
Request schema
{
  "anyOf": [
    {
      "required": [
        "email"
      ]
    },
    {
      "required": [
        "phone"
      ]
    },
    {
      "required": [
        "profile"
      ]
    },
    {
      "required": [
        "first_name",
        "last_name"
      ]
    }
  ],
  "description": "At least one identifier required.",
  "properties": {
    "company": {
      "type": "string"
    },
    "email": {
      "type": "string"
    },
    "first_name": {
      "type": "string"
    },
    "last_name": {
      "type": "string"
    },
    "location": {
      "type": "string"
    },
    "min_likelihood": {
      "description": "1-10; reject matches below this confidence",
      "type": "integer"
    },
    "name": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "profile": {
      "description": "LinkedIn URL, e.g. linkedin.com/in/seanthorne",
      "type": "string"
    }
  },
  "type": "object"
}
Response schema
{
  "properties": {
    "data": {
      "description": "PeopleDataLabs person record: full_name, job_title, job_company_name, linkedin_url, location_name, emails, etc.",
      "type": "object"
    },
    "likelihood": {
      "type": "integer"
    },
    "status": {
      "type": "integer"
    }
  },
  "type": "object"
}
Example request
{
  "company": "people data labs",
  "first_name": "sean",
  "last_name": "thorne"
}
Example response
{
  "data": {
    "full_name": "sean thorne",
    "job_company_name": "people data labs",
    "job_title": "co-founder",
    "linkedin_url": "linkedin.com/in/seanthorne",
    "location_name": "san francisco, california, united states"
  },
  "likelihood": 9,
  "status": 200
}
POST/person-search
$0.20 default
Description

Search the PeopleDataLabs person dataset with SQL or an Elasticsearch query and get a list of matching people. `size` is capped at 25 (default 10) since PDL bills one credit per record returned.

Pricing
$0.20 default
Request schema
{
  "anyOf": [
    {
      "required": [
        "sql"
      ]
    },
    {
      "required": [
        "query"
      ]
    }
  ],
  "description": "Provide `sql` or `query`.",
  "properties": {
    "from": {
      "description": "Offset for pagination",
      "type": "integer"
    },
    "query": {
      "description": "Elasticsearch query DSL (alternative to sql)",
      "type": "object"
    },
    "size": {
      "description": "1-25, default 10",
      "type": "integer"
    },
    "sql": {
      "description": "e.g. SELECT * FROM person WHERE location_country='netherlands' AND job_title_role='engineering'",
      "type": "string"
    }
  },
  "type": "object"
}
Response schema
{
  "properties": {
    "data": {
      "items": {
        "type": "object"
      },
      "type": "array"
    },
    "scroll_token": {
      "type": "string"
    },
    "status": {
      "type": "integer"
    },
    "total": {
      "type": "integer"
    }
  },
  "type": "object"
}
Example request
{
  "size": 5,
  "sql": "SELECT * FROM person WHERE location_country='netherlands' AND job_title_role='engineering'"
}
Example response
{
  "data": [
    {
      "full_name": "nick jones",
      "job_company_name": "booking.com",
      "job_title": "applied science manager",
      "location_country": "netherlands"
    }
  ],
  "status": 200,
  "total": 313249
}