Skip to content
QuikturnQuikturn
REST API

Logo Lookup

Fetch company logos by domain name

Endpoint

GET /{domain}?token={your_key}

Provide a domain to receive image bytes directly. Optional transforms (size, greyscale, theme) are applied at the edge via Cloudflare Image Resizing.

Parameter Reference

Path Parameters

ParameterTypeRequiredDescription
domainstringYesCompany domain (e.g., apple.com)

Query Parameters

ParameterTypeDefaultDescription
tokenstringrequiredYour publishable API key (pk_*)
sizenumber128Pixel width (1-800); aspect ratio preserved
greyscalebooleanfalseSet to true/1/yes for B&W
themestring—light or dark for background variants

If no options are provided, the worker serves a 128px-wide version via Cloudflare Image Resizing.

Response

Success (200 OK)

200OK
HTTP/1.1 200 OK
Content-Type: image/png
Cache-Control: public, max-age=86400
X-RateLimit-Remaining: 499999
X-RateLimit-Reset: 1706745600

Error Responses

400Bad Request
Error Message
Invalid domain format
Solution

Ensure the domain is valid (e.g., 'apple.com') without protocol or path

401Unauthorized
Error Message
Missing or invalid token
Solution

Include a valid publishable key starting with 'pk_' as the token parameter

404Not Found
Error Message
Logo not found
Solution

Check domain spelling or try the parent domain (e.g., 'google.com' instead of 'mail.google.com')

429Too Many Requests
Error Message
Rate limit exceeded
Solution

Wait for the Retry-After duration or upgrade your plan for higher limits

The response includes Retry-After and X-RateLimit-Reset headers.

Request Examples

# Inspect headers without downloading
curl -I "https://logos.getquikturn.io/apple.com?token=pk_your_key"

# Download and save the logo
curl "https://logos.getquikturn.io/apple.com?token=pk_your_key" -o apple-logo.png

# With size and greyscale options
curl "https://logos.getquikturn.io/apple.com?token=pk_your_key&size=256&greyscale=true" -o apple-gray.png

Best Practices

  1. Use <img> tags directly — The endpoint returns image bytes, so <img src="..."> just works.
  2. Handle 404s gracefully — Set a fallback image when a logo is missing.
  3. Respect rate limits — Back off on 429 using the Retry-After header.
  4. Use lazy loading — Add loading="lazy" for below-the-fold images.
  5. Cache appropriately — Logos are cached for 24 hours; respect Cache-Control.

Next Steps

API Endpoints

Reference for the logo lookup endpoint

Error Handling

Status codes, edge enforcement, and recovery patterns

On this page

EndpointParameter ReferencePath ParametersQuery ParametersResponseSuccess (200 OK)Error ResponsesRequest ExamplesBest PracticesNext Steps