Fetch company details

curl --request POST \
  --url https://api.example.com/v1/companies \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "url": [
    "https://www.example.com",
    "https://information.org"
  ],
  "company_id": [
    "8Q43UQ592MXFWAZ6ZNGJQP",
    "IWNJWMZPAMJH9FJRACSTAT"
  ],
  "phone": "123-456-7890",
  "company_name": [
    "Acme Inc",
    "Global Logistics LLC"
  ],
  "address": "123 Main St, Springfield, IL 62701",
  "city": "Springfield",
  "state": "CA",
  "zip_code": "90210",
  "near_zip_code": "92656",
  "radius": 25,
  "radius_unit": "mi",
  "county": "Los Angeles County",
  "country": "United States",
  "timezone": "Central",
  "region": "Northeast",
  "eight_digit_sic_code": "58120000",
  "eight_digit_sic_description": "Eating places",
  "four_digit_sic_code": "5812",
  "four_digit_sic_description": "Eating places",
  "two_digit_sic_code": "58",
  "two_digit_sic_description": "Eating and Drinking Places",
  "naics_code": "722513",
  "naics_description": "Limited-Service Restaurants",
  "industry": "Financial Services",
  "keywords": "coffee, bakery",
  "email": "info@company.com",
  "number_employees": "25",
  "annual_revenue": "5000000",
  "time_in_business": "3",
  "linkedin_url": "https://www.linkedin.com/company/example",
  "facebook_url": "https://www.facebook.com/example",
  "twitter_url": "https://www.twitter.com/example",
  "instagram_url": "https://www.instagram.com/example",
  "crunchbase_url": "https://www.crunchbase.com/company/example",
  "bbb_url": "https://www.bbb.org/company/example",
  "number_locations": "5",
  "financing_partners": "Wells Fargo",
  "include_fields": [
    "company_id",
    "company_name",
    "url"
  ],
  "page": 1,
  "per_page": 50
}
'

{
  "success": true,
  "records": [
    {
      "about_link": "https://localcafe.com/about",
      "address": "456 Main Street",
      "address_full": "456 Main Street, Hometown, TX, 75001, United States",
      "addresses_all": [
        {
          "address": "456 Main Street",
          "city": "Hometown",
          "county": "Commerce County",
          "region": "South",
          "state": "TX",
          "zip_code": "75001",
          "zip_lat": 32.7767,
          "zip_long": -96.797
        }
      ],
      "city": "Hometown",
      "city_state_country": "Hometown, TX, United States",
      "classification": "Vendor",
      "company_id": "LOCALCAFE67890",
      "company_name": "Local Cafe",
      "competitors_lookalikes": "Coffee Spot: coffeespot.com (0.100), Brewed Bliss: brewedbliss.com (0.150)",
      "contact_link": "https://localcafe.com/contact",
      "country": "United States",
      "county": "Commerce County",
      "do_you_offer_financing": false,
      "eight_digit_sic_code": "58120000",
      "eight_digit_sic_description": "Bars and lounges",
      "estimated_number_employees": 5,
      "estimated_number_employees_bin": "0-10",
      "facebook_url": "facebook.com/LocalCafe",
      "financing_partners": [],
      "four_digit_sic_code": "5812",
      "four_digit_sic_description": "Eating places",
      "generic_emails": [],
      "industry": "Restaurants",
      "instagram_url": "instagram.com/localcafe",
      "invalid_website": false,
      "keywords": [
        "coffee",
        "local cafe",
        "community",
        "fresh pastries",
        "artisan drinks"
      ],
      "linkedin_description": "Local Cafe is a cozy spot serving freshly brewed coffee and homemade pastries in the heart of Hometown.",
      "linkedin_follower_count": 50,
      "linkedin_url": "linkedin.com/company/localcafe",
      "logo_url": "https://localcafe.com/logo.png",
      "manufacturer": false,
      "menu_navigation": "Home, Menu, About, Contact",
      "naics_code": "722513",
      "naics_description": "Limited-Service Restaurants",
      "name_based_emails": [],
      "number_of_locations": 1,
      "phone": [
        "9725556789"
      ],
      "prediction_probability": 0.4004004895687103,
      "region": "South",
      "state": "TX",
      "state_name": "Texas",
      "technology_names": "Android, Bing Ads, Gmail, Google Analytics, Google Apps, Google Font API, Google Tag Manager, Mobile Friendly, Remote, Shutterstock, WordPress.org, reCAPTCHA",
      "time_in_business": 7,
      "time_in_business_bin": "5-10 Years",
      "timezone": "Central",
      "twitter_url": "twitter.com/LocalCafe",
      "two_digit_sic_code": "58",
      "two_digit_sic_description": "Eating and Drinking Places",
      "url": "localcafe.com",
      "zip_code": "75001",
      "zip_lat": 32.7767,
      "zip_lat_long": [
        32.7767,
        -96.797
      ],
      "zip_long": -96.797
    }
  ],
  "total_records": 1
}

