Skip to main content
The Logoo API serves brand logos and company data over simple HTTP GETs. Everything runs under a single base URL.

​
Base URL

The versioned surface is mounted at /v1.

​
Authentication

Every /v1/* endpoint runs through the same gate: a request is accepted if it comes from a trusted origin (via Origin/Referer) or carries a valid API key (la_*) in an Authorization: Bearer or X-API-Key header. See Authentication for headers, error shapes, and quota details. GET /health is always open.

​
Endpoints

Logo by Domain

GET /v1/:domain — Serve a brand logo by domain name

Logo by Name

GET /v1/name/:brand — Resolve a brand name and return its logo

Search Brands

GET /v1/search?q= — Search brands by name

Brand Info

GET /v1/brand/:domain — Get enriched company data

Parameters

Query parameters for logo requests (size, format, theme, etc.)

​
Health check

Returns { status: "ok", date, database: { connected } }. No auth required — useful for uptime monitors.

​
OpenAPI spec

A live OpenAPI 3 document is served at:
Point your tooling (Stainless, openapi-typescript, Prism, etc.) at this URL to generate SDKs, mocks, or Postman collections.

​
Rate limiting and usage tracking

Every /v1/* request passes through rate limiting and usage tracking middleware. When an API key is present the usage counts accrue to its owner and enforce their plan quota; otherwise counts accrue per IP. Over-limit responses return 429 RATE_LIMITED.

​
Response formats

Logo endpoints return image data (image/webp, image/png, image/avif, image/jpeg, image/svg+xml). Search, brand info, and /health return JSON with Content-Type: application/json.

​
Error format