API reference

Base URL https://ventrylaunch.com/api/v1. Machine-readable: OpenAPI 3.1. Each operation is also an MCP tool with the same name.

Site

Who this site is and what it offers

• GET /api/v1/site: About this site and its API (tool get_site_info)

Listings

Search and read live listings

• GET /api/v1/listings: Search and filter listings (tool search_listings)
• GET /api/v1/listings/{slug}: Get a listing's full profile (tool get_listing)
• GET /api/v1/listings/{slug}/alternatives: Alternatives to a listing (tool get_alternatives)
• GET /api/v1/compare: Compare two listings side by side (tool compare_listings)

Categories

Categories and subcategories

• GET /api/v1/categories: List categories and subcategories (tool list_categories)
• GET /api/v1/categories/{slug}: Get a category with its top listings (tool get_category)

Launches

The launch calendar

• GET /api/v1/launches/weeks/{week}: Launches in one week (tool get_launch_week)
• GET /api/v1/launches: Launch feed sections (tool list_launches)

Leaderboards

Community votes, the paid billboard and Domain Rating boards (separate systems)

• GET /api/v1/leaderboards/{board}: Get a leaderboard (tool get_leaderboard)

People

Founders and their stories

• GET /api/v1/founders: Find founders (tool list_founders)
• GET /api/v1/founders/{slug}: Get a founder with companies and stories (tool get_founder)

Content

Blog posts and guides

• GET /api/v1/blog: List or search blog posts (tool list_blog_posts)
• GET /api/v1/blog/{slug}: Read a blog post (tool get_blog_post)

Badges

Embeddable badges and awards

• GET /api/v1/awards: Awards won on this site (tool list_awards)
• GET /api/v1/listings/{slug}/badges: Badge embed codes for a listing (tool get_badges)

Account

Your account (needs sign-in)

• GET /api/v1/me: Your account (tool get_account, needs account:read)

Submit

Submit a product by URL and edit the AI draft (needs sign-in)

• POST /api/v1/drafts: Submit a product by its website URL (tool submit_listing, needs listings:write)
• GET /api/v1/drafts: Your drafts on this site (tool list_my_drafts, needs account:read)
• GET /api/v1/drafts/{id}: Get a draft (poll while it builds) (tool get_draft, needs account:read)
• PATCH /api/v1/drafts/{id}: Edit a draft (tool update_draft, needs listings:write)
• POST /api/v1/drafts/{id}/invites: Invite a co-founder (tool invite_cofounder, needs listings:write)
• POST /api/v1/drafts/{id}/submit: Turn a ready draft into your listing (tool submit_draft, needs listings:write)

My listings

Edit your live listings (needs sign-in)

• GET /api/v1/me/listings: Your listings on this site (tool list_my_listings, needs account:read)
• GET /api/v1/me/listings/{listing_id}: One of your listings (tool get_my_listing, needs account:read)
• PATCH /api/v1/me/listings/{listing_id}: Edit your listing (tool update_my_listing, needs listings:write)
• POST /api/v1/me/listings/{listing_id}/updates: Post a 'what's new' update (tool post_listing_update, needs listings:write)
• POST /api/v1/me/listings/{listing_id}/milestones: Add a milestone (tool add_milestone, needs listings:write)
• DELETE /api/v1/me/listings/{listing_id}/milestones/{milestone_id}: Delete a milestone (tool delete_milestone, needs listings:write)
• PUT /api/v1/me/listings/{listing_id}/story: Write or update your founder story (tool set_founder_story, needs listings:write)
• GET /api/v1/interview-questions: Founder interview questions (tool list_interview_questions)
• PUT /api/v1/me/interview: Answer founder interview questions (tool answer_interview, needs listings:write)
• POST /api/v1/me/listings/{listing_id}/free: Publish as a free listing (tool choose_free_listing, needs listings:write)

Claims

Claim and verify an existing listing (needs sign-in)

• POST /api/v1/claims: Claim an existing listing (tool claim_listing, needs listings:write)
• POST /api/v1/claims/{claim_id}/verify: Check a claim now (tool verify_claim, needs listings:write)
• GET /api/v1/claims: Your claims (tool list_my_claims, needs account:read)

Orders

Prices, VAT preview and secure checkout links (needs sign-in to build an order)

• POST /api/v1/orders/quote: Price an order (with VAT preview) (tool quote_order, needs orders:write)
• POST /api/v1/orders/checkout: Get a secure checkout link (tool create_checkout, needs orders:write)
• GET /api/v1/orders: Your orders (tool list_my_orders, needs account:read)
• GET /api/v1/orders/{number}: One order and its status (tool get_order, needs account:read)
• GET /api/v1/products: Products and prices (tool list_products)