Company APIs

Use the API playground at https://api.salesintel.io to test the API request and response patterns.

Retrieve companies matching filter parameters

GET https://api.salesintel.io/service/company

You can also use this endpoint to append information to identified companies, using the company_domain or companyname parameter to specify the company. Company domain is preferred matching approach to retrieve specific companies, as it is inherently standardized. If domain is unavailable, company name can be used, but you should attempt some normalization of your entries, particularly by removing suffixes like inc, corp, co, llc, etc, to ensure the best match rate.

The response set is paginated, with up to 50 records per page. You are charged credits based on the number of records on the pages accessed. If you only retrieve the first page of results out of 10, at a page size of 50, you will be charged for 50 records. The page size is adjustable below 50, but not greater than 50. Regardless of page size, you can only paginate 10,000 records deep in any given results set.

Query Parameters

Name
Type
Description

company_domain

String

Comma-separated list of domains

company_industries

String

Obsolete

company_location_states

String

Comma-separated list of state/region abbreviations (ISO standards)

company_location_zipcodes

String

Comma-separated list of ZIP/postal codes

company_location_zipcodes_distance

Long

Radius (in miles) from provided ZIP codes (US only)

company_max_revenue

Integer

Maximum annual revenue (in millions)

company_max_size

Integer

Maximum company employee size

company_min_revenue

Integer

Minimum annual revenue (in millions)

company_min_size

Integer

Minimum company employee size

company_naics_codes

String

Comma-separated list of NAICS codes

company_name

String

Comma-separated list of names; names are not case-sensitive and are matched using "contains"

company_sic_codes

String

Comma-separated list of SIC codes

is_international

Boolean

Company is located in the US (false) or outside of the US (true). Without this parameter, you may return multiples of the same organization based in different countries

location_country_codes

String

Comma-separated list of ISO alpha-2 country codes

specialties

String

Comma-separated list of keywords that describe a company

tech_category

String

tech_subcategory

String

tech_product

String

tech_vendor

String

verified

Boolean

Company details are human verified (true) or machine verified (false). Without this parameter, you may return multiples of the same organization

page

Integer

Page number

page_size

Integer

If not specified, the default page size is 50 records

sort_by

String

Sort field, either company_name or company_location

sort_direction

String

Sort direction, either asc or desc

Headers

Name
Type
Description

X-CB-ApiKey*

{your API key}

Accept*

String

application/json

Response

200: OK

To see the full response, use the playground at https://api.salesintel.io

Be sure to review the is_international and verified params to ensure that the companies returned meet your needs

Response Model
{
  "aggregations": {},
  "batch_id": {},
  "error": "string",
  "is_preview": true,
  "page": 0,
  "page_size": 0,
  "result_count": 0,
  "search_results": [
    {
      "_score": {},
      "addresses": [
        {
          "city": "string",
          "country": "string",
          "is_hq": true,
          "location_id": 0,
          "state": "string",
          "street_1": "string",
          "street_2": "string",
          "type": "string",
          "zip": "string"
        }
      ],
      "cds_batch_id": {},
      "company": {
        "actual_revenue": 0,
        "domains": [
          "string"
        ],
        "id": 0,
        "linkedin_url": "string",
        "naics_codes": [
          "string"
        ],
        "name": "string",
        "predicted_revenue": 0,
        "revenue": 0,
        "revenue_range": "string",
        "sic_codes": [
          "string"
        ],
        "size": 0,
        "size_range": "string"
      },
      "company_actual_revenue": 0,
      "company_domains": [
        "string"
      ],
      "company_id": 0,
      "company_name": "string",
      "company_predicted_revenue": 0,
      "company_revenue": 0,
      "company_revenue_range": "string",
      "company_score": {},
      "company_size": 0,
      "company_size_range": "string",
      "company_status": {},
      "dates": {
        "created_date": "string",
        "last_modified_date": "string"
      },
      "display_name": "string",
      "doc_id": "string",
      "email": "string",
      "email_hash": "string",
      "firmographic": {},
      "first_name": "string",
      "industry": "string",
      "intent": {},
      "is_executive": true,
      "is_international": true,
      "job_department": "string",
      "job_level": "string",
      "job_title": "string",
      "last_name": "string",
      "linkedin_url": {},
      "location": "string",
      "location_type": {},
      "locations": {},
      "logo_url": {},
      "match_id": "string",
      "naics_code": "string",
      "other_emails": [
        "string"
      ],
      "person_id": 0,
      "personal_addresses": [
        {
          "city": "string",
          "country": "string",
          "is_hq": true,
          "location_id": 0,
          "state": "string",
          "street_1": "string",
          "street_2": "string",
          "type": "string",
          "zip": "string"
        }
      ],
      "personal_email": "string",
      "personal_email_hash": "string",
      "phone_numbers": [
        {
          "country_code": "string",
          "hash": "string",
          "type": "string",
          "value": "string"
        }
      ],
      "position_location_hashid": "string",
      "position_location_id": 0,
      "prefix": "string",
      "primary_country": {},
      "primary_domain": {},
      "primary_name": {},
      "relations": {},
      "revenue_range": "string",
      "sector": "string",
      "sic_code": "string",
      "size_range": "string",
      "social_profiles": [
        {
          "type": "string",
          "url": "string"
        }
      ],
      "specialties": {},
      "status_reason": {},
      "suffix": "string",
      "tags": {},
      "technographics": {},
      "tier": 0,
      "tier_counts": {},
      "topics": [
        {
          "category": "string",
          "topic_id": 0,
          "topic_name": "string"
        }
      ],
      "verified": true
    }
  ],
  "sort_by": "string",
  "sort_direction": "string",
  "took": 0,
  "total_count": 0,
  "tracking_id": "string"
}

Last updated