B2BEnrich API

Search

Endpointhttps://api.b2benrich.com

Search companies

POST

https://api.b2benrich.com

/v1/search/companies

Search for companies using structured filters. All filter fields are optional and combined with AND. Supports filtering by name, domain, industry, location, employee count, revenue, tech stack, funding, traffic, and more.

Search companies › Headers

X-Api-Key

string · required

Search companies › Request Body

Search for companies using any combination of filters. All fields are optional. Supply a single value or an array for any filter. Multiple values within a field are OR-matched; different fields are ANDed.

Company name(s). Single value or array for OR match.

Website domain(s) (e.g. 'google.com'). Single value or array for OR match.

Company specialties / keywords. Single value or array for OR match.

LinkedIn industry classification. Single value or array for OR match.

SIC industry code(s). Single value or array for OR match.

Headquarters city/cities. Single value or array for OR match.

Headquarters state/province(s). Single value or array for OR match.

Headquarters country name(s). Single value or array for OR match.

Headquarters country ISO code(s) (e.g. 'US'). Single value or array for OR match.

Headquarters region (e.g. 'North America'). Single value or array for OR match.

Headquarters continent. Single value or array for OR match.

Company entity type (e.g. 'Public', 'Private'). Single value or array for OR match.

Company legal type (e.g. 'LLC', 'Corporation'). Single value or array for OR match.

Employee count range (e.g. '51-200'). Single value or array for OR match.

Revenue range bracket. Single value or array for OR match.

Year founded. Single value or array for OR match.

CRM technology (e.g., 'Salesforce', 'HubSpot').

Marketing automation technology (e.g., 'Marketo').

ABM (Account-Based Marketing) technology.

Sales automation technology (e.g., 'Outreach').

Analytics technology (e.g., 'Google Analytics').

CMS technology (e.g., 'WordPress').

MarTech categories.

Conversation intelligence technology (e.g., 'Gong').

Cloud provider technology (e.g., 'AWS', 'Azure').

Email hosting technology (e.g., 'Google Workspace').

Email security technology.

Application security technology.

Cloud security technology.

Development technologies / languages.

E-commerce platform technology (e.g., 'Shopify').

ERP technology (e.g., 'SAP', 'Oracle').

Lead investor name(s).

Last funding round amount.

Total funding raised.

Marketing team headcount.

Sales team headcount.

Operations team headcount.

Business development team headcount.

Customer success team headcount.

IT team headcount.

Engineering team headcount.

Monthly organic website traffic.

Monthly paid website traffic.

Total monthly website traffic.

Monthly Google Ads spend.

Employee growth rate on LinkedIn.

page

integer · min: 1

Page number (1-indexed).

Default: 1

page_size

integer · min: 1 · max: 25

Results per page.

Default: 25

Search companies › Responses

Successful Response

object[] · required

Matching company records.

total_count

integer · required

Total matching records.

page

integer · required

Current page (1-indexed).

page_size

integer · required

Records per page.

has_more

boolean · required

True if more pages exist.

Next page number, or null.

POST/v1/search/companies

curl --request POST \
  --url https://api.b2benrich.com/v1/search/companies \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <string>' \
  --data '
{
  "company_name": "Google",
  "page": 1,
  "page_size": 10
}
'

shell

Example Request Body

{
  "company_name": "Google",
  "page": 1,
  "page_size": 10
}

json

application/json

Example Responses

{
  "records": [
    {
      "id": 0,
      "name": "string",
      "description": "string",
      "domain": "string",
      "industry": "string",
      "hq_city": "string",
      "hq_state": "string",
      "hq_country": "string",
      "employees_range": "string",
      "revenue_range": "string",
      "linkedin_url": "string"
    }
  ],
  "total_count": 0,
  "page": 0,
  "page_size": 0,
  "has_more": true,
  "next_page": 0
}

json

application/json

Prospector search

POST

https://api.b2benrich.com

/v1/search/prospector

Search across contacts, companies, and technology insights using any combination of filters. Supply contact filters (job title, location, skills, etc.) and/or company filters (industry, size, revenue, tech stack, funding, traffic) â€” only the relevant data sources are queried. Fields within each filter group are combined with AND.

Prospector search › Headers

X-Api-Key

string · required

Prospector search › Request Body

Search across contacts, companies, and technology insights. Supply any combination of filter groups â€” contact filters, company filters, and/or insights filters. Only relevant data is queried based on which filters you provide. Fields within each group are ANDed.

Free-text search across contact fields (name, title, skills, etc.).

Filter by contact attributes (name, title, location, etc.).

Filter by company attributes (name, industry, size, tech stack, funding, traffic, etc.).

