Company Enrichment

Get comprehensive firmographic data for any company

POST https://api.gtmapis.com/v1/company/enrich

Company Enrichment

cURL

curl --request POST \
  --url https://api.gtmapis.com/v1/company/enrich \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "domain": "<string>",
  "company_name": "<string>",
  "force_refresh": true
}
'

200

{
  "domain": "<string>",
  "company_name": "<string>",
  "display_name": "<string>",
  "description": "<string>",
  "website": "<string>",
  "employee_count": 123,
  "employee_range": "<string>",
  "revenue_range": "<string>",
  "industry": "<string>",
  "sub_industry": "<string>",
  "founded_year": 123,
  "company_type": "<string>",
  "location": {
    "city": "<string>",
    "region": "<string>",
    "country": "<string>",
    "country_code": "<string>"
  },
  "linkedin_url": "<string>",
  "twitter_url": "<string>",
  "facebook_url": "<string>",
  "phone": "<string>",
  "technologies": [
    {}
  ],
  "technology_count": 123,
  "funding": {
    "total_raised": 123,
    "last_round": "<string>",
    "last_round_date": "<string>"
  },
  "found": true,
  "cache_hit": true,
  "confidence": 123,
  "credits_charged": 123,
  "source_provider": "<string>",
  "latency_ms": 123
}

Company Enrichment

Enrich your account data with comprehensive company firmographics including employee count, revenue, industry, technologies, funding, and more.

Endpoint

POST /v1/company/enrich

Request

domain · string · required

Company domain to enrich (e.g., “acme.com”)

company_name · string

Company name hint to improve matching

force_refresh · boolean · default: "false"

Force fresh data (bypass cache)

Example Request

cURL

curl -X POST https://api.gtmapis.com/v1/company/enrich \
  -H "Content-Type: application/json" \
  -H "X-API-Key: gtm_test_your_key_here" \
  -d '{
    "domain": "acme.com"
  }'

Response

Core Information

domain · string

Company domain

company_name · string

Legal company name

display_name · string

Display/brand name

description · string

Company description

website · string

Primary website URL

Firmographics

employee_count · integer

Estimated employee count

employee_range · string

Employee range (e.g., “51-200”, “201-500”)

revenue_range · string

Revenue range (e.g., “$10M-$50M”)

industry · string

Primary industry

sub_industry · string

Sub-industry/vertical

founded_year · integer

Year company was founded

company_type · string

Type: private, public, nonprofit, government

Location

location · object

Show Location fields

city · string

City

region · string

State/Region

country · string

Country

country_code · string

Country code (US, GB)

Social & Contact

linkedin_url · string

LinkedIn company page URL

twitter_url · string

Twitter/X profile URL

facebook_url · string

Facebook page URL

phone · string

Main phone number

Technology

technologies · array

List of technologies used (detected from website)

technology_count · integer

Number of technologies detected

Funding

funding · object

Show Funding fields

total_raised · integer

Total funding raised (USD)

last_round · string

Last funding round type (Seed, Series A, etc.)

last_round_date · string

Date of last funding round

Meta

found · boolean

Whether company data was found

cache_hit · boolean

Whether result was served from cache

confidence · number

Confidence score (0-1)

credits_charged · integer

Credits charged for this request

source_provider · string

Data provider

latency_ms · integer

Request time in milliseconds

Success Response

{
  "domain": "acme.com",
  "company_name": "Acme Inc",
  "display_name": "Acme",
  "description": "Acme is a leading provider of enterprise software solutions...",
  "website": "https://acme.com",
  "employee_count": 350,
  "employee_range": "201-500",
  "revenue_range": "$50M-$100M",
  "industry": "Software",
  "sub_industry": "Enterprise Software",
  "founded_year": 2015,
  "company_type": "private",
  "location": {
    "city": "San Francisco",
    "region": "California",
    "country": "United States",
    "country_code": "US"
  },
  "linkedin_url": "https://linkedin.com/company/acme",
  "twitter_url": "https://twitter.com/acme",
  "facebook_url": "https://facebook.com/acme",
  "phone": "[phone]",
  "technologies": [
    "AWS",
    "React",
    "Node.js",
    "PostgreSQL",
    "Kubernetes",
    "Salesforce",
    "HubSpot"
  ],
  "technology_count": 7,
  "funding": {
    "total_raised": 45000000,
    "last_round": "Series B",
    "last_round_date": "2024-03-15"
  },
  "found": true,
  "cache_hit": false,
  "confidence": 0.95,
  "credits_charged": 1,
  "source_provider": "exa",
  "latency_ms": 1234
}

Not Found Response

{
  "domain": "unknown-company.com",
  "found": false,
  "cache_hit": false,
  "confidence": 0,
  "credits_charged": 0,
  "latency_ms": 234,
  "error": "Company not found"
}

Credit Pricing

Result	Credits Charged
Company found	1 credit
Not found	0 credits
Error / failure	0 credits

Company data is cached for 30 days. Cache hits are charged at the same rate to ensure you always get value.

Employee Ranges

Standard employee range values:

Range	Headcount
1-10	Startup
11-50	Small business
51-200	Mid-market
201-500	Growth stage
501-1000	Enterprise
1001-5000	Large enterprise
5001+	Major corporation

Error Responses

400 Bad Request

{
  "error": "Bad Request",
  "message": "domain is required"
}

401 Unauthorized

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

503 Service Unavailable

{
  "error": "Service Unavailable",
  "message": "company enrichment not configured"
}

Use Cases

Lead qualification

Score leads based on company size, industry, and funding stage.

Account-based marketing

Build targeted account lists based on firmographic criteria.

CRM enrichment

Automatically populate company fields in your CRM.

Competitive analysis

Monitor competitor growth, funding, and technology stack.

Technographic targeting

Find companies using specific technologies for relevant outreach.

Best Practices

Use domain over company name

Domains are unique identifiers; company names can be ambiguous.

Handle missing fields gracefully

Not all companies have complete data. Check for null/empty values.

Cache results locally

Data is cached for 30 days. Consider caching locally for frequently accessed companies.

Related Endpoints

Bulk Enrichment

Enrich multiple companies at once

Employee Search

Find employees at a company

LinkedIn Company

Get LinkedIn company data

Profile Enrichment

Enrich individual contacts