Platinux API

POST/api-company

Company details

Name, industry, size, revenue range, location and more for one company domain.

View as Markdown

Request

bash
curl -X POST "https://mmkuffhlzytnmgraagbp.supabase.co/functions/v1/api-company" \
  -H "Authorization: Bearer $PLATINUX_API_KEY" -H "Content-Type: application/json" \
  -d '{"domain": "stripe.com"}'
Body fieldTypeRequiredNotes
domainstringYesThe company's website. https://www.stripe.com/about is cleaned to stripe.com

Found: 200, 1 credit

json
{
  "status": "found",
  "domain": "stripe.com",
  "company": {
    "name": "Stripe",
    "website": "https://stripe.com",
    "description": "…",
    "slogan": "…",
    "industry": "Technology, Information and Internet",
    "specialties": [],
    "company_type": "Privately Held",
    "employee_count": 14127,
    "headcount_range": "5001-10000",
    "employee_growth": [],
    "revenue_range": {
      "estimatedMinRevenue": { "amount": 500, "unit": "MILLION", "currency": "USD" },
      "estimatedMaxRevenue": { "amount": 1, "unit": "BILLION", "currency": "USD" }
    },
    "founded_year": 2010,
    "location": {
      "streetAddress": "…", "addressLocality": "South San Francisco", "addressRegion": "California",
      "postalCode": "…", "addressCountry": "United States of America", "addressCountryCode": "US"
    },
    "phone": null,
    "logo_url": "https://…",
    "linkedin_url": "https://www.linkedin.com/company/stripe/",
    "linkedin_id": "stripe"
  },
  "domain_match": true,
  "source": "icypeas",
  "fetched_at": "2026-11-19T17:23:33Z",
  "cached": false,
  "credits_charged": 1
}

Found again within 30 days: 200, free

The same body with "cached": true and "credits_charged": 0.

Not found: 200, free

json
{ "status": "not_found", "domain": "nonexistent-xyz-123.com", "company": null, "domain_match": null,
  "source": "icypeas", "fetched_at": "2026-11-19T18:21:40Z", "cached": false, "credits_charged": 0 }

Fields

FieldMeaning
statusfound or not_found
companyThe company, or null when not found. Any field inside can be null; employee_growth is often empty
company.headcount_rangeText, for example "51-200"
company.revenue_rangeEstimated minimum and maximum revenue, each with amount, unit and currency
company.locationHead office address, as an object
domain_matchfalse when the company's listed website isn't exactly the domain you sent but the company matches (for example Google lists goo.gle). These matches are correct
sourceWhere the data came from
fetched_atWhen the data was fetched
cachedtrue when the answer came from a lookup in the last 30 days
credits_charged1 for a new company found, otherwise 0

Large brands may return a division: a domain shared by several company pages returns the page linked to that domain (for example amazon.com returns Amazon Web Services).

Errors

HTTPerrorWhen
400invalid_inputBody isn't JSON, or domain is missing
400invalid_domainA page on another site (for example a LinkedIn or Facebook link), not a company website
401unauthorizedMissing, wrong or revoked key
402insufficient_creditsNo credits left
502provider_unavailableThe data source didn't answer. Nothing was charged; try again