page

integer · min: 1

Page number (1-indexed).

Default: 1

page_size

integer · min: 1 · max: 50

Results per page (max 25; admin keys may use up to 50).

Default: 25

Prospector search › Responses

Successful Response

object[] · required

Matching rows.

total_count

integer · required

Total matching records.

page

integer · required

Current page (1-indexed).

page_size

integer · required

Records per page.

has_more

boolean · required

True if more pages exist.

Next page number, or null.

POST/v1/search/prospector

curl --request POST \
  --url https://api.b2benrich.com/v1/search/prospector \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <string>' \
  --data '
{
  "contact_filters": {
    "job_title": "Software Engineer",
    "state_name": "California"
  },
  "company_filters": {
    "industry_linkedin": "Computer Software",
    "employee_count_range": "10001+"
  },
  "page": 1,
  "page_size": 25
}
'

shell

Example Request Body

{
  "contact_filters": {
    "job_title": "Software Engineer",
    "state_name": "California"
  },
  "company_filters": {
    "industry_linkedin": "Computer Software",
    "employee_count_range": "10001+"
  },
  "page": 1,
  "page_size": 25
}

json

application/json

Example Responses

{
  "records": [
    {
      "id": 0,
      "full_name": "string",
      "first_name": "string",
      "last_name": "string",
      "linkedin_url": "string",
      "profile_pic": "string",
      "job_title": "string",
      "company_name": "string",
      "company_domain": "string",
      "company_linkedin_url": "string",
      "company_id": 0,
      "city": "string",
      "state_code": "string",
      "state_name": "string",
      "country_code": "string",
      "country_name": "string",
      "country_region": "string"
    }
  ],
  "total_count": 0,
  "page": 0,
  "page_size": 0,
  "has_more": true,
  "next_page": 0
}

json

application/json

Prospector count

POST

https://api.b2benrich.com

/v1/search/prospector/count

Count total matching contacts using the same filters as /prospector. Returns only the total count â€” no records are fetched. Useful for previewing result set sizes before running a full search.

Prospector count › Headers

X-Api-Key

string · required

Prospector count › Request Body

Same filters as ProspectorSearchRequest but returns only the total count. No pagination â€” the endpoint counts all matching rows.

Free-text search across contact fields (name, title, skills, etc.).

Filter by contact attributes (name, title, location, etc.).

Filter by company attributes (name, industry, size, tech stack, funding, traffic, etc.).

Prospector count › Responses

Successful Response

total_count

integer · required

Total matching records.

POST/v1/search/prospector/count

curl --request POST \
  --url https://api.b2benrich.com/v1/search/prospector/count \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <string>' \
  --data '
{
  "contact_filters": {
    "job_title": "Software Engineer",
    "state_name": "California"
  },
  "company_filters": {
    "industry_linkedin": "Computer Software",
    "employee_count_range": "10001+"
  }
}
'

shell

Example Request Body

{
  "contact_filters": {
    "job_title": "Software Engineer",
    "state_name": "California"
  },
  "company_filters": {
    "industry_linkedin": "Computer Software",
    "employee_count_range": "10001+"
  }
}

json

application/json

Example Responses

{
  "total_count": 0
}

json

application/json

Find a contact by name and company domain

POST

https://api.b2benrich.com

/v1/search/first-last-domain

Look up a specific person by their first name, last name, and company domain. All three fields are required. Returns matching contact records with associated company data.

Find a contact by name and company domain › Headers

X-Api-Key

string · required

Find a contact by name and company domain › Request Body

Search by first name, last name, and company domain.

first_name

string · required

Contact first name.

last_name

string · required

Contact last name.

domain

string · required

Company domain (e.g. 'google.com').

page

integer · min: 1

Page number (1-indexed).

Default: 1

page_size

integer · min: 1 · max: 25

Results per page.

Default: 25

Find a contact by name and company domain › Responses

Successful Response

object[] · required

Matching person records.

total_count

integer · required

Total matching records.

page

integer · required

Current page (1-indexed).

page_size

integer · required

Records per page.

has_more

boolean · required

True if more pages exist.

Next page number, or null.

POST/v1/search/first-last-domain

curl --request POST \
  --url https://api.b2benrich.com/v1/search/first-last-domain \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <string>' \
  --data '
{
  "first_name": "John",
  "last_name": "Smith",
  "domain": "example.com"
}
'

shell

Example Request Body

{
  "first_name": "John",
  "last_name": "Smith",
  "domain": "example.com"
}

json

application/json

Example Responses

