POST/api-company
Company details
Name, industry, size, revenue range, location and more for one company domain.
Request
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 field | Type | Required | Notes |
|---|---|---|---|
domain | string | Yes | The company's website. https://www.stripe.com/about is cleaned to stripe.com |
Found: 200, 1 credit
{
"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
{ "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
| Field | Meaning |
|---|---|
status | found or not_found |
company | The company, or null when not found. Any field inside can be null; employee_growth is often empty |
company.headcount_range | Text, for example "51-200" |
company.revenue_range | Estimated minimum and maximum revenue, each with amount, unit and currency |
company.location | Head office address, as an object |
domain_match | false 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 |
source | Where the data came from |
fetched_at | When the data was fetched |
cached | true when the answer came from a lookup in the last 30 days |
credits_charged | 1 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
| HTTP | error | When |
|---|---|---|
| 400 | invalid_input | Body isn't JSON, or domain is missing |
| 400 | invalid_domain | A page on another site (for example a LinkedIn or Facebook link), not a company website |
| 401 | unauthorized | Missing, wrong or revoked key |
| 402 | insufficient_credits | No credits left |
| 502 | provider_unavailable | The data source didn't answer. Nothing was charged; try again |