Companies
Endpoints for listing and detecting companies.
Companies
List Companies
GET /api/companies-list/
Auth: read_only or full_access
Returns a paginated list of companies.
Query parameters:
| Parameter | Type | Default | Description |
|---|---|---|---|
has_sitemaps |
string | - | Filter by sitemap existence (true/false) |
include_deprecated |
string | false |
Include deprecated companies |
limit |
integer | 100 | Results per page (max 500) |
offset |
integer | 0 | Pagination offset |
Response:
{
"total_count": 250,
"limit": 100,
"offset": 0,
"results": [
{
"slug": "example",
"name": "Example Inc.",
"url": "https://example.com",
"stage": "series-b",
"founding_year": 2018,
"sitemap_count": 3
}
]
}
Get Company Detail
GET /api/company/<company_slug>/
Auth: read_only or full_access
Returns details for a single company, or 404 if not found.
Detect Company from URL
GET /api/company/detect-from-url/
Auth: read_only or full_access
Detect which company a blog post URL belongs to.
Query parameters:
| Parameter | Type | Description |
|---|---|---|
url |
string | Required. The blog post URL to match. |
Response:
{
"company": {
"slug": "example",
"name": "Example Inc."
},
"confidence": "high",
"matched_field": "blog_url"
}
confidence values: high, medium, low
matched_field values: blog_url, blog_all_posts_url, url
Returns 404 if no matching company is found.