Skip to main content

Listings API

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

Search and read live listings

GET/api/v1/listings

Search and filter listings. Full-text search over this site's live listings (name, tagline, description, keywords; typo tolerant) with filters. Use `q` for words, or leave it empty to browse. `category` includes its subcategories. `domain` finds the listing of a website. Results are summaries; call get_listing for the full profile.

MCP tool search_listings · public, no sign-in · paginated

InputWhereTypeDescription
qquerystringSearch words, e.g. 'invoice software for freelancers'
categoryquerystringCategory slug (from list_categories)
stagequerystringBusiness stage slug, e.g. idea, mvp, launched, growing
countryquerystringISO 3166 two-letter country code, e.g. GB
pricing_modelquerystringPricing model, e.g. Free, Freemium, Subscription
domainquerystringWebsite domain, e.g. example.com
statusquerystringlive (published) or upcoming (scheduled for a future launch week) (one of: live, upcoming; default live)
sortquerystringOrder of results (one of: relevance, newest, votes, trending, most_viewed, most_followed; default relevance)
pagequeryintegerPage number (1-based) (default 1)
per_pagequeryintegerItems per page (default 20)
curl "https://debutdirectory.com/api/v1/listings"

GET/api/v1/listings/{slug}

Get a listing's full profile. Everything public about one listing: description, features, pricing, categories, founders, FAQs, socials, latest updates, community rating (genuine reviews only), Ahrefs Domain Rating with trend, and links. Paid-only sections (story, milestones, media) appear only when the listing has them unlocked, exactly as on the page. `not_found_on_website` lists facts the company's own site did not state (left blank on purpose).

MCP tool get_listing · public, no sign-in

InputWhereTypeDescription
slug requiredpathstringListing slug (from search_listings)
curl "https://debutdirectory.com/api/v1/listings/example-slug"

GET/api/v1/listings/{slug}/alternatives

Alternatives to a listing. Alternatives to one listing: those the owner approved first (approved=true), then other live listings in the same primary category. Good for 'what else is like X?'.

MCP tool get_alternatives · public, no sign-in

InputWhereTypeDescription
slug requiredpathstringListing slug
curl "https://debutdirectory.com/api/v1/listings/example-slug/alternatives"

GET/api/v1/compare

Compare two listings side by side. A side-by-side comparison of two live listings using their category attributes (stage, pricing, features and more). Empty cells mean the fact is not on either listing.

MCP tool compare_listings · public, no sign-in

InputWhereTypeDescription
a requiredquerystringFirst listing slug
b requiredquerystringSecond listing slug
curl "https://debutdirectory.com/api/v1/compare"
Ask us