Getting Started

Quick Start Guide

Get your first logo with this step-by-step guide.

Create Your Account

Get Your Publishable Key

Copy a publishable key (pk_*) from API Keys in the portal. Publishable keys are required for every request.

Make Your First Request

Use the domain name of any company:

<img
  src="https://logos.getquikturn.io/apple.com?token=pk_live_1234567890abcdef"
  alt="Apple Logo"
/>

Verify the Response

The edge worker responds with image bytes. The browser renders the logo directly.

200Successful Response

HTTP/1.1 200 OK
Content-Type: image/png
Cache-Control: public, max-age=86400

Attribution Requirements

Free Tier Requirement

If you're on the Free tier, you must display attribution on pages using Quikturn logos. This is not required for paid plans (Launch, Growth, Enterprise).

How to Add Attribution

Add this snippet to your page footer or near the logo display:

<a href="https://getquikturn.io" target="_blank" rel="noopener">
  Logos by Quikturn
</a>

Or use our badge component:

<a href="https://getquikturn.io" target="_blank" rel="noopener">
  <img
    src="https://getquikturn.io/badge.svg"
    alt="Powered by Quikturn"
    height="20"
  />
</a>

View full attribution guidelines

Framework Examples

Choose your framework to see specific integration examples:

<!DOCTYPE html>
<html>
<head>
  <title>Quikturn API Demo</title>
</head>
<body>
  <h1>Partner Logos</h1>

  <img
    src="https://logos.getquikturn.io/apple.com?token=pk_your_key"
    alt="Apple"
    width="150"
  />

  <img
    src="https://logos.getquikturn.io/google.com?token=pk_your_key"
    alt="Google"
    width="150"
  />

  <!-- Attribution for Free tier -->
  <footer>
    <a href="https://getquikturn.io">Logos by Quikturn</a>
  </footer>
</body>
</html>

Environment Variables

Security Warning

Never hardcode your API key in client-side code for production. Use environment variables.

# Standard .env file
LOGO_API_KEY=pk_live_1234567890abcdef
LOGO_BASE_URL=https://logos.getquikturn.io

Preflight Checklist

Before going live, verify:

Check	Status
Publishable key is correct and active	☐
Domain allowlist matches your Origin (if enabled)	☐
404 errors show fallback image	☐
429 errors trigger backoff logic	☐
Attribution visible (Free tier only)	☐

Common Issues

Logo Not Loading

401Unauthorized

Error Message

Missing or invalid token

Solution

Verify the token parameter is present and starts with 'pk_'

CORS Errors

If domain restrictions are enabled, the request Origin/Referer must match your allowlist.
Without restrictions, CORS is * and no extra headers are needed.

Slow First Load

The first request may populate cache; subsequent requests are served from CDN.
Use loading="lazy" for below-the-fold images to improve perceived performance.

Using the SDK (Optional)

For deeper integration, install the official TypeScript SDK:

npm install @quikturn/logos

import { QuikturnLogos } from "@quikturn/logos/client";

const client = new QuikturnLogos({ token: "pk_live_xxx" });
const { url } = await client.get("apple.com", { size: 128 });
document.querySelector("img").src = url;

The SDK is optional. The REST API works with any language or HTTP client. Full SDK documentation →

Next Steps

API Reference
SDK Documentation
MCP Server — connect AI assistants (Claude, Cursor, Windsurf) to the logo database
Rate Limits
Error Handling

Getting Started

On this page