Skip to main content
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
Input: empty object Output

Brands

get

brands.get Get a brand profile by its Logo.dev brand id. 5 API credits. Risk: read
Input Takes the id from a lookup’s data.id. Output

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
Input 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

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
Input Returns data (each match’s name, domain and logo URL) and metadata. The logo URL comes back without its token query. Output

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
Input 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

getBrandmark

logos.getBrandmark Get a brand’s brandmark (the symbol without the name) as a temporary download URL. 3 API credits. Risk: read
Input Same input as logos.fetch. Returns the symbol without the name. Output

Subscriptions

get

subscriptions.get Check whether the account follows a brand’s update events (paid plans). Risk: read
Input Output

subscribe

subscriptions.subscribe Follow a brand’s update events (paid plans with webhooks). Risk: write
Input Safe to repeat: 200 when already subscribed, 201 when new. 409 means the plan’s subscription limit is reached. Output

unsubscribe

subscriptions.unsubscribe Stop following a brand’s update events. Risk: write
Input Output

Webhook Endpoints

create

webhookEndpoints.create Register a URL to receive brand.updated and brand.indexed events (paid plans). Risk: write
Input filter_types takes brand.updated and brand.indexed; omit it for both. 409 means the plan’s endpoint limit is reached. Output

delete

webhookEndpoints.delete Delete a webhook endpoint. This cannot be undone. Risk: destructive
Input Returns { id, deleted: true } after the API confirms with 204. Output

get

webhookEndpoints.get Get one webhook endpoint. Risk: read
Input Output

list

webhookEndpoints.list List the team’s webhook endpoints. Risk: read
Input: empty object Output

update

webhookEndpoints.update Change a webhook endpoint’s URL, description, event types or disabled state. Risk: write
Input Output