The RapidAPI Developer Hub

Welcome to the RapidAPI developer hub. You'll find comprehensive guides and documentation to help you start working with RapidAPI as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    Guides

Pricing Your API

Types of pricing

All APIs on RapidAPI fall into one of three categories.

  1. Free APIs

APIs that do not require a credit card or subscription plan to consume

  1. Freemium APIs

Paid APIs that include a limited free tier and require a credit card

  1. Paid APIs

APIs that require a paid subscription plan and credit card to consume

Free APIs do not require a developer to subscribe to your API on RapidAPI to consume. There are no quotas and you cannot collect payments through RapidAPI from their consumption.

If you wish to collect payments through RapidAPI, you will need to establish your API as a freemium or paid API. RapidAPI has thousands of developers that subscribe to APIs through RapidAPI. Allowing developers to subscribe to your API with a single click with their credit card that is already saved to their account and test it out from a browser using RapidAPI makes it more likely that they will convert to an active user. You can create pay-as-you-go pricing or subscription pricing plans in RapidAPI without any changes to your API.

Reimbursement for your API

You will receive payments when a developer subscribes to a paid API plan, when a plan is automatically renewed monthly or when a developer incurs an overage. You can read more about how reimbursements work in the Payouts and Finance section.

Marketplace Fee

RapidAPI takes a flat 20% marketplace fee on paid plans and overages. As an API provider, you will receive 80% of any developer subscriptions (first-time or recurring fees) and overages.

In order to receive PayPal payouts, log into and add your preferred email address to the Payment Settings page.

How to add pricing plans to your API

After you upload your API, head to the "Plans and Pricing" tab. This section will address both public subscription plans (ones that everyone can see) and custom plans (private subscription plans that are only visible to developers who have been invited to consume that pricing plan).


To create public subscription plans, take the following steps:

  1. Within your API, navigate to the "Plans & Pricing" tab of your API
  1. Decide how many subscription plans you would like to offer

You will have four potential subscription plans to offer developers: BASIC, PRO, ULTRA and MEGA. BASIC plans are the lowest tier subscriptions while MEGA plans are the highest. You do not have to have all four plans in your subscription.

Freemium API

If you want to have a Freemium API, be sure that your BASIC plan costs $0. Like other plans, you can add daily, monthly or object quotas for the APIs and overages fees if developers exceed them. We recommend a free BASIC tier for most APIs as many developers prefer to test API calls before they commit to a paid plan.

  1. Customize your subscription plans by adding daily/monthly API request quotas, pricing, and overages

You'll notice that these plans are priced by a monthly quota. If a developer goes over the monthly quota, they will incur an overage fee per additional call. We alert developers via email when they are approaching 85% of their quota limit and have reached their quota limit. For most APIs, we don't recommend an overage fee higher than $1 unless your cost of making the call is above $1.

Overages and Forgiveness

Occasionally, a developer will have a bug in his or her code that causes a large overage fee. RapidAPI cannot forgive an overage without explicit permission from the API provider. To read more about payouts and forgiveness policies, see our Payouts and Finance section.

  1. Add additional features to your pricing plan
    You can also customize your subscription plan to include features that are not directly related to the number of requests or custom objects that the API returns. Notice how this developer included support, development assistance and marketing assets as part of her subscription plan.
  1. Add more flexibility to your plans with custom quotas

Sometimes, a simple API call quota is not enough sufficient to meet your API's pricing needs. Read onto the "Adding Custom Quotas" section for how to add more flexibility to your subscription plans.

Adding custom quotas

Some APIs have pricing models that are more complicated than a simple 'Request' limit. For example, here is an API where it is more expensive for the provider to upload an image. You'll notice that the "Uploads" item allows fewer calls and has a higher overage fee than the "Requests" item.

If your API falls into a more complicated category, consider adding custom quotas to your API. Here's what you need to know.

Custom Quotas and Clarity

The more custom quotas that you have, the more likely a developer may become confused about your API's usage. This can result in fewer subscriptions and/or more disputed overage fees. When you add a custom quota, be as explicit as possible as to what the item is, how it will be incremented and what the quota counts.

You can create up to four custom quotas. Some examples of types of custom quotas are Videos, Messages, Downloads, Items Returned, etc.

Restricted Characters

Custom quota objects cannot include special characters like commas. On the marketplace, you may see an error of 'Parse Error' if the billing header contains a special character.

Default Quota Behavior

By default, RapidAPI increments each quota by one unit on every request, with the exception of response code errors. If your API returns an error code equal to or greater than 500, RapidAPI won’t increment the usage for that user.

Incrementing Quota by Endpoint

By having quotas whose usage is increased only when specific endpoints are being requested, it is possible to associate endpoints and quotas. Every time the user requests that specific endpoint, the associated quota will be increased by one unit.

Incrementing Quota by more than one Increment

It is possible to override the default behavior and increment the quotas by a different number of units by sending a special header in the API response in the following format:

X-RapidAPI-Billing: [Quota]=[Value]

For example, to increment the Messages quota by 10 units, you would add the following header to the response:

X-RapidAPI-Billing: Messages=10

You can increment more than one quota as well by separating the values with a semicolon, like so:

X-RapidAPI-Billing: Messages=10; Images=3; Audio=2

Again, if you decide to increment a certain quota by more than one, we highly recommend including that information in the object's description on the pricing subscription page. Adding this information explicitly will make it easier for developers to understand your API's usage limits.

Updating plans

You are able to disable previously published pricing plans at any time. Disabling a plan hides it from the marketplace so no new developers can subscribe to this plan. Developers that were subscribed to the plan before it was disabled will remain subscribed to the original plan.

You can make changes to an existing pricing plan and publish it at any time. Once you publish the modified plan, the changes will display on the marketplace immediately. New developers will only see the modified version of the plan and can subscribe to it. Developers that were subscribed to the previous version of the plan will remain subscribed to the previous version of the plan.

Pricing Your API

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.