Skip to main content
POST
/
v1
/
company
/
enrich
Company Enrichment
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
}
'
{
  "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
}

Documentation Index

Fetch the complete documentation index at: https://gtmapis.mintlify.app/llms.txt

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

​
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 -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−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

​
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

​
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": "+1-415-555-1234",
  "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

ResultCredits Charged
Company found1 credit
Not found0 credits
Error / failure0 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:
RangeHeadcount
1-10Startup
11-50Small business
51-200Mid-market
201-500Growth stage
501-1000Enterprise
1001-5000Large 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

Score leads based on company size, industry, and funding stage.
Build targeted account lists based on firmographic criteria.
Automatically populate company fields in your CRM.
Monitor competitor growth, funding, and technology stack.
Find companies using specific technologies for relevant outreach.

​
Best Practices

Domains are unique identifiers; company names can be ambiguous.
Not all companies have complete data. Check for null/empty values.
Data is cached for 30 days. Consider caching locally for frequently accessed companies.

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