My listings API

Base URL https://businesslistinginfo.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

Input	Where	Type	Description
`page`	query	integer	Page number (1-based) (default 1)
`per_page`	query	integer	Items per page (default 20)

curl "https://businesslistinginfo.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

Input	Where	Type	Description
`listing_id` required	path	integer	Your listing id (from list_my_listings or submit_draft)

curl "https://businesslistinginfo.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

Input	Where	Type	Description
`listing_id` required	path	integer	Your listing id (from list_my_listings or submit_draft)
`fields`	body	object	Fields to change (company facts + this site's headline/summary)
`apply_to`	body	array	Also write the headline / summary / SEO fields changed in this call to the same company's listings on other sites: ["all"] or site keys. Only the fields you send travel. Default: this listing only.
`socials`	body	object	Company links by platform (replaces all)
`faqs`	body	array	Replace all FAQs

curl -X PATCH "https://businesslistinginfo.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

Input	Where	Type	Description
`listing_id` required	path	integer	Your listing id (from list_my_listings or submit_draft)
`title` required	body	string	Headline
`body` required	body	string	The update (plain text)

curl -X POST "https://businesslistinginfo.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

Input	Where	Type	Description
`listing_id` required	path	integer	Your listing id (from list_my_listings or submit_draft)
`date` required	body	string	YYYY-MM-DD
`title` required	body	string	Title
`description`	body	string	Details
`url`	body	string	Link https://...

curl -X POST "https://businesslistinginfo.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

Input	Where	Type	Description
`listing_id` required	path	integer	Your listing id (from list_my_listings or submit_draft)
`milestone_id` required	path	integer	Milestone id

curl -X DELETE "https://businesslistinginfo.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 of this product (the same story as your account's founder story editor; sections: how_started, problem, what_built, hard_parts, milestones, whats_next - the older names story, why_started, journey, challenges, achievements, lessons are still accepted and mapped). Only the sections you send change. Your own words only. It is published when it passes the founder story rules (minimum words and sections, a complete founder profile with photo); otherwise it is saved as a draft and `missing` lists what to do, each with a link. Response: title, url (the public story page once published, else your story editor), published_at (null while not published), shown_on_listing, status (published|draft), missing [{reason, url}] (empty once published).

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

Input	Where	Type	Description
`listing_id` required	path	integer	Your listing id (from list_my_listings or submit_draft)
`title`	body	string	Story title
`how_started`	body	string	how started
`problem`	body	string	problem
`what_built`	body	string	what built
`hard_parts`	body	string	hard parts
`milestones`	body	string	milestones
`whats_next`	body	string	whats next
`story`	body	string	story
`why_started`	body	string	why started
`journey`	body	string	journey
`challenges`	body	string	challenges
`achievements`	body	string	achievements
`lessons`	body	string	lessons

curl -X PUT "https://businesslistinginfo.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://businesslistinginfo.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

Input	Where	Type	Description
`answers` required	body	array	Answers

curl -X PUT "https://businesslistinginfo.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 some weeks out (the site's free-queue setting) once our badge is on your site and your founder profile is complete, and goes live in that week (get_badges gives the code). A paid launch goes live at once or in a week you choose and needs neither: see list_products and create_checkout. A free listing can be upgraded to a paid launch later with the launch product.

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

Input	Where	Type	Description
`listing_id` required	path	integer	Your listing id (from list_my_listings or submit_draft)

curl -X POST "https://businesslistinginfo.com/api/v1/me/listings/1/free" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

My listings API

GET/api/v1/me/listings

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

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

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

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

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

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

GET/api/v1/interview-questions

PUT/api/v1/me/interview

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