API Endpoints

Base URL

All API requests use the following base URL and format:

GET https://logos.getquikturn.io/{domain}?token=pk_xxx

Available Endpoints

Only the logo lookup endpoint is available today. Batch, search, and metadata endpoints are on the roadmap but not yet live.

Logo Lookup (302 Redirect)

GET /{domain}?token=pk_your_key
      &size=128
      &greyscale=true
      &theme=dark

Example:

curl -I "https://logos.getquikturn.io/apple.com?token=pk_your_key"

Typical response:

HTTP/1.1 302 Found
Location: https://cdn.quikturn.io/logos/apple.com.png
Cache-Control: public, max-age=86400
X-RateLimit-Remaining: 482
X-RateLimit-Reset: 1706745600

If a logo cannot be found, the service returns 404 with a plain-text message.

Errors

CORS

• If no domain restrictions are set on your key, responses include Access-Control-Allow-Origin: *.
• If domain restrictions are enabled, the Origin/Referer must match your allowlist and CORS reflects the allowed origin.

Transformations

• size (optional): pixel width. Default 128. Max 800. Aspect ratio preserved.
• greyscale (optional): true|1|yes to desaturate the logo.
• theme (optional): light or dark to invert for contrast on light/dark backgrounds.
• All transformations are applied at the edge via Cloudflare Image Resizing on top of the stored logo.

Next Steps

• Logo Lookup
• Rate Limits
• Error Handling