For API developers

API distribution: from a public example to the marketplaces

Developers adopt an API they can try in minutes. That makes distribution for an API different from any other product: the public example and the docs do the selling, and every marketplace, network and list builds on them. This plan puts the channels in order, quotes their real requirements and checks your OpenAPI file against them.

Short answer

  1. Make the first successful call trivial: one base URL, a key in one step, a request to copy and the real response next to it.
  2. Keep one OpenAPI file as the single source. Postman and RapidAPI both recommend importing it, and APIs.guru needs a stable URL to it.
  3. Then list where developers already search: the Postman API Network, the RapidAPI Hub if you want built-in billing, public-apis if you have a free tier, and APIs.guru for the definition itself.
  4. Launch once it works without a sales call: Show HN and Product Hunt, and an MCP server if AI applications should call your API as tools.

The channels in order

Each step reuses the work of the one before. Skipping the first two makes every later listing weaker.

ChannelWhat it gives youWhat it needsCost
1 Your docs and a public exampleThe page every other channel links to, and where developers decide.Base URL, auth in one step, a request to copy, its response, readable errors.Your time
2 Postman API NetworkDiscovery in Postman and in organic search; collections developers can fork.A public workspace with a reference collection imported from OpenAPI and an overview collection.No fee named in the publisher docs
3 RapidAPI HubIts user base, a search-optimized profile page, keys and billing.An API project (OpenAPI import), public visibility, pricing plans, PayPal for payouts.Free to list; 25% of payments
4 public-apisOne line in a curated list with 485k stars on GitHub.Free access or a free tier, HTTPS, Auth and CORS facts, a description of up to 100 characters.Free; marketing pull requests are rejected
5 APIs.guruYour definition in a public directory of API definitions.A stable URL to a machine-readable definition such as OpenAPI.No fee on the form
6 An MCP server for your APIAI applications can call your API as tools.A server that wraps your API, listed in the MCP registries.The main registries are free
7 Product HuntOne launch day in front of early adopters.A working public example and a page that non-developers understand too.Free
8 Show HNDevelopers who try things and say what they think.Something people can try right away, a plain title, you in the comments.Free

Channel names link to the official pages or to our profile of the platform. We name no other marketplaces here on purpose.

Start with a public example

Postman puts it in one sentence: success starts with the first 200 OK in the fewest steps. Write the example before any listing, because every listing will send people to it.

  1. One base URLPut it at the top of the docs and in the servers list of your OpenAPI file, always HTTPS.
  2. A key in one stepSign-up to key without a sales call. A test key or a free plan with a small quota is enough.
  3. A request to copyA complete command with every header. Developers paste it before they read anything else.
  4. The real responseShow the actual JSON that comes back, including the fields people need next.
  5. Errors that explainDocument the 4xx answers: missing key, wrong parameter, quota reached, each with its message.
curl "https://api.example.com/v1/forecast?city=Berlin" \
  -H "X-API-Key: $API_KEY"

HTTP/1.1 200 OK
{ "city": "Berlin",
  "days": [{ "date": "2026-10-01", "temp_c": 14.2 }] }

HTTP/1.1 401 Unauthorized
{ "error": "missing_api_key",
  "message": "Send your key in the X-API-Key header." }
A sample request and response in the shape your docs should show (example.com is a placeholder).

Check your OpenAPI file

Paste your openapi.json. The check reads what listing channels take from it (title, version, servers, operations, examples, auth) and shows which channel is ready. You get a Markdown plan and, if you qualify, the line in the public-apis format. It runs in your browser; nothing is uploaded.

What the file says: –

Checks

  • OpenAPI 3.x document
  • info.title is set
  • info.version is set
  • Description of at least 40 characters
  • One-line description of up to 100 characters
  • Public HTTPS server URL
  • At least one operation
  • Every operation has a summary or description
  • operationId values are unique
  • Request or response examples
  • Error responses on every operation (4xx, 5xx or default)
  • Auth type read for listings
  • Contact or docs link
  • Terms of service link

Ready for

  • Postman API Network
  • RapidAPI Hub
  • public-apis
  • APIs.guru

Line in the public-apis format

–

The check does not fetch URLs, call your API or submit anything. It only reads the text you paste.

Why the OpenAPI file matters

RuleOfficial wordingWhat it means for you
TitleThe title of the API.info.title is required; it becomes the name in every listing.
operationIdThe id MUST be unique among all operations described in the API.Duplicate IDs break imports and generated code; keep each one unique.
Import firstIf you have one, we strongly suggest you start by importing your file.Start the RapidAPI project from your OpenAPI file, not by hand.
Reference collectionPostman recommends you import your OpenAPI definition to create your API reference collection.Import the OpenAPI file; do not rebuild the requests.
DefinitionThe most important requirement is the presence of a machine-readable API definition in one of the popular formats, such as: OpenAPI (formerly known as Swagger), RAML, API Blueprint, etc.No machine-readable definition, no listing.
Stable URLSo please, provide us with a stable URL to the definition.Serve the definition at a URL that does not change between versions.

Selling through RapidAPI

RapidAPI is the marketplace most people mean when they ask how to sell an API. Listing is free; you pay a share of what you earn. New APIs start private, so a project does not appear in the hub until you make it public.

