{"openapi":"3.1.0","info":{"title":"Launch Llama API","version":"1.0.0","description":"Public REST API for the Launch Llama directory: search the catalog, audit a URL before launch, browse launch directories, plan a submission campaign, and open a submission draft. Optional Mini Apps (SEO/Reddit/X analyzers + SaaS calculators) are available as secondary helpers. Founder routes under /me/* need a Supabase user JWT. Agents never publish a listing — they open a draft and return a review link for the founder. MCP exposes the same tools at /functions/v1/api-mcp."},"servers":[{"url":"https://kxdushqmihjyuddcwkpw.supabase.co/functions/v1/api-v1"}],"components":{"securitySchemes":{"founderJwt":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Supabase user JWT. Required for /me/* routes and to persist badge/tool_id-scoped calls."},"partnerKey":{"type":"apiKey","in":"header","name":"X-Partner-Key","description":"Issued partner secret. Required only for POST /submissions with publish=true. Never send from a browser."}}},"paths":{"/products":{"get":{"summary":"Search and page live products","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":20,"maximum":50}},{"name":"offset","in":"query","schema":{"type":"integer","default":0}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"type","in":"query","schema":{"type":"string","enum":["community","product_hunt"]}},{"name":"period","in":"query","schema":{"type":"string","enum":["week","month","all"]}}],"responses":{"200":{"description":"Product page"}}}},"/products/top":{"get":{"summary":"Top products by upvotes (no keyword required)","parameters":[{"name":"n","in":"query","schema":{"type":"integer","default":10,"maximum":50}},{"name":"offset","in":"query","schema":{"type":"integer","default":0}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"type","in":"query","schema":{"type":"string","enum":["community","product_hunt"]}},{"name":"period","in":"query","schema":{"type":"string","enum":["week","month","all"]}}],"responses":{"200":{"description":"Top products page"}}}},"/categories":{"get":{"summary":"Distinct category labels in the live catalog, plus submit_categories (labels accepted on submit)","responses":{"200":{"description":"Category list"}}}},"/mini-apps":{"get":{"summary":"List optional Mini Apps (secondary helpers)","description":"Optional secondary toolkit: edge analyzers/finders/raters plus SaaS calculators. Prefer catalog search, launch readiness, and submissions for launch work. Browser-only utilities (HTML viewer, fake MRR chart, column-to-comma) are omitted. Filter with ?kind=analyzer|finder|rater|calculator.","parameters":[{"name":"kind","in":"query","schema":{"type":"string","enum":["analyzer","finder","rater","calculator"]}}],"responses":{"200":{"description":"Mini app catalog with input schemas"}}}},"/mini-apps/{slug}":{"get":{"summary":"One Mini App schema","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Mini app"},"404":{"description":"Not found"}}},"post":{"summary":"Run an optional Mini App","description":"Secondary helper. JSON body matches the tool's inputs (from GET). Calculators are anonymous. Edge tools with requires_auth need Authorization: Bearer <Supabase user JWT>.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Key/value inputs for the mini app"}}}},"responses":{"200":{"description":"ok, slug, kind, data"},"400":{"description":"Missing/invalid inputs"},"401":{"description":"Auth required for this tool"},"404":{"description":"Unknown slug"}}}},"/products/{slug}":{"get":{"summary":"One product listing","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Product"},"404":{"description":"Not found"}}}},"/launch-readiness":{"get":{"summary":"Preflight audit for a product URL","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","format":"uri"}}],"responses":{"200":{"description":"Readiness report"}}},"post":{"summary":"Preflight audit for a product URL","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri"}}}}}},"responses":{"200":{"description":"Readiness report"}}}},"/submissions":{"post":{"summary":"Open a draft, or publish as a partner","description":"Anonymous: creates a draft + review_url. email is required — we email the founder a finish-listing sequence. Partner publish: set publish=true with X-Partner-Key (server-side only), email, and marketing_consent=true — listing goes live and skips free badge/upvote gates. MCP never publishes.","parameters":[{"name":"X-Partner-Key","in":"header","required":false,"description":"Issued partner secret. Required when publish=true. Never send from a browser.","schema":{"type":"string"}},{"name":"X-Partner-Source","in":"header","required":false,"description":"Attribution slug for drafts. Not a publish credential.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url","email"],"properties":{"url":{"type":"string","format":"uri"},"partner":{"type":"string","description":"Partner attribution slug"},"product_name":{"type":"string"},"tagline":{"type":"string","description":"Max 60 chars. Punchy line for directory cards and product H1 (Name - tagline)."},"short_description":{"type":"string","description":"120–200 chars. Who / what / outcome — shown under the title on the product page."},"long_description":{"type":"string"},"email":{"type":"string","format":"email","description":"Founder email (required). Drafts: we email them the finish-listing link. Publish: newsletter + confirmation."},"marketing_consent":{"type":"boolean","description":"Must be true when publish=true"},"publish":{"type":"boolean","description":"Partner-only: publish live listing (requires X-Partner-Key)"},"creator_name":{"type":"string"},"categories":{"type":"array","items":{"type":"string"},"description":"Up to 3 Launch Llama category labels (same as /submit)"},"pricing_tier":{"type":"string","enum":["free","freemium","paid"]},"logo_url":{"type":"string","format":"uri"},"thumbnail_url":{"type":"string","format":"uri"},"youtube_url":{"type":"string","format":"uri"},"twitter_handle":{"type":"string","description":"X/Twitter handle without @"},"deals":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":"string"},"coupon":{"type":"string"},"badge":{"type":"object","properties":{"type":{"type":"string","enum":["discount","lifetime","percent"]},"value":{"type":"string"}}}}}},"seo_title":{"type":"string"},"meta_description":{"type":"string"},"keywords":{"type":"array","items":{"type":"string"}},"alternative_to":{"type":"array","items":{"type":"string"}},"founder_use_cases":{"type":"array","items":{"type":"string"}},"features":{"type":"array","items":{"type":"string"}},"faq_overrides":{"type":"array","items":{"type":"object","properties":{"q":{"type":"string"},"a":{"type":"string"}}}},"launch_mcp_opt_in":{"type":"boolean","description":"Cross-post to MCP Shelf (dofollow backlink). Defaults to true when categories include AI Agent / MCP. Pass false to skip. When opted in, mcp_resource_url is required."},"mcp_resource_url":{"type":"string","format":"uri","description":"Required when MCP Shelf opt-in is on: GitHub repo, MCP install URL, or docs URL."},"mcp_install_command":{"type":"string","description":"Optional paste-ready install command for MCP Shelf."}}}}}},"responses":{"201":{"description":"Draft created or listing published"},"400":{"description":"Bad request"},"401":{"description":"Invalid or missing partner key"},"409":{"description":"URL already listed"}}}},"/leads":{"post":{"summary":"Partner: send a lead to Launch Llama","description":"Partner-only (X-Partner-Key, server-side). Sends us a person who wants Launch Llama's help (launch, directory submissions, newsletter ads, featured listing). We store it and email the team, who reply to the lead directly. Pass external_id (your own lead id) so retries are idempotent: a repeat returns 200 with duplicate=true.","security":[{"partnerKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["email","consent"],"properties":{"email":{"type":"string","format":"email"},"consent":{"type":"boolean","description":"Must be true: the person agreed to be contacted by Launch Llama."},"external_id":{"type":"string","description":"Your id for this lead. Makes retries idempotent."},"name":{"type":"string"},"company":{"type":"string"},"website_url":{"type":"string","format":"uri","description":"The lead's product or site"},"phone":{"type":"string"},"interest":{"type":"string","description":"What they want, e.g. launch, directory_submissions, newsletter_ad, featured_listing"},"message":{"type":"string","description":"Free text from the lead, up to 4000 chars"},"source_url":{"type":"string","format":"uri","description":"Page on your site where the lead came from"},"metadata":{"type":"object","description":"Any extra JSON, under 4000 bytes"}}}}}},"responses":{"200":{"description":"Same external_id already received (duplicate=true)"},"201":{"description":"Lead stored"},"400":{"description":"Bad request"},"401":{"description":"Invalid or missing partner key"},"429":{"description":"Rate limited"}}}},"/launch-directories":{"get":{"summary":"Vetted launch-directory catalog (static, no auth)","parameters":[{"name":"category","in":"query","schema":{"type":"string"}},{"name":"pricing","in":"query","schema":{"type":"string","enum":["Free","Freemium","Paid"]}},{"name":"min_dr","in":"query","schema":{"type":"integer","minimum":0,"maximum":100}},{"name":"launch_platform","in":"query","schema":{"type":"boolean"}},{"name":"q","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":25}},{"name":"offset","in":"query","schema":{"type":"integer","default":0}},{"name":"sort","in":"query","schema":{"type":"string","enum":["dr_desc","dr_asc","name"]}}],"responses":{"200":{"description":"Directory page with items[], total, catalog_size"}}}},"/directory-campaign/plan":{"post":{"summary":"Week-by-week directory submission plan (deterministic, no AI)","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"category":{"type":"string"},"budget":{"type":"string","enum":["free","mixed","paid"],"default":"mixed"},"limit":{"type":"integer","minimum":10,"maximum":60,"default":30}}}}}},"responses":{"200":{"description":"Campaign plan grouped by week"}}}},"/badge":{"get":{"summary":"Badge embed snippet (HTML + Markdown)","parameters":[{"name":"variant","in":"query","schema":{"type":"string","enum":["default","white"],"default":"default"}},{"name":"slug","in":"query","schema":{"type":"string"},"description":"Product URL slug — badge href becomes /products/{slug}"},{"name":"product_name","in":"query","schema":{"type":"string"},"description":"Product name used to derive slug when slug is omitted"}],"responses":{"200":{"description":"Badge snippet"}}}},"/badge/verify":{"post":{"summary":"Check whether the badge is live on a URL","description":"Anonymous. Pass a founder JWT and tool_id to also persist badge_added on the listing; otherwise persisted=false.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri"},"badge_url":{"type":"string","format":"uri"},"tool_id":{"type":"string","format":"uuid","description":"Requires founder JWT"}}}}}},"responses":{"200":{"description":"detected / persisted / next_steps"}}}},"/newsletter-ads":{"get":{"summary":"Newsletter ad packages and checkout deep links","parameters":[{"name":"tool_id","in":"query","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Packages and deep links"}}}},"/first-users":{"post":{"summary":"First Users ICP report for a URL","description":"AI-generated and cached. Pass tool_id instead of url to report on an owned listing (requires founder JWT).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"tool_id":{"type":"string","format":"uuid","description":"Requires founder JWT"}}}}}},"responses":{"200":{"description":"ICP report"}}}},"/me/launches":{"get":{"summary":"Listings owned by the authenticated founder","security":[{"founderJwt":[]}],"responses":{"200":{"description":"Owned listings"},"401":{"description":"Missing or invalid JWT"}}}},"/me/launches/{tool_id}/analytics":{"get":{"summary":"Impressions, clicks and engagement for an owned listing","security":[{"founderJwt":[]}],"parameters":[{"name":"tool_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Analytics"},"401":{"description":"Missing or invalid JWT"},"404":{"description":"Not owned or not found"}}}},"/me/launches/{tool_id}/directory-campaign":{"get":{"summary":"Directory submission progress for an owned listing","security":[{"founderJwt":[]}],"parameters":[{"name":"tool_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Campaign status"},"401":{"description":"Missing or invalid JWT"}}}},"/me/launches/{tool_id}/advise-growth":{"get":{"summary":"Growth recommendations for an owned listing","security":[{"founderJwt":[]}],"parameters":[{"name":"tool_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Recommendations"},"401":{"description":"Missing or invalid JWT"}}}},"/me/launches/{tool_id}/changelog":{"post":{"summary":"Publish a changelog entry on an owned listing","description":"Writes public content immediately. Set confirm=false to preview without publishing.","security":[{"founderJwt":[]}],"parameters":[{"name":"tool_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["title","body"],"properties":{"title":{"type":"string"},"body":{"type":"string"},"confirm":{"type":"boolean","default":true}}}}}},"responses":{"201":{"description":"Published"},"401":{"description":"Missing or invalid JWT"}}}},"/submissions/{id}":{"get":{"summary":"Fetch a draft by id","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Draft"},"404":{"description":"Not found"}}}}}}