Company Search

Search for companies by industry, size, location, and technology

POST /v1/company/search

Company Search

cURL

curl --request POST \
  --url https://api.gtmapis.com/v1/company/search \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "company": {
    "keywords": [
      {}
    ],
    "industry": [
      {}
    ],
    "hq": [
      {}
    ],
    "employee_range": [
      {}
    ],
    "revenue_range": [
      {}
    ],
    "technologies": [
      {}
    ]
  },
  "max_results": 123,
  "cursor": "<string>"
}
'

200

{
  "companies": [
    {
      "linkedin_url": "<string>",
      "name": "<string>",
      "domain": "<string>",
      "industry": "<string>",
      "description": "<string>",
      "employee_count": 123,
      "employee_range": "<string>",
      "hq_city": "<string>",
      "hq_country": "<string>",
      "website": "<string>"
    }
  ],
  "cursor": "<string>",
  "total_results": 123,
  "credits_charged": 123
}

Company Search

Search for companies matching firmographic criteria including industry, headquarters location, employee range, revenue range, and technologies used. Supports cursor-based pagination.

Endpoint

POST /v1/company/search

Request

company · object · required

Company filter criteria

Show Filter fields

keywords · array

Keywords to match in company name or description

industry · array

Industry filters (e.g., [“Software”, “Financial Services”])

hq · array

Headquarters location (e.g., [“United States”, “San Francisco”])

employee_range · array

Employee count ranges (e.g., [“51-200”, “201-500”])

revenue_range · array

Revenue ranges (e.g., [“$10M-$50M”, “$50M-$100M”])

technologies · array

Technologies used (e.g., [“Salesforce”, “HubSpot”, “AWS”])

max_results · integer

Maximum number of results to return

cursor · string

Pagination cursor from a previous response

Example Request

cURL

curl -X POST https://api.gtmapis.com/v1/company/search \
  -H "Content-Type: application/json" \
  -H "X-API-Key: gtm_test_your_key_here" \
  -d '{
    "company": {
      "industry": ["Software"],
      "hq": ["United States"],
      "employee_range": ["51-200", "201-500"],
      "technologies": ["Salesforce"]
    },
    "max_results": 10
  }'

Response

companies · array

Array of matching company records

Show Company fields

linkedin_url · string

LinkedIn company page URL

name · string

Company name

domain · string

Company domain

industry · string

Primary industry

description · string

Company description

employee_count · integer

Employee count

employee_range · string

Employee range

hq_city · string

HQ city

hq_country · string

HQ country

website · string

Company website

cursor · string

Pagination cursor for the next page of results

total_results · integer

Number of results returned

credits_charged · integer

Total credits charged

Success Response

{
  "companies": [
    {
      "linkedin_url": "https://linkedin.com/company/acme",
      "name": "Acme Inc",
      "domain": "acme.com",
      "industry": "Software",
      "description": "Enterprise software for sales teams",
      "employee_count": 180,
      "employee_range": "51-200",
      "hq_city": "San Francisco",
      "hq_country": "United States",
      "website": "https://acme.com"
    }
  ],
  "cursor": "eyJwYWdlIjoy...",
  "total_results": 1,
  "credits_charged": 1
}

Credit Pricing

Result	Credits Charged
Per company returned	1 credit
No results	0 credits
Error / failure	0 credits

Error Responses

400 Bad Request

{
  "error": "Bad Request",
  "message": "invalid request body"
}

401 Unauthorized

{
  "error": "Unauthorized",
  "message": "Invalid API key"
}

Use Cases

Total addressable market (TAM)

Build your TAM by searching for companies matching your ICP firmographic criteria.

Technographic targeting

Find companies using a competitor’s product or a complementary technology.

Territory planning

Filter by HQ location to build territory-specific account lists.

Related Endpoints

ICP Search

Find people at a specific company

Employee Search

Search employees at a company

Company Enrich

Enrich a company by LinkedIn URL

Domain to LinkedIn

Find company LinkedIn from domain

LinkedIn to Domain

Find company domain from LinkedIn