Schemas

Natural language query - AI assistant will select appropriate filters for you. Note: Use this only on the first request, then use the filters parameter for subsequent requests

Structured search filters to narrow company results

Page number for pagination

Optional webhook URL to receive results asynchronously. If not provided, results will be returned in the response body.

Filter by company name

Filter by country (ISO 3166-1 alpha-2 codes)

Filter by city name

Filter by state or province name

Filter by industry classification

Filter by company size range (e.g., 1-10, 11-50, 51-200)

Filter by company type (e.g., private, public)

Filter by keywords associated with companies

Filter by founding year or year range

Filter by technologies used by the company

Filter by similarity to a reference domain

Filter by estimated annual revenue range

Filter by Standard Industrial Classification (SIC) code

Filter by North American Industry Classification System (NAICS) code

Values to include in the filter

Values to exclude from the filter

Values to include in the filter

Values to exclude from the filter

Indicates if the request was successful

Search results containing matched companies

Response metadata including pagination and applied filters

Optional message

Total number of companies found

Current page number

Number of results per page

Total number of pages

Applied filters for the search

Array of company results

Total number of companies found

Current page number

Number of results per page

Total number of pages

Company name

Company description

Country where the company is located

State/province where the company is located

City where the company is located

Street address of the company

Postal/ZIP code

Industry sector

Number of employees

Company type (e.g., Private, Public)

Year the company was founded

Company website URL

Total number of email addresses found for this company

Annual revenue range

Indicates if a phone number is available

LinkedIn company page URL

Facebook company page URL

Twitter company page URL

Instagram company page URL

GitHub company page URL

YouTube company page URL

Pinterest company page URL

TikTok company page URL

Number of similar companies found

Account details and subscription information

Domain search results containing organization info and email addresses

Pagination and query metadata

Email finder result data

URL of the web page where the email was found

Root domain of the source website

Date when the email was first extracted from this source

Date when the email was last seen on this source

Whether the email is still present on the source page

Date when the email was last verified

Verification result

Whether the phone number is valid

Phone number in local format

Phone number in international format

Phone number in E.164 format

Phone number in RFC 3966 URI format

ISO country code for the phone number

Phone line type (mobile, landline, voip)

Telecommunications carrier name

Geographic region of the phone number

Timezones associated with the phone number

Email verification result data

Person's name details

Primary email address

Geographic location description

IANA timezone identifier (e.g., America/New_York)

UTC offset in hours

Geographical coordinates and location details

Short biography or professional summary

Personal website URL

Profile image URL

Current employment information

Facebook profile information

GitHub profile information

Twitter/X profile information

LinkedIn profile information

Gravatar profile information

Whether the result is a fuzzy (approximate) match

Whether the email domain is an email service provider

Timestamp when the person's data was last indexed

Phone number associated with the person

Timestamp when the person was last known to be active

Timestamp when the person was detected as inactive

Unique company identifier

Company name

Registered legal name of the company

Primary domain name of the company

Alternative domain names owned by the company

Company website information

Industry classification details

Descriptive tags associated with the company

Brief description of the company and its activities

Year the company was founded

Headquarters location as a formatted string

IANA timezone of the company's headquarters

UTC offset in hours for the headquarters location

Geographical coordinates and detailed address

URL to the company logo image

Facebook page information

LinkedIn company page information

Twitter/X account information

Crunchbase profile information

Whether the company is an email service provider

Company type (e.g., private, public, nonprofit, education)

Stock exchange ticker symbol

Business identification numbers

Company's primary phone number

Company size and traffic metrics

Timestamp when the company data was last indexed

Technologies and tools used by the company

Categories of technologies used (e.g., analytics, cms, hosting)

Parent company information

Ultimate parent company in the corporate hierarchy

Person enrichment data matching the query

Company enrichment data for the person's employer

Email count statistics for the domain

Array of location entries with email counts

The email address for which sources were retrieved

