Skip to main content
VistaroLaunch home

My listings API

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

Edit your live listings (needs sign-in)

GET/api/v1/me/listings

Your listings on this site. Every listing you own on this site (any status: draft, awaiting_badge, scheduled, live...).

MCP tool list_my_listings · needs account:read · paginated

InputWhereTypeDescription
pagequeryintegerPage number (1-based) (default 1)
per_pagequeryintegerItems per page (default 20)
curl "https://vistarolaunch.com/api/v1/me/listings" \
  -H "Authorization: Bearer $API_KEY"

GET/api/v1/me/listings/{listing_id}

One of your listings. Your listing with its status, plan, launch week, unlocked paid sections and everything public.

MCP tool get_my_listing · needs account:read

InputWhereTypeDescription
listing_id requiredpathintegerYour listing id (from list_my_listings or submit_draft)
curl "https://vistarolaunch.com/api/v1/me/listings/1" \
  -H "Authorization: Bearer $API_KEY"

PATCH/api/v1/me/listings/{listing_id}

Edit your listing. Change your listing's facts and wording. Edits publish at once, are kept in the version history and the site team sees a before/after copy. Listings you submitted through a draft can also be edited with update_draft (it keeps the website evidence).

MCP tool update_my_listing · needs listings:write · accepts Idempotency-Key

InputWhereTypeDescription
listing_id requiredpathintegerYour listing id (from list_my_listings or submit_draft)
fieldsbodyobjectFields to change (company facts + this site's headline/summary/SEO)
socialsbodyobjectCompany links by platform (replaces all)
faqsbodyarrayReplace all FAQs
curl -X PATCH "https://vistarolaunch.com/api/v1/me/listings/1" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

POST/api/v1/me/listings/{listing_id}/updates

Post a 'what's new' update. Publishes a short update on your listing (feeds the site's latest-updates page; followers are told).

MCP tool post_listing_update · needs listings:write · accepts Idempotency-Key

InputWhereTypeDescription
listing_id requiredpathintegerYour listing id (from list_my_listings or submit_draft)
title requiredbodystringHeadline
body requiredbodystringThe update (plain text)
curl -X POST "https://vistarolaunch.com/api/v1/me/listings/1/updates" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "\u2026", "body": "\u2026"}'

POST/api/v1/me/listings/{listing_id}/milestones

Add a milestone. Adds a dated milestone (first customer, funding, launch...) to your listing. Milestones show publicly on paid listings (or when the section is unlocked).

MCP tool add_milestone · needs listings:write · accepts Idempotency-Key

InputWhereTypeDescription
listing_id requiredpathintegerYour listing id (from list_my_listings or submit_draft)
date requiredbodystringYYYY-MM-DD
title requiredbodystringTitle
descriptionbodystringDetails
urlbodystringLink https://...
curl -X POST "https://vistarolaunch.com/api/v1/me/listings/1/milestones" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date": "\u2026", "title": "\u2026"}'

DELETE/api/v1/me/listings/{listing_id}/milestones/{milestone_id}

Delete a milestone. Removes one milestone from your listing.

MCP tool delete_milestone · needs listings:write · accepts Idempotency-Key

InputWhereTypeDescription
listing_id requiredpathintegerYour listing id (from list_my_listings or submit_draft)
milestone_id requiredpathintegerMilestone id
curl -X DELETE "https://vistarolaunch.com/api/v1/me/listings/1/milestones/1" \
  -H "Authorization: Bearer $API_KEY"

PUT/api/v1/me/listings/{listing_id}/story

Write or update your founder story. Saves your founder story on this site (sections: story, why_started, problem, journey, challenges, achievements, lessons, whats_next). Your own words only; it is published with your listing.

MCP tool set_founder_story · needs listings:write · accepts Idempotency-Key

InputWhereTypeDescription
listing_id requiredpathintegerYour listing id (from list_my_listings or submit_draft)
titlebodystringStory title
storybodystringstory
why_startedbodystringwhy started
problembodystringproblem
journeybodystringjourney
challengesbodystringchallenges
achievementsbodystringachievements
lessonsbodystringlessons
whats_nextbodystringwhats next
curl -X PUT "https://vistarolaunch.com/api/v1/me/listings/1/story" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

GET/api/v1/interview-questions

Founder interview questions. The interview questions founders can answer on their profile (answer with answer_interview).

MCP tool list_interview_questions · public, no sign-in

curl "https://vistarolaunch.com/api/v1/interview-questions"

PUT/api/v1/me/interview

Answer founder interview questions. Saves your answers (your own words) to interview questions on your founder profile.

MCP tool answer_interview · needs listings:write · accepts Idempotency-Key

InputWhereTypeDescription
answers requiredbodyarrayAnswers
curl -X PUT "https://vistarolaunch.com/api/v1/me/interview" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"answers": "\u2026"}'

POST/api/v1/me/listings/{listing_id}/free

Publish as a free listing. Chooses the free plan for a submitted listing: it is queued for a launch week 6-8 weeks out (site setting) and goes live once our badge is found on your homepage (get_badges gives the code). Paid plans go live faster: see list_products and create_checkout.

MCP tool choose_free_listing · needs listings:write · accepts Idempotency-Key

InputWhereTypeDescription
listing_id requiredpathintegerYour listing id (from list_my_listings or submit_draft)
curl -X POST "https://vistarolaunch.com/api/v1/me/listings/1/free" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Need help?