Quickstart

1) Create an API key

• Go to the developer portal at https://logos.getquikturn.io.
• Create a key and assign it to a plan (Free, Launch, Growth, or Enterprise).
• Copy the key (starts with qt_) and keep it secret.

2) First call: logo by domain

Code
 
curl "https://logos.getquikturn.io/logo?domain=getquikturn.io&download=true" \
  -H "Authorization: Bearer qt_your_api_key"

Response (json mode):

Code
 
{
  "data": {
    "url": "https://cdn.getquikturn.io/logos/quikturn-io.svg",
    "width": 200,
    "height": 50,
    "format": "svg"
  }
}

3) Search for companies

Code
 
curl "https://logos.getquikturn.io/companies?q=fintech&limit=10" \
  -H "Authorization: Bearer qt_your_api_key"

4) Fetch a company profile

Code
 
curl "https://logos.getquikturn.io/companies/getquikturn.io" \
  -H "Authorization: Bearer qt_your_api_key"

What you’ll see in headers

Successful calls include trusted headers for your upstream integration: x-quikturn-key-id, x-quikturn-client-id, x-quikturn-plan, x-quikturn-plan-status, x-quikturn-key-status, x-quikturn-quota-remaining, x-quikturn-quota-reset (plan/status/quota headers appear only if set on your account).

Errors to handle

• 401 missing/invalid key
• 404 logo/company not found
• 429 rate limit or quota exceeded (respect Retry-After)

Keep keys secret (env vars), use HTTPS, and handle 404/429 gracefully.