{
  "records": [
    {
      "id": 0,
      "full_name": "string",
      "first_name": "string",
      "last_name": "string",
      "linkedin_url": "string",
      "profile_pic": "string",
      "job_title": "string",
      "company_name": "string",
      "company_domain": "string",
      "company_linkedin_url": "string",
      "company_id": 0,
      "city": "string",
      "state_code": "string",
      "state_name": "string",
      "country_code": "string",
      "country_name": "string",
      "country_region": "string"
    }
  ],
  "total_count": 0,
  "page": 0,
  "page_size": 0,
  "has_more": true,
  "next_page": 0
}

json

application/json

Search by job title and company name

POST

https://api.b2benrich.com

/v1/search/title-company

Find contacts by job title and/or company name. At least one field is required. When both are provided, results are filtered to match both criteria.

Search by job title and company name › Headers

X-Api-Key

string · required

Search by job title and company name › Request Body

Search by job title and/or company name.

Job title to search for.

Company name to search for.

page

integer · min: 1

Page number (1-indexed).

Default: 1

page_size

integer · min: 1 · max: 25

Results per page.

Default: 25

Search by job title and company name › Responses

Successful Response

object[] · required

Matching rows.

total_count

integer · required

Total matching records.

page

integer · required

Current page (1-indexed).

page_size

integer · required

Records per page.

has_more

boolean · required

True if more pages exist.

Next page number, or null.

POST/v1/search/title-company

curl --request POST \
  --url https://api.b2benrich.com/v1/search/title-company \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <string>' \
  --data '
{
  "job_title": "Product Manager",
  "company_name": "Stripe",
  "page": 1,
  "page_size": 25
}
'

shell

Example Request Body

{
  "job_title": "Product Manager",
  "company_name": "Stripe",
  "page": 1,
  "page_size": 25
}

json

application/json

Example Responses

{
  "records": [
    {
      "id": 0,
      "full_name": "string",
      "first_name": "string",
      "last_name": "string",
      "linkedin_url": "string",
      "profile_pic": "string",
      "job_title": "string",
      "company_name": "string",
      "company_domain": "string",
      "company_linkedin_url": "string",
      "company_id": 0,
      "city": "string",
      "state_code": "string",
      "state_name": "string",
      "country_code": "string",
      "country_name": "string",
      "country_region": "string"
    }
  ],
  "total_count": 0,
  "page": 0,
  "page_size": 0,
  "has_more": true,
  "next_page": 0
}

json

application/json

Search employees at a company

POST

https://api.b2benrich.com

/v1/search/company-employees

Look up employees at a specific company by its ID, LinkedIn URL, or domain. At least one company identifier is required. Optionally filter employees by name, job title, function, level, or persona. Returns paginated contact records.

Search employees at a company › Headers

X-Api-Key

string · required

Search employees at a company › Request Body

Look up employees at a company. Provide at least one company identifier (id, linkedin_url, or domain). Optionally filter employees by name, title, function, level, or persona.

Organization ID.

Company LinkedIn URL (e.g. 'https://www.linkedin.com/company/google').

Company website domain (e.g. 'google.com').

First name(s). Single value or array for OR match.

Last name(s). Single value or array for OR match.

Job title(s). Single value or array for OR match.

Job function (e.g., 'Engineering', 'Sales'). Single value or array for OR match.

Job level (e.g., 'Director', 'VP'). Single value or array for OR match.

Persona classification. Single value or array for OR match.

City (e.g. 'San Francisco'). Single value or array for OR match.

State or province name (e.g. 'California'). Single value or array for OR match.

Country name (e.g. 'United States'). Single value or array for OR match.

page

integer · min: 1

Page number (1-indexed).

Default: 1

page_size

integer · min: 1 · max: 25

Results per page.

Default: 25

Search employees at a company › Responses

Successful Response

object[] · required

Employees at the matched company.

total_count

integer · required

Total matching employees.

page

integer · required

Current page (1-indexed).

page_size

integer · required

Records per page.

has_more

boolean · required

True if more pages exist.

Next page number, or null.

POST/v1/search/company-employees

curl --request POST \
  --url https://api.b2benrich.com/v1/search/company-employees \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <string>' \
  --data '
{
  "domain": "stripe.com",
  "page": 1,
  "page_size": 25
}
'

shell

Example Request Body

{
  "domain": "stripe.com",
  "page": 1,
  "page_size": 25
}

json

application/json

Example Responses