Array of web sources where the email was discovered

Array of email format patterns used by the domain

Array of similar companies

The domain that was analyzed

Array of technologies detected on the domain

Phone finder results (single object or array of results)

Unique identifier for the lead

Lead's email address

Lead's first name

Lead's last name

Company the lead is associated with

Lead's job title or position

Custom attributes assigned to this lead

Unique identifier for the attribute

Name of the custom attribute

Value of the custom attribute

Unique identifier for the list

Name of the lead list

Description of the lead list

Array of leads belonging to this list

Unique identifier for the API key

The API key value

Timestamp when the API key was created

Number of API requests made in the current period

Maximum number of requests allowed in the period

Timestamp when the usage counter resets

Unique identifier for the log entry

API endpoint that was called

HTTP method used (GET, POST, PUT, DELETE)

HTTP response status code

Timestamp when the request was made

Success response details

Error details for the failed request.

Name of the bulk operation

List of items to process (domains, emails, etc.)

Include sources in results

Send notifications

Enable verification

Total number of items

CSV delimiter character

Valid flag

Column number for processing

New name for the bulk operation

Maximum results per domain

Type of emails to search for

Department filter

First name column number

Last name column number

Full name column number

Domain column number (required)

Skip first row (header)

Phone number column

Country column

Unique identifier for the bulk operation

Name of the bulk operation

Maximum results setting

Email type filter

Department filter

Sources included

Generated filename

Total results

Total items in list

Completion status

Chart data

Table data

Creation timestamp

User ID who created the bulk

Whether the bulk has been launched

Whether results have been downloaded

Time tracking information

Progress percentage

Verification enabled

Verification cost

Total emails found

Number of items processed

Expiration timestamp

Whether the bulk has expired

Type of bulk operation

Current status

Progress percentage

Number of items processed

Total number of items

Items per page

Current page number

Total number of pages

Created resource ID

Operation status

Status message

HTTP status code

Error type

Error message

HTTP status code

Array of suggested domain objects

The company or organization name associated with the domain

The primary domain name of the suggested company

The number of email addresses available for this domain

The original search query used to generate suggestions

The maximum number of suggestions returned in this response

Total number of suggestions found (may be more than returned due to limit)

Country filter applied to the search

Industry filter applied to the search

Minimum email count filter applied

Time taken to process the request in milliseconds

Single result or array of results

Email address found

Indicates if a phone number is available

Confidence score of the result

Email verification status

Sources where the email was found

Company website URL

Whether the domain accepts all emails

First name of the person

Last name of the person

Full name of the person

Country of the person

Gender of the person

Common email pattern used by the organization (e.g., {first}.{last})

Department the person belongs to

Email type: personal or generic

Job position/title

Twitter handle

LinkedIn profile URL

Whether the email is from a disposable domain

Whether the email is from a webmail provider

Company name

Phone numbers associated with this person (when enrich_mobile=true)

Author and article metadata extracted from content sources

Source URI

Website URL of the source

Date when the email was first extracted

Date when the email was last seen

Whether the email is still present on the page

Date of verification

Verification status

Author finder result data

URL of the article or page

Page or article title

Open Graph image URL

Page or article description

Domain where the article was found

Publisher name of the article source

Date when the article was published

Author candidates extracted from the article

Type of data being flagged

The flagged item (email address, domain, phone number, URL)

Reason for flagging. Valid reasons depend on flag_type: email(hard_bounce,invalid_email,wrong_person,outdated,other), organization(wrong_company,outdated,other), phone(wrong_phone,outdated,other), author_url(broken_url,wrong_person,outdated,other), website(broken_url,wrong_company,outdated,other)

Optional additional details about the issue

Unique flag identifier

Type of data that was flagged

The flagged item

Reason for flagging

Additional details provided by the reporter

Current status of the flag

Number of credits refunded (for confirmed hard bounces)

When the flag was resolved by an admin

When the flag was created

Array of flag reports