GET /v2/search:
data is a list of candidates, inside the standard response envelope:
data is an empty list when nothing matches. Search is not paginated. It returns the top limit candidates. Search brands lists every parameter and status code.
Pick match or typeahead
Setmethod to fit where the name comes from:
match, the default, searches full names and aliases. Use it for a query someone submitted.typeaheadmatches prefixes only. Use it for suggestions while someone types.
Results are candidates, not brands
A search result is a name and a domain. It is not a brand record, and it has no brand id. A domain can appear in search before Logo.dev indexes its brand. Search itself never returns202, but the brand lookup for that domain can. See handle each status.
logo_url is a Logo.dev CDN URL signed with your publishable key. Put it straight into an <img> tag in your results.
When someone picks a result, look up its domain with Brand:
GET /v2/brands?name=sweetgreen.
Search never subscribes you to a brand’s webhooks. For what search costs, see API credits. Search has its own per-minute limit, and over it a search returns 429. See search rate limit.