Question 1

What image formats and sizes are supported?

Accepted Answer

PNG (default), JPEG and WebP via the format parameter. Size presets: og (1200×630, also right for Twitter/X and LinkedIn), instagram/square (1080×1080). The quote-card template renders square by default; the others render 1200×630.

Question 2

How does generate-from-URL work?

Accepted Answer

GET /api/v1/extract fetches the public https page you pass, reads its <title>, meta description and og:* tags, and returns { title, description }. The fetch is SSRF-guarded (private and internal hosts are rejected) and each call is metered like one render.

Question 3

What are the plan limits?

Accepted Answer

Free: 50 images/month. Basic ($9): 1,000. Premium ($29): 10,000 plus custom brand colors and team access. Business ($79): 100,000 plus white-label. A redeemed lifetime coupon gives Enterprise access with unlimited renders and no recurring billing.

Question 4

How do I authenticate API calls?

Accepted Answer

Send your key in the X-API-Key header (or as Authorization: Bearer <key>). Every /api/v1/* endpoint uses the same key. Usage and remaining quota are on your /dashboard.

Question 5

How do I redeem my DealMirror coupon?

Accepted Answer

Go to /redeem, enter the coupon code and your email. First-time users get a fresh API key in the response; existing keys are upgraded in place. Each coupon works once and activates lifetime Enterprise access.

Question 6

What exactly goes into the QR code?

Accepted Answer

Exactly the string you pass as data — typically a URL. It is encoded in byte mode at error-correction level M, which survives ~15% damage and fits up to ~213 UTF-8 bytes (QR versions 1–10, auto-sized). Nothing is added, shortened or tracked.

Question 7

How do I import the .vcf file?

Accepted Answer

The download is a standard vCard 3.0. On iPhone: open the file and tap Add to Contacts. On Android: open with the Contacts app. In Gmail/Outlook: use the contacts import function. One file per contact.

Question 8

Can I white-label the cards?

Accepted Answer

Yes — the Business plan supports white-label rendering with your own domain and branding, plus dedicated support. Custom brand colors (accent, background gradients) are available from Premium up.

Question 9

Do repeat fetches of the same card burn my quota?

Accepted Answer

Not if you opt into caching. Add cache=edge to serve repeats from the CDN after one metered render, or use bulk signed URLs — social crawlers hitting a signed URL are always edge-cached and never re-metered.

Question 10

Is my card data stored?

Accepted Answer

Your last 30 renders are kept in a private, per-key history (GET /api/v1/cards/history) so you can re-render them; entries expire automatically and can be deleted individually. Share links only exist when you explicitly create one, and the public gallery is strictly opt-in.

Question 11

EXTRACT_FAILED when generating from a URL

Accepted Answer

The URL must be a public https page. Private/internal hosts, plain http, redirects to login walls and pages that block bots all fail. Check the page opens in an incognito browser tab, then retry — transient network errors also return this code.

Question 12

401 UNAUTHORIZED on API calls

Accepted Answer

The X-API-Key header is missing or the key is wrong. Check for whitespace around the key, confirm the header name is exactly X-API-Key (or use Authorization: Bearer <key>), and make sure you are calling the production host your key was issued on.

Question 13

429 QUOTA_EXCEEDED or RATE_LIMITED

Accepted Answer

QUOTA_EXCEEDED means the monthly render quota for your plan is used up — upgrade on /pricing or wait for the monthly reset. RATE_LIMITED is the per-second burst limit: honor the Retry-After header and space out calls, or batch with POST /api/v1/cards/bulk.

Question 14

Text looks wrong — glyphs, emoji or overflow

Accepted Answer

Card templates ship with a tuned Latin font stack; exotic glyphs and some emoji may not render as they do in your browser. Keep titles ≤ 120 and subtitles ≤ 160 characters (longer input is rejected), and prefer plain text over special symbols.

Question 15

QR code will not scan or looks too dense

Accepted Answer

Long data means a denser grid. Keep the payload under ~200 characters — encode a short share link instead of a full parameter-laden API URL — request size=512 or larger, and keep the default dark-on-light colors for maximum scanner contrast.

Feature	Plan	API
Card playground (live preview, watermarked demo)	Free, no key	GET /api/demo
Card render API — 5 templates, PNG/JPEG/WebP	Free 50/mo → Business 100k/mo	GET /api/v1/card
Card text from a URL (title + description)	All plans, metered	GET /api/v1/extract
Bulk signed URLs (up to 50 per call)	Paid plans	POST /api/v1/cards/bulk
Card history (your last 30 renders)	All plans	GET /api/v1/cards/history
QR codes (SVG or PNG, error level M)	All plans, metered	GET /api/v1/qr
vCard (.vcf) contact files	All plans, metered	POST /api/v1/vcard
Share links & public gallery	Free	POST /api/share
Custom brand colors & themes	Premium and up	GET /api/v1/card (accent, bg, bg2)
White-label (your domain & branding)	Business	—

Feature	Plan	API
Card playground (live preview, watermarked demo)	Free, no key	GET /api/demo
Card render API — 5 templates, PNG/JPEG/WebP	Free 50/mo → Business 100k/mo	GET /api/v1/card
Card text from a URL (title + description)	All plans, metered	GET /api/v1/extract
Bulk signed URLs (up to 50 per call)	Paid plans	POST /api/v1/cards/bulk
Card history (your last 30 renders)	All plans	GET /api/v1/cards/history
QR codes (SVG or PNG, error level M)	All plans, metered	GET /api/v1/qr
vCard (.vcf) contact files	All plans, metered	POST /api/v1/vcard
Share links & public gallery	Free	POST /api/share
Custom brand colors & themes	Premium and up	GET /api/v1/card (accent, bg, bg2)
White-label (your domain & branding)	Business	—

Help & Knowledge Hub

Quick start

Build your first card in the playground

Generate card text from a URL

Get your API key

Automate with GET /api/v1/card

Add QR codes and vCards

Features & API map

Frequently asked questions

Troubleshooting