New to Corsair? See API access, authentication, and error handling.
Account
get
account.get
Get the plan and API credit balance. Not billed.
Risk: read
data full type
data full type
metadata full type
metadata full type
Brands
get
brands.get
Get a brand profile by its Logo.dev brand id. 5 API credits.
Risk: read
Takes the
id from a lookup’s data.id.
Output
data full type
data full type
metadata full type
metadata full type
lookup
brands.lookup
Look up a brand profile (name, description, colors, socials, logo) by domain, ticker, ISIN, crypto symbol or name. 5 API credits.
Risk: read
Send exactly one of
domain, ticker, isin, crypto or name. On accounts with webhooks, a lookup also subscribes to the brand unless noSubscribe is true. A ready brand is saved to the brands table under its domain.
Output
data full type
data full type
metadata full type
metadata full type
search
brands.search
Search brands by name and get each match with its domain and logo URL. Billed at 1 API credit per 1,000 searches.
Risk: read
Returns
data (each match’s name, domain and logo URL) and metadata. The logo URL comes back without its token query.
Output
data full type
data full type
metadata full type
metadata full type
Logos
fetch
logos.fetch
Get a brand’s logo as a temporary download URL with its size, format and blurhash. 2 API credits.
Risk: read
Send exactly one identifier.
data.url is a temporary download URL that stops working at data.expires_at. With a domain, the logo’s format, size, etag and brand id are saved to the images table; the URL is not.
Output
data full type
data full type
metadata full type
metadata full type
getBrandmark
logos.getBrandmark
Get a brand’s brandmark (the symbol without the name) as a temporary download URL. 3 API credits.
Risk: read
Same input as
logos.fetch. Returns the symbol without the name.
Output
data full type
data full type
metadata full type
metadata full type
Subscriptions
get
subscriptions.get
Check whether the account follows a brand’s update events (paid plans).
Risk: read
Output
data full type
data full type
metadata full type
metadata full type
subscribe
subscriptions.subscribe
Follow a brand’s update events (paid plans with webhooks).
Risk: write
Safe to repeat: 200 when already subscribed, 201 when new.
409 means the plan’s subscription limit is reached.
Output
data full type
data full type
metadata full type
metadata full type
unsubscribe
subscriptions.unsubscribe
Stop following a brand’s update events.
Risk: write
Output
Webhook Endpoints
create
webhookEndpoints.create
Register a URL to receive brand.updated and brand.indexed events (paid plans).
Risk: write
filter_types takes brand.updated and brand.indexed; omit it for both. 409 means the plan’s endpoint limit is reached.
Output
data full type
data full type
metadata full type
metadata full type
delete
webhookEndpoints.delete
Delete a webhook endpoint. This cannot be undone.
Risk: destructive
Returns
{ id, deleted: true } after the API confirms with 204.
Output
get
webhookEndpoints.get
Get one webhook endpoint.
Risk: read
Output
data full type
data full type
metadata full type
metadata full type
list
webhookEndpoints.list
List the team’s webhook endpoints.
Risk: read
data full type
data full type
metadata full type
metadata full type
update
webhookEndpoints.update
Change a webhook endpoint’s URL, description, event types or disabled state.
Risk: write
Output
data full type
data full type
metadata full type
metadata full type