Home / Docs / Companies

Companies

Public read-only endpoints for companies and URL detection.

List Companies

GET /api/v1/companies/

Auth: None.

Returns non-deprecated companies, ordered by name.

Query parameters:

Parameter Type Description
stage string Filter by current_stage; use public for public companies
search string Search company name and description
page integer Page number
page_size integer Results per page, max 200

Response fields include: name, slug, description, current_stage, year_founded, public, url, blog_url, docs_url, github_url, twitter_url, and linkedin_url.

Get Company Detail

GET /api/v1/companies/<slug>/

Auth: None.

Returns details for a non-deprecated company.

Additional detail fields include: detail, changelog_url, jobs_url, youtube_url, discord_url, and slack_url.

Detect Company from URL

GET /api/v1/company/detect-from-url/

Auth: API key or logged-in browser session required.

Detects which company a website or blog URL belongs to.

Query parameters:

Parameter Type Description
url string Required. URL to match against known company URLs

Response:

{
  "company_slug": "example",
  "company_name": "Example Inc.",
  "matched_field": "blog_url",
  "matched_url": "https://example.com/blog",
  "confidence": "high"
}

Returns 404 Not Found if no matching company is found.

Official social identities

Company detail responses include read-only youtube_channels, x_accounts, and linkedin_accounts arrays. YouTube includes all channels, X includes company accounts, and LinkedIn includes company and showcase accounts. Paused accounts remain visible with is_active: false. Employee profiles and ingestion state are excluded. Each entry includes id, label, url, type, is_primary, and is_active, plus channel_id and slug for YouTube, username and x_user_id for X, or public_identifier and linkedin_entity_id for LinkedIn.

Existing scalar social URL fields remain read-only compatibility values. They select the active primary official identity, otherwise the sole active official identity. Multiple active identities without a primary produce null. If none are active, the sole inactive primary is selected, otherwise the sole inactive identity. Ambiguous inactive identities produce null. No identity produces null; identity collections are empty arrays.

Operators manage social identities through the dedicated Django admin editors. Company create/update payloads reject deprecated social fields, including null or empty values. Enrichment does not configure social identities.

Plushcap, by Matt Makai. 2021-2026.