Companies

Fetch company details

Returns enriched company-level data based on the input of a company name, URL, phone number, or address. URL and phone lookups typically complete in under 1,000 milliseconds. Searches using only the company name may return multiple results.

At least one of url, phone, company_name, or address must be provided. The url and phone parameters use exact matching, while company_name and address use fuzzy matching.

The response includes a records array of matching companies, each with detailed fields. The total_records field specifies the number of matches returned. The set of fields included in the response may vary depending on the data available. See the Field References section of the documentation for a breakdown of each field returned in the response.

POST

companies

Fetch company details

curl --request POST \
  --url https://api.example.com/v1/companies \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "url": [
    "https://www.example.com",
    "https://information.org"
  ],
  "company_id": [
    "8Q43UQ592MXFWAZ6ZNGJQP",
    "IWNJWMZPAMJH9FJRACSTAT"
  ],
  "phone": "123-456-7890",
  "company_name": [
    "Acme Inc",
    "Global Logistics LLC"
  ],
  "address": "123 Main St, Springfield, IL 62701",
  "city": "Springfield",
  "state": "CA",
  "zip_code": "90210",
  "near_zip_code": "92656",
  "radius": 25,
  "radius_unit": "mi",
  "county": "Los Angeles County",
  "country": "United States",
  "timezone": "Central",
  "region": "Northeast",
  "eight_digit_sic_code": "58120000",
  "eight_digit_sic_description": "Eating places",
  "four_digit_sic_code": "5812",
  "four_digit_sic_description": "Eating places",
  "two_digit_sic_code": "58",
  "two_digit_sic_description": "Eating and Drinking Places",
  "naics_code": "722513",
  "naics_description": "Limited-Service Restaurants",
  "industry": "Financial Services",
  "keywords": "coffee, bakery",
  "email": "info@company.com",
  "number_employees": "25",
  "annual_revenue": "5000000",
  "time_in_business": "3",
  "linkedin_url": "https://www.linkedin.com/company/example",
  "facebook_url": "https://www.facebook.com/example",
  "twitter_url": "https://www.twitter.com/example",
  "instagram_url": "https://www.instagram.com/example",
  "crunchbase_url": "https://www.crunchbase.com/company/example",
  "bbb_url": "https://www.bbb.org/company/example",
  "number_locations": "5",
  "financing_partners": "Wells Fargo",
  "include_fields": [
    "company_id",
    "company_name",
    "url"
  ],
  "page": 1,
  "per_page": 50
}
'

{
  "success": true,
  "records": [
    {
      "about_link": "https://localcafe.com/about",
      "address": "456 Main Street",
      "address_full": "456 Main Street, Hometown, TX, 75001, United States",
      "addresses_all": [
        {
          "address": "456 Main Street",
          "city": "Hometown",
          "county": "Commerce County",
          "region": "South",
          "state": "TX",
          "zip_code": "75001",
          "zip_lat": 32.7767,
          "zip_long": -96.797
        }
      ],
      "city": "Hometown",
      "city_state_country": "Hometown, TX, United States",
      "classification": "Vendor",
      "company_id": "LOCALCAFE67890",
      "company_name": "Local Cafe",
      "competitors_lookalikes": "Coffee Spot: coffeespot.com (0.100), Brewed Bliss: brewedbliss.com (0.150)",
      "contact_link": "https://localcafe.com/contact",
      "country": "United States",
      "county": "Commerce County",
      "do_you_offer_financing": false,
      "eight_digit_sic_code": "58120000",
      "eight_digit_sic_description": "Bars and lounges",
      "estimated_number_employees": 5,
      "estimated_number_employees_bin": "0-10",
      "facebook_url": "facebook.com/LocalCafe",
      "financing_partners": [],
      "four_digit_sic_code": "5812",
      "four_digit_sic_description": "Eating places",
      "generic_emails": [],
      "industry": "Restaurants",
      "instagram_url": "instagram.com/localcafe",
      "invalid_website": false,
      "keywords": [
        "coffee",
        "local cafe",
        "community",
        "fresh pastries",
        "artisan drinks"
      ],
      "linkedin_description": "Local Cafe is a cozy spot serving freshly brewed coffee and homemade pastries in the heart of Hometown.",
      "linkedin_follower_count": 50,
      "linkedin_url": "linkedin.com/company/localcafe",
      "logo_url": "https://localcafe.com/logo.png",
      "manufacturer": false,
      "menu_navigation": "Home, Menu, About, Contact",
      "naics_code": "722513",
      "naics_description": "Limited-Service Restaurants",
      "name_based_emails": [],
      "number_of_locations": 1,
      "phone": [
        "9725556789"
      ],
      "prediction_probability": 0.4004004895687103,
      "region": "South",
      "state": "TX",
      "state_name": "Texas",
      "technology_names": "Android, Bing Ads, Gmail, Google Analytics, Google Apps, Google Font API, Google Tag Manager, Mobile Friendly, Remote, Shutterstock, WordPress.org, reCAPTCHA",
      "time_in_business": 7,
      "time_in_business_bin": "5-10 Years",
      "timezone": "Central",
      "twitter_url": "twitter.com/LocalCafe",
      "two_digit_sic_code": "58",
      "two_digit_sic_description": "Eating and Drinking Places",
      "url": "localcafe.com",
      "zip_code": "75001",
      "zip_lat": 32.7767,
      "zip_lat_long": [
        32.7767,
        -96.797
      ],
      "zip_long": -96.797
    }
  ],
  "total_records": 1
}

