Skip to main content
POST
/
v1
/
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
}

Documentation Index

Fetch the complete documentation index at: https://docs.leadx.com/llms.txt

Use this file to discover all available pages before exploring further.

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). Accepts a single string or a list of strings. Each value is matched as a complete company name. To search for multiple companies, pass them as separate items in a list. Duplicate names are removed automatically.

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"

​
email
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. When specified, only the listed fields are returned per record. Accepts a single string or a list of strings. Comma-separated strings are split automatically. Duplicates are removed.

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 April 11, 2026