On a US$100 plan you receive US$75 at a 25% fee, paid out via PayPal. A free plan is capped at 1,000 requests per hour and 500,000 per month.

  1. Import your OpenAPI file when you create the project; it fills in endpoints and parameters.
  2. Write a short and a long description, set the category, website and base URL, and upload a logo.
  3. Offer a small free plan so developers can test, then paid plans with clear quotas and overages.
  4. Link PayPal before the first payout; Rapid pays providers no other way.
  5. Keep your own docs and pricing page: the marketplace is a channel, not your only storefront.
RuleOfficial wordingWhat it means for you
Listing costIt is also free and easy to add your API to the hub.Adding an API to RapidAPI costs nothing.
What you getAdding your API to the rapidapi.com hub gets you instant exposure to our growing user base, a search engine-optimized profile page for your API, as well as features like user management and billing services.A profile page, keys and billing come with the listing.
Private by defaultWhen a user or team creates an API, by default it is a private API.Switch the visibility to public, or nobody finds the API.
Free planHaving a free pricing plan (with a small number of requests available) is vital to a good experience for a developer using your API.A small free quota lets developers test before they pay.
Free limitsFree API plans are limited to 1000 requests per hour and 500K requests per month.Heavier usage needs a paid or pay-per-use plan.
Marketplace feeRapid takes a flat 25% marketplace fee on all payments made through the API Hub.Price your plans with the 25% share in mind.
PayoutsRapid currently only pays out API providers via PayPal.Link a PayPal account before you earn anything.

Postman, public-apis and APIs.guru

These three cost nothing and reach developers at the moment they look for an API. Each has its own rules; follow them and a listing stays.

RuleOfficial wordingWhat it means for you
First callThis starts with getting your API consumers to their first 200 OK response in the fewest steps possible.Measure your docs by how fast a stranger gets a 200 OK.
DiscoverySharing APIs on the Postman API Network increases your API’s discovery in organic and Postman search results.A public workspace shows up in Postman search and in web search results.
SecretsIf Postman detects any API keys, tokens, or similar, it replaces them with placeholders.Use variables for keys in public collections anyway.
Verified publisherVerify your team’s identity by verifying you own your domain.The badge needs a domain you control.
Free accessPlease make sure the API you want to add has full, free access or at least a free tier and does not depend on the purchase of a device/service before submitting.Paid-only APIs do not belong in this list.
No marketingPull requests that are identified as marketing attempts will not be accepted.Describe what the API does, not why it is the best.
DescriptionThe Description should not exceed 100 characters.Keep the line to 100 characters or fewer.

Launch the API

A launch works best after the example and at least one listing are live, so every visitor can make a call on the same day.

Show HN
Post when people can try the API without talking to you. A plain title, the example in the first comment and quick answers matter more than the hour. How to launch on Show HN →
Product Hunt
Show what the API makes possible, not only the endpoints: a short demo, a free plan and a page that a non-developer understands.
An MCP server
If AI applications should use your API, wrap it in an MCP server and publish that to the MCP registries. It is a separate product with its own listings. MCP server directories: 10 places to list your server →
Your changelog
Every new endpoint or SDK is a reason to post again. Keep a public changelog and link it from the docs.

Where LaunchRepo fits

LaunchRepo runs inside your coding agent. The agent submits your product’s website to a large catalog of directories and launch platforms and keeps a tracker that separates live listings from pending ones.

Marketplace accounts, pricing plans, payouts and the MCP server stay with you, because they need your keys and decisions. LaunchRepo does not submit APIs to RapidAPI, Postman or GitHub lists; it handles the general directory forms for your API’s website.

Sources

Every rule and number was checked on October 1, 2026 on the publisher’s own page and is quoted word for word in English. Text copies are kept with our evidence.

Frequently asked questions

How do I market an API?
Start with a public example that gets a stranger to a first successful call in minutes, then list the API where developers search: the Postman API Network, RapidAPI if you want built-in billing, public-apis for free APIs and APIs.guru for the definition. Launch on Show HN and Product Hunt once it works without your help.
How do I sell an API on RapidAPI?
Create an API project in RapidAPI Studio, import your OpenAPI file, fill in the hub listing, add pricing plans, make the API public and link PayPal for payouts. Listing is free; on the check date Rapid took a flat 25% marketplace fee on payments.
Do I need an OpenAPI file?
Not for every channel, but it saves the most work. RapidAPI and Postman both recommend importing it, and APIs.guru lists only machine-readable definitions. Keep one file as the single source for docs and listings.
Can a paid API go into the public-apis list?
Only if it offers full free access or at least a free tier and needs no purchase of a device or service. The maintainers reject pull requests that read as marketing.
Should my API also be an MCP server?
If AI applications should call it as a tool, yes, as a separate server that wraps the API. It is listed in MCP registries, not in API marketplaces.
Does LaunchRepo list my API on RapidAPI or Postman?
No. Those listings need your accounts, keys, pricing and payout details. LaunchRepo submits your product website to general directories and launch platforms through your coding agent.

Let your agent handle the directories

One purchase, your coding agent, every product you build: LaunchRepo submits your API’s website to directories and launch platforms while you improve the docs.

See pricing