Logo.dev API
Logo.dev serves brand assets from two hosts, each with its own key: Logo.dev CDN (img.logo.dev) returns a logo image. Authenticate with a publishable key in…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Logo.dev serves brand assets from two hosts, each with its own key:
- Logo.dev CDN (
img.logo.dev) returns a logo image. Authenticate with a publishable key in thetokenquery parameter. It is safe in client-side code. - Logo.dev API (
api.logo.dev) returns JSON. Authenticate with a secret key in theAuthorization: Bearerheader. Call it only from your server.
Get your keys from the dashboard.
Endpoints 25
Logo CDN
- GETGet a logo
https://img.logo.dev/:domainGet a logo image by domain, brand name, stock ticker, ISIN, crypto symbol, stock exchange, or market index. - GETGet a logo by brand name
https://img.logo.dev/name/:nameReturns the best-match logo for a brand name. URL-encode names with spaces or special characters. This is a convenience wrapper over Search that returns the… - GETGet a logo by stock ticker
https://img.logo.dev/ticker/:tickerReturns a company's logo for a stock ticker symbol. Defaults to US exchanges; append an exchange suffix for others (e.g. AAPL.L, 7203.T). See Get a logo for… - GETGet a logo by ISIN
https://img.logo.dev/isin/:isinReturns a company's logo for an ISIN (International Securities Identification Number). See Get a logo for every lookup. - GETGet a cryptocurrency logo by symbol
https://img.logo.dev/crypto/:symbolReturns a cryptocurrency logo for a coin symbol such as btc or eth. See Get a logo for every lookup. - GETGet a logo by stock exchange
https://img.logo.dev/exchange/:exchangeReturns the logo for a stock exchange by its code, e.g. NYSE, NASDAQ, or LSE. See Get a logo for every lookup. - GETGet a logo by market index
https://img.logo.dev/index/:symbolReturns the logo for a market index by its symbol, e.g. SPX, DJI, or IXIC. See Get a logo for every lookup.
Brands
- GETLook up a brand
/v2/brandsReturns a brand's profile from one identifier: a domain, ticker, ISIN, crypto symbol, or name. Send exactly one. A brand Logo.dev has not indexed yet returns… - GETGet a brand by id
/v2/brands/:idReturns a brand's profile by its id, the data.id from an earlier response. The response is the same as looking the brand up by domain, and it is billed the…
Logos
- GETGet a logo
/v2/brands/logoReturns the brand's square logo as JSON with a temporary download url, the source dimensions, and a placeholder blurhash. It does not return image bytes. Send… - GETGet a brandmark
/v2/brands/brandmarkReturns the brand's brandmark, the wide logo lockup, as JSON with a temporary download url, the source dimensions, and a placeholder blurhash. It does not…
Search
- GETSearch brands
/v2/search?q=sweetgreenFinds brands by name and returns candidates with their domain and logo URL. match searches full names and aliases; typeahead completes a prefix as someone…
Subscriptions
- GETGet a brand subscription
/v2/brands/:id/subscriptionReturns your account's subscription to this brand, if there is one. Subscriptions decide which brands send you brand.updated events. - PUTSubscribe to a brand
/v2/brands/:id/subscriptionSubscribes your account to brand.updated events for this brand. Safe to repeat: it returns 201 the first time and 200 after that, with the same body. Needs a… - DELETEUnsubscribe from a brand
/v2/brands/:id/subscriptionStops brand.updated events for this brand. Returns 204 whether or not a subscription existed. Needs a paid plan. See Who can use webhooks.
Webhook endpoints
- GETList webhook endpoints
/v2/webhook_endpointsReturns every webhook endpoint on your team. Not paginated. Needs a paid plan. See Who can use webhooks. - POSTCreate a webhook endpoint
/v2/webhook_endpointsRegisters a URL to receive webhook events. Needs a paid plan and the owner or admin role. See Who can use webhooks. - GETGet a webhook endpoint
/v2/webhook_endpoints/:idReturns one webhook endpoint. Needs a paid plan. See Who can use webhooks. - DELETEDelete a webhook endpoint
/v2/webhook_endpoints/:idDeletes an endpoint. Deliveries to it stop. Needs a paid plan and the owner or admin role. See Who can use webhooks. - PATCHUpdate a webhook endpoint
/v2/webhook_endpoints/:idChanges an endpoint. Send only the fields to change; omitted fields keep their value. Send filter_types: [] to receive every event type. Needs a paid plan and… - GETGet a webhook signing secret
/v2/webhook_endpoints/:id/secretReturns the endpoint's signing secret, used to verify deliveries. Any team member can read it. Needs a paid plan. See Who can use webhooks. - POSTRotate a webhook signing secret
/v2/webhook_endpoints/:id/secretReplaces the endpoint's signing secret and returns the new one. Update your verification code with it. Needs a paid plan and the owner or admin role. See Who…
Account
- GETGet your account
/v2/accountReturns your plan and API credit balances. Not billed.
Flags
- POSTFlag domains for review
/v2/flagSubmits domains with incorrect or outdated brand data for review. Nothing changes on a brand until a reviewer acts, and flagging never creates a webhook…
Transaction Enrichment API
- POSTIdentify a merchant
https://www.logo.dev/api/transactionIdentify the merchant behind a merchant name or card descriptor. Every non-empty transaction returns one row: matched with a merchant domain, or cleaned with…
API details
- Base URL
https://api.logo.dev- Authentication
- An API key in the token query parameter
A bearer token in the Authorization header
A bearer token in the Authorization header - Operations
- 25 operations on 19 pathsGET 17POST 4DELETE 2PUT 1PATCH 1
- Main resources
- Logo CDN 7Webhook endpoints 7Subscriptions 3Brands 2Logos 2Account 1Flags 1Search 1Transaction Enrichment API 1
- Response formats
application/json- Description format
- OpenAPI 3.1.0, API version
2.0.0 - Links
- OpenAPI document · Support
- Listed from
- Logo's published OpenAPI description
How to test the Logo.dev API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Logo.dev API collection, without the publisher's secrets.
- Add your credentialsThis API uses an API key in the token query parameter. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “Get a logo” (GET https://img.logo.dev/:domain), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Logo.dev API?
Logo.dev serves brand assets from two hosts, each with its own key: Logo.dev CDN (img.logo.dev) returns a logo image. Authenticate with a publishable key in… It is listed under Finance & banking and has 25 endpoints.
Who publishes the Logo.dev API?
It is listed from Logo.dev's public API description (an OpenAPI document), not published by Logo.dev on Swastik Codes. Anyone who controls logo.dev can claim the profile by adding a DNS TXT record.
What is the base URL of the Logo.dev API?
Requests go to https://api.logo.dev. Endpoint paths are added to this base URL.
How do I authenticate with the Logo.dev API?
It accepts 3 methods: an API key in the token query parameter; A bearer token in the Authorization header; A bearer token in the Authorization header.
How many endpoints does the Logo.dev API have?
25 operations on 19 paths (17 GET, 4 POST, 2 DELETE, 1 PUT, 1 PATCH). The largest groups are Logo CDN, Webhook endpoints, Subscriptions, Brands.
Is forking the Logo.dev API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.