Skip to main content
​
API credits page
  • API credits: a new page lists what each Logo.dev API request costs, what is billed, how included and purchased credits work, and what happens when you run out.
​
Describe is retired
  • v1 describe endpoint: GET /describe/{domain} now returns 403 unless Logo.dev has enabled Describe for your account. Free accounts still get 401. Use brand lookups instead: GET /v2/brands returns every Describe field plus the brandmark and social banners.
​
Search rate limit, webhook plan limits, and v1 search billing
  • Search rate limit: search now has its own per-minute limit for each account, separate from the lookup limits. It applies to GET /v2/search, v1 GET /search, and the MCP search tool. Over it, the response is 429 with the code rate_limited. Search responses now send the RateLimit-Limit, RateLimit-Remaining, and RateLimit-Reset headers.
  • Webhook plan limits: each plan now caps the number of webhook endpoints and subscribed brands. At the cap, creating an endpoint or subscribing to a new brand returns 409 with the code limit_exceeded. A brand lookup reports its automatic subscribe in metadata.subscription, with the status quota_exceeded at the cap.
  • v1 search billing: the deprecated v1 GET /search now spends API credits like GET /v2/search, and returns 402 when you are out of API credits. Move to GET /v2/search.
  • Credit headers on search: GET /v2/search now sends Credits-Charged and Credits-Remaining.
  • Startup API credit grant: the Startup plan’s monthly API credit grant is larger. See pricing.
​
Redirects onto domain squatters
  • Redirects onto domain squatters: when a domain redirects to a domain squatter, Logo.dev now treats the domain as not found instead of returning the squatter’s logo.
  • redirect parameter: img.logo.dev/{domain} accepts redirect=404. It returns 404 when the domain reaches a brand only through a redirect, whatever fallback is set to. The default, follow, keeps the earlier behavior.
​
Logo theme defaults and 202 responses
  • Logo theme: theme now defaults to light, and auto is the same as light. A JPG has no transparency, so use theme with format=png or format=webp. Since September 11, theme=dark also inverts single-color marks so they show on a dark background.
  • Still-indexing responses: a 202 now explains itself in metadata.pending and sends a Retry-After header.
​
Request ids
  • Request ids: the Request-Id header is now an id with the request_ prefix, on every Logo.dev CDN and Logo.dev API response. Include it when you contact support.
​
Logo.dev API v2, webhooks, and Logo.dev MCP
  • Logo.dev API v2: look up a brand by domain, stock ticker, ISIN, crypto symbol, or name with GET /v2/brands. Get a logo or brandmark file on its own, and search brands with GET /v2/search. Every response uses one envelope and error shape. The v1 routes keep working and are marked deprecated.
  • Webhooks: subscribe to the brands you use, and get a brand.updated event when one changes.
  • Logo.dev MCP: connect Claude, Cursor, VS Code, Codex, or another MCP client, and your agent gets every v2 route as a tool.
  • Docs: the API reference is now one page per endpoint, split into the Logo.dev CDN and the Logo.dev API. Use cases now start with a live demo and a prompt you can give your coding agent.
  • Teams: share one set of API keys, one plan, and one API credit balance with your teammates. Invite members, set roles, and transfer ownership from the dashboard.
  • Search billing: v2 search requests and the MCP search tool now spend API credits instead of drawing on the monthly request allowance.
  • Logo.dev CDN rate limits: on the Community plan, CDN requests now have a per-minute limit for each IP address, shared by every Community key used from that address, and for each account. Over either, the response is 429 with a Retry-After header. Paid plans have no per-minute limit on the CDN.
  • v1 describe endpoint: deprecated. New integrations should use brand lookups, which return everything Describe does plus the brandmark and social banners.
​
shadcn/ui components and self-service attribution
  • shadcn/ui components: a registry of React components covering logo images, company autocomplete, logo walls, and attribution. Each installs with its own npx shadcn command. The source lands in your project with fallbacks, retina images, and dark mode already wired.
  • Attribution is now self-service. Submit your production URL from the dashboard, then check the same task for the result and submit again if a check fails.
​
Transaction and Core Concepts
  • Transaction entered early access: turn a raw card-transaction descriptor into the merchant’s name, domain, and logo.
  • New Core Concepts page defines the terms used across the docs, from company logo and brandmark to the two API key types.
​
Documentation revamp
We rebuilt the docs:
​
Clearbit migration
The Clearbit Logo API shut down on December 8, 2025. We published a migration guide so you can move logo.clearbit.com URLs to Logo.dev in minutes, plus reference docs for the Clearbit, Google Favicon, and DuckDuckGo Favicon APIs.