Skip to navigation

Get a Company's Names, Logos, Links, and Tags

View as Markdown

Returns a short, cached summary of one company, looked up by exactly one of url, slug, or entityId: brand and legal names, logos, the primary website and social profile URLs, and current classification tags. url accepts any current URL joined to the company (website, LinkedIn, X/Twitter, Crunchbase, GitHub, and other profiles) or its aVenture page; scheme, a leading www, and case are ignored, while distinct paths stay distinct. 404 when nothing owns the identifier; 409 with candidate ids when a URL is owned by more than one company. A signed-in user’s read charges one brand view per distinct company per UTC month against the monthly brand view allowance, then as additional usage when the subscriber enabled it; a repeat read of the same company in the month is free, as is a read of a company whose full profile view is already charged that month, a later full profile view of the company that month reverses its brand view charge, and an exhausted cap answers 429 with Retry-After.

Authentication

AuthorizationBearer

Your aVenture API key (https://aventure.vc/settings/api-keys) or OAuth access token

Query parameters

urlstringOptional
Any current URL joined to the company, e.g. stripe.com.
slugstringOptionalformat: "^[a-z0-9_-]+$"<=255 characters
Exact aVenture entity slug, e.g. stripe.
entityIdstringOptionalformat: "uuid"
Exact entity UUID.

Response headers

X-RateLimit-LimitintegerOptional

Requests allowed per client IP in the current rate-limit window.

X-RateLimit-RemainingintegerOptional

Requests left before the tightest applicable rate-limit bucket rejects.

X-RateLimit-ResetintegerOptional

Seconds until the exhausted rate-limit bucket admits another request; 0 when none is exhausted.

Response

OK
classificationobject
Current classification tags, industries, and standardized classifications.
coreobject

Core identity: id, slug, nameBrand, nameLegal, nameAlias, type, status, and image (logo, logoSquare, isMonogram).

publicUrlstring or nullOptional
Absolute canonical aVenture page URL, when the entity has one.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
406
Not Acceptable Error
409
Conflict Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error