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

Add subscription plans to 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 several thousands of developers that subscribe to APIs. Allowing developers to subscribe to your API with a single click and test it out from a browser using RapidAPI makes it likelier that they will convert to active users. 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 Payout Preferences page.

How to add pricing plans to your API

After you upload your API, head to the "pricing" tab while you are in editing mode. You'll see two tabs underneath the pricing tab ("Plans" and "Private Plans"). This section will address both public subscription plans (ones that everyone can see) and custom plans (private subscription plans that are visible only via a shared link).


To create public subscription plans, take the following steps:

  1. Within your API, navigate to the "Plans" submenu under the Pricing tab
  1. Decide which subscription plans 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

Most API plans are priced by a daily or monthly quota by number of API requests.

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.

You can also customize your subscription plan to include features non-related to the API. 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. We get it. Read onto the "Custom Quotas" section for how to add more flexibility to your subscription plans.


You'll notice that each pricing page gives developers the option to reach out to API providers about custom or private plans. Read about how to build a private plan and their best use cases in the Private Subscription Plans section.

Adding custom quotas

Some APIs have pricing models that are more complicated than a simple call limit. For example, here is an API where it is more expensive for the provider to upload an image than request it. 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, like API Requests, Videos, Messages, etc. Also, you can enable or disable features according to each plan: This relies on allowing specific users access to different endpoints.

Default Quota Behavior

By default, RapidAPI increments each quota by one unit on every request, with the exception of response code errors (the famous 500 family). 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 with an arbitrary number of units by setting a special header in the API response in the following format:

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

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

X-Mashape-Billing: Messages=10

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

X-Mashape-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 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.