Authorizations

X-API-Key

string

header

required

Body

application/json

url

Company URL (may include or omit the http/https prefix)

Example:

[
  "https://www.example.com",
  "https://information.org"
]

company_id

Include specific company IDs in the search results

Example:

[
  "8Q43UQ592MXFWAZ6ZNGJQP",
  "IWNJWMZPAMJH9FJRACSTAT"
]

phone

Company phone (may include or omit the dashes)

Example:

"123-456-7890"

company_name

Company name(s)

Example:

["Acme Inc", "Global Logistics LLC"]

address

string | null

Company address

Example:

"123 Main St, Springfield, IL 62701"

city

string | null

City to filter by

Example:

"Springfield"

state

State to filter by (two-letter abbreviation)

Example:

"CA"

zip_code

ZIP code to filter by

Example:

"90210"

near_zip_code

ZIP code to search around (anchor). Use with radius/radius_unit.

Example:

"92656"

radius

number | null

Radius distance for geo search around near_zip_code.

Required range: x > 0

Example:

25

radius_unit

enum<string>

default:mi

Units for radius (mi or km).

Available options:

mi,

km

Example:

"mi"

county

string | null

County to filter by

Example:

"Los Angeles County"

country

string | null

Country to filter by

Example:

"United States"

timezone

string | null

Timezone to filter by

Example:

"Central"

region

string | null

Region to filter by

Example:

"Northeast"

eight_digit_sic_code

string | null

Eight-digit SIC code to filter by

Example:

"58120000"

eight_digit_sic_description

string | null

Eight-digit SIC description to filter by

Example:

"Eating places"

four_digit_sic_code

string | null

Four-digit SIC code to filter by

Example:

"5812"

four_digit_sic_description

string | null

Four-digit SIC description to filter by

Example:

"Eating places"

two_digit_sic_code

string | null

Two-digit SIC code to filter by

Example:

"58"

two_digit_sic_description

string | null

Two-digit SIC description to filter by

Example:

"Eating and Drinking Places"

naics_code

string | null

NAICS code to filter by

Example:

"722513"

naics_description

string | null

NAICS description to filter by

Example:

"Limited-Service Restaurants"

industry

string | null

Industry to filter by

Example:

"Financial Services"

keywords

string | null

Keywords to filter by (comma-separated)

Example:

"coffee, bakery"

string | null

Company email address to filter by

Example:

"info@company.com"

number_employees

string | null

Number of employees to filter by

Example:

"25"

annual_revenue

string | null

Annual revenue to filter by

Example:

"5000000"

time_in_business

string | null

Time in business to filter by

Example:

"3"

linkedin_url

string | null

LinkedIn URL to filter by

Example:

"https://www.linkedin.com/company/example"

facebook_url

string | null

Facebook URL to filter by

Example:

"https://www.facebook.com/example"

twitter_url

string | null

Twitter URL to filter by

Example:

"https://www.twitter.com/example"

instagram_url

string | null

Instagram URL to filter by

Example:

"https://www.instagram.com/example"

crunchbase_url

string | null

Crunchbase URL to filter by

Example:

"https://www.crunchbase.com/company/example"

bbb_url

string | null

BBB URL to filter by

Example:

"https://www.bbb.org/company/example"

number_locations

string | null

Number of locations to filter by

Example:

"5"

financing_partners

string | null

Financing partners to filter by

Example:

"Wells Fargo"

include_fields

Field or list of fields to include in each record in the response

Example:

["company_id", "company_name", "url"]

page

integer

default:1

Page number of results to return. Must be greater than or equal to 1.

Required range: x >= 1

Example:

1

per_page

integer

default:50

Number of results per page. Maximum is 50.

Required range: x <= 50

Example:

50

Response

Successful Response

Last modified on March 23, 2026

Fetch Better Business Bureau details Fetch company details

⌘I