{
  "records": [
    {
      "id": 0,
      "full_name": "string",
      "first_name": "string",
      "last_name": "string",
      "linkedin_url": "string",
      "profile_pic": "string",
      "job_title": "string",
      "company_name": "string",
      "company_domain": "string",
      "company_linkedin_url": "string",
      "company_id": 0,
      "city": "string",
      "state_code": "string",
      "state_name": "string",
      "country_code": "string",
      "country_name": "string",
      "country_region": "string"
    }
  ],
  "total_count": 0,
  "page": 0,
  "page_size": 0,
  "has_more": true,
  "next_page": 0
}

json

application/json

Search companies by name (exact or fuzzy)

POST

https://api.b2benrich.com

/v1/search/company-name

Search organizations by company name. Use match_type='exact' for case-sensitive exact match (default), or match_type='fuzzy' for case-insensitive substring search.

Search companies by name (exact or fuzzy) › Headers

X-Api-Key

string · required

Search companies by name (exact or fuzzy) › Request Body

Search for organizations by company name.

company_name

string · required

Company name to search for.

match_type

string · enum

Match mode. 'exact' â€” case-sensitive exact match. 'fuzzy' â€” case-insensitive substring match (ILIKE %%query%%).

Enum values:

exact

fuzzy

Default: exact

page

integer · min: 1

Page number (1-indexed).

Default: 1

page_size

integer · min: 1 · max: 25

Results per page.

Default: 25

Search companies by name (exact or fuzzy) › Responses

Successful Response

object[]

total_count

integer

Total matching records.

Default: 0

page

integer

Current page (1-indexed).

Default: 1

page_size

integer

Records per page.

Default: 25

has_more

boolean

True if more pages exist.

Default: false

Next page number, or null.

POST/v1/search/company-name

curl --request POST \
  --url https://api.b2benrich.com/v1/search/company-name \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <string>' \
  --data '
{
  "company_name": "Abbvie",
  "match_type": "exact",
  "page": 1,
  "page_size": 10
}
'

shell

Example Request Body

{
  "company_name": "Abbvie",
  "match_type": "exact",
  "page": 1,
  "page_size": 10
}

json

application/json

Example Responses

{
  "records": [
    {
      "company": {
        "id": 0,
        "name": "string",
        "description": "string",
        "domain": "string",
        "industry": "string",
        "hq_city": "string",
        "hq_state": "string",
        "hq_country": "string",
        "employees_range": "string",
        "revenue_range": "string",
        "linkedin_url": "string"
      }
    }
  ],
  "total_count": 0,
  "page": 0,
  "page_size": 0,
  "has_more": true,
  "next_page": 0
}

json

application/json

Search with AI (free-form text query)

POST

https://api.b2benrich.com

/v1/search/ai

Search using plain English. Describe the contacts or companies you're looking for and the system will interpret your query and return matching results. Supports the same data as the prospector endpoint â€” contacts, companies, and technology insights â€” but accepts free-form text instead of structured filters.

Search with AI (free-form text query) › Headers

X-Api-Key

string · required

Search with AI (free-form text query) › Request Body

Search using natural language. Describe the contacts or companies you're looking for in plain English. The system interprets your query and returns matching results.

query

string · minLength: 3 · maxLength: 2000 · required

Your search query in plain English.

Example: Find software engineers at Google in San Francisco

page

integer · min: 1

Page number (1-based).

Default: 1

page_size

integer · min: 1 · max: 100

Records per page.

Default: 25

Search with AI (free-form text query) › Responses

Successful Response

Response from the AI-powered search endpoint.

total_count

integer · required

Total matching records.

object

The equivalent Prospector API search object. You can submit this directly to /v1/search/prospector to reproduce the same search.

object[]

Matching rows.

page

integer

Current page number.

Default: 1

page_size

integer

Records per page.

Default: 25

has_more

boolean

Whether more pages are available.

Default: false

Next page number, or null.

POST/v1/search/ai

curl --request POST \
  --url https://api.b2benrich.com/v1/search/ai \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <string>' \
  --data '
{
  "query": "Find software engineers at Google in California"
}
'

shell

Example Request Body

{
  "query": "Find software engineers at Google in California"
}

json

application/json

Example Responses

{
  "prospector_search": {},
  "records": [
    {
      "id": 0,
      "full_name": "string",
      "first_name": "string",
      "last_name": "string",
      "linkedin_url": "string",
      "profile_pic": "string",
      "job_title": "string",
      "company_name": "string",
      "company_domain": "string",
      "company_linkedin_url": "string",
      "company_id": 0,
      "city": "string",
      "state_code": "string",
      "state_name": "string",
      "country_code": "string",
      "country_name": "string",
      "country_region": "string"
    }
  ],
  "total_count": 0,
  "page": 0,
  "page_size": 0,
  "has_more": true,
  "next_page": 0
}

json

application/json

Validation Field Meta