{"auth":{"header":"Authorization: Bearer sl_live_...","notes":"Create a key at /api-dashboard. Keys never expire \u2014 they draw from your credit pool.","scheme":"Bearer"},"base_url":"https://superlogo.ai","endpoints":[{"auth":"required","body_schema":{"domains":{"max_items":700,"notes":"Direct fetch, no AI. $0.01/logo. Accepts full URLs, we strip to bare host.","required":"one_of","type":"array<string>"},"format":{"default":"base64","enum":["base64","url"],"type":"string"},"names":{"max_items":700,"notes":"AI-resolved lookup. $0.04/logo. Send EITHER `names` or `domains`, not both.","required":"one_of","type":"array<string>"},"size":{"default":512,"max":1024,"min":32,"notes":"Square output on the shortest edge in pixels.","type":"integer"}},"example_request":{"curl":"curl -X POST https://superlogo.ai/v1/resolve \\\n  -H 'Authorization: Bearer sl_live_YOURKEY' \\\n  -H 'Content-Type: application/json' \\\n  -d '{\"names\":[\"Apple\",\"Google\",\"Netflix\"],\"size\":512}'","python":"import requests\nr = requests.post(\n  'https://superlogo.ai/v1/resolve',\n  headers={'Authorization': 'Bearer sl_live_YOURKEY'},\n  json={'names': ['Apple','Google','Netflix'], 'size': 512},\n)\nprint(r.json())"},"method":"POST","path":"/v1/resolve","query_params":{"size":"Also accepted as ?size=\u2026 \u2014 takes precedence when both are set."},"response_headers":{"X-RateLimit-Remaining":"Logos remaining across BOTH pools (bonus + paid).","X-RateLimit-Resource":"Always 'logos' \u2014 SuperLogo bills per logo, not per request.","X-SuperLogo-Balance-Cents":"Cents remaining in your PAID pool.","X-SuperLogo-Free-Cents":"Cents remaining in your one-time bonus pool.","X-SuperLogo-Logos-Remaining":"Same as X-RateLimit-Remaining.","X-SuperLogo-Price-Per-Logo-Cents":"Machine-readable pricing.","X-SuperLogo-Request-Id":"Same as body.request_id.","X-SuperLogo-Total-Available-Cents":"Sum of bonus + paid."},"response_schema":{"logos":[{"domain":"string|null \u2014 resolved domain","found":"bool","logo_base64":"string \u2014 PNG bytes, base64 (only when format=base64)","logo_data_uri":"string \u2014 data:image/png;base64,... \u2014 safe to drop into <img src>","name":"string \u2014 the input name"}],"request_id":"string \u2014 echo this back if you file a support issue","stats":{"balance_cents":"int \u2014 remaining paid balance","cost_cents":"int \u2014 deducted from your pool for THIS request","delivered":"int \u2014 logos we actually resolved","free_cents":"int \u2014 remaining subscriber-bonus pool","requested":"int"}},"summary":"Resolve company names OR direct domains to logo bytes."},{"auth":"required","example_request":{"curl":"curl -H 'Authorization: Bearer sl_live_YOURKEY' https://superlogo.ai/v1/account"},"method":"GET","path":"/v1/account","summary":"Current balance + bonus pool."},{"auth":"required","example_request":{"curl":"curl -H 'Authorization: Bearer sl_live_YOURKEY' 'https://superlogo.ai/v1/usage?days=7'"},"method":"GET","path":"/v1/usage","query_params":{"days":"int 1-365, default 30"},"summary":"Rolled-up usage for the last N days (default 30, max 365)."},{"auth":"public","method":"GET","path":"/v1/docs","summary":"This document."}],"errors":[{"http":400,"reason":"Bad request \u2014 missing/invalid body, bad size, bad format."},{"http":401,"reason":"Missing/invalid/revoked API key."},{"http":402,"reason":"Payment required \u2014 credit pool empty AND autotopup unavailable or off."},{"http":413,"reason":"Too many names \u2014 max 700 per request."},{"http":429,"reason":"Rate limited (batch requests only) \u2014 retry after a short delay."},{"http":500,"reason":"Logo pipeline error \u2014 retry idempotent on request_id."}],"name":"SuperLogo API","notes":["Keys never expire; the credit pool is the only limit.","Subscriber-bonus pool drains before paid balance automatically.","Sub-256px sources are Lanczos-upscaled with local ringing clamps \u2014 no jagged edges, no bright halos.","Alpha channel is always preserved in outputs."],"pricing":{"credit_packs":[{"cents":500,"label":"$5"},{"cents":2000,"label":"$20"},{"cents":5000,"label":"$50"},{"cents":20000,"label":"$200"}],"per_domain_logo_cents":1,"per_domain_logo_usd":0.01,"per_name_logo_cents":4,"per_name_logo_usd":0.04,"subscriber_bonus_cents":500,"subscriber_bonus_notes":"$5 flat one-time credit for any paying tier (starter/pro/business). Spendable on either endpoint. Non-resetting. Drains before your paid balance.","subscriber_bonus_usd":5.0},"support":"https://superlogo.ai","version":"v1"}