Skip to main content
GET
/
v1
/
companies
/
{company_identifier}
Lookup Company Profile
curl --request GET \
  --url https://api.extruct.ai/v1/companies/{company_identifier} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "domain": "<string>",
  "company_name": "<string>",
  "context": {
    "company_name": "<string>",
    "domain": "<string>",
    "short_description": "<string>",
    "full_description": "<string>",
    "products_services": "<string>",
    "use_cases": "<string>",
    "target_audience": "<string>",
    "domains": [
      "<string>"
    ],
    "founding_year": 123,
    "hq_country": "<string>",
    "hq_state_province": "<string>",
    "hq_city": "<string>",
    "hq_full_address": "<string>",
    "other_considerations": "<string>",
    "social_profiles": {
      "linkedin": "<string>",
      "twitter": "<string>",
      "github": "<string>",
      "crunchbase": "<string>",
      "facebook": "<string>",
      "instagram": "<string>",
      "youtube": "<string>"
    },
    "sources": [
      "<string>"
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.extruct.ai/llms.txt

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

​
Overview

Company Lookup returns the canonical enriched Extruct profile for one known company. Pass a company domain or UUID. Use this endpoint when you already know the company and want its full profile context. Use Semantic Search to discover companies by category or market, and Lookalike Search to find similar companies.

​
Example request

export EXTRUCT_API_TOKEN="YOUR_API_TOKEN"

curl "https://api.extruct.ai/v1/companies/stripe.com" \
  -H "Authorization: Bearer ${EXTRUCT_API_TOKEN}"

​
Key parameters

  • company_identifier (required): Company domain or UUID.

​
Endpoint behavior

  • Domain inputs resolve through the company profile lookup path.
  • UUID inputs fetch that specific company profile.
  • If a valid domain is not ready yet, Extruct may start enrichment and return 202 Accepted.
  • Company Lookup currently consumes 0 credits. Successful lookups and accepted 202 lookups still appear in usage analytics.

​
Success signal

A successful response returns id, domain, company_name, and context. The context object is the rich company profile with descriptions, products, use cases, audience, firmographics, social profiles, and sources when available.

​
Common errors

​
401 Unauthorized

Check that your header is Authorization: Bearer ${EXTRUCT_API_TOKEN}.

​
202 Accepted

Company information is being enriched. Retry the same lookup later.

​
404 Not Found

The company profile is not available, or the identifier is invalid.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
company_identifier
string
required

Company UUID or domain.

Response

Successful Response

Full company profile lookup response.

​
id
string
required
​
domain
string
required
​
company_name
string | null
required
​
context
CompanyProfileContext · object
required

Complete company profile context