Skip to content

Submit an API

There's no form. Every API on publicapis.lol comes from the public-apis list on GitHub, so to add one you open a pull request there with a single table row. Once it's merged, it shows up here after the next daily sync.

Open a pull request ↗Read the contributing guide ↗

How do I open the pull request?

  1. Click Open a pull request. GitHub opens the README in its editor and forks the repository for you.
  2. Find your API's category and add one row in alphabetical order.
  3. Click "Commit changes", then "Create pull request". Use the title Add Name API.
  4. Wait for the link check on the pull request to pass, and answer any review comments.

What does a row look like?

Each API is one line in its category's table:

| [Agify.io](https://agify.io) | Estimates the age from a first name | No | Yes | Yes |
  • API: The name, linked to the API's documentation. No TLD and no trailing "API": Gmail, not Gmail.com or Gmail API.
  • Description: What it does, in 100 characters or fewer.
  • Auth: One of No, apiKey, OAuth, X-Mashape-Key or User-Agent.
  • HTTPS: Yes or No.
  • CORS: Yes, No or Unknown. Without CORS an API only works server side.

What gets a pull request accepted?

  • The API must be free, or have a free tier, and must not require buying a device or service to use it.
  • One API per pull request.
  • Put it in the single category that best matches what it does, in alphabetical order.
  • Pad every table column with one space on each side.
  • Title the pull request "Add Name API", e.g. Add Blockchain API, and squash your commits into one.
  • Don't add a new version of an API that's already listed.
  • The API needs proper documentation, and the link check that runs on your pull request must pass.
  • Search open pull requests and issues first; your API may already be submitted.

The list isn't a marketing channel: pull requests that only promote a paid product are closed. The full rules are in the contributing guide.

What happens after it's merged?

Every day at 06:17 UTC this site reads the README and adds new APIs. Yours gets its own page with daily uptime checks, verified CORS support and code samples, and appears in its category, in search and in the JSON API.

Submitting an API

Is there a form to submit an API?

No. The public-apis GitHub repository is the source of truth for this site, so every API is added through a pull request there. There's no form, email address or paid listing.

How long until my API appears on publicapis.lol?

After the maintainers merge your pull request, the API appears on publicapis.lol after the next daily sync at 06:17 UTC. Review time on GitHub varies.

Can I submit a paid API?

Only if it has a real free tier. Pull requests that market paid-only products are closed, and so are APIs that are free but only work with a device or service you have to buy.

How do I submit an MCP server?

MCP servers go in the separate MCP Servers section of the README, with Name, Description, Auth, Transport and Install columns. The contributing guide lists the accepted values.

How do I fix or remove a listing?

Open a pull request that edits or removes the row, or open an issue on the repository describing what's wrong. The site picks up the change on the next daily sync.