Plans & Pricing

How to create custom pricing plans for your API.

You have the full freedom to decide your API pricing and what pricing plans are available. All APIs on RapidAPI fall into one of four categories.

API TypeDescription
Free APIsAPIs that do not require a credit card or subscription to consume.
Pay Per UseAPIs that don't have a subscription fee associated with them. A credit card is required as you pay for what you use on the API.
Freemium APIsPaid APIs that also include a limited free tier. These require a credit card, even for the free plan.
Paid APIsAPIs that require a paid subscription plan and credit card to consume.

📘

Free APIs

Free APIs do not require a developer to subscribe to your API on RapidAPI in order to use it. There are no quotas and you can not collect payments through RapidAPI for the consumption of a free API.

Creating pricing attributes

Start by creating pricing attributes for your API. You can add billing objects or features to your plan.

Objects

You can add a new billing object by clicking the +Add New Object button. You must associate an endpoint with the object.

2866

Features

You can add a new feature by clicking the +Add New Feature button. Features can be added to plans to distinguish the difference between the plans and to incentivize plan upgrades.

2868

Creating pricing plans

👍

Our pricing recommendation

We generally recommend using all four of the available pricing tiers. Having a free pricing plan (with a small number of requests available) is vital to a good experience for a developer using your API. With a free plan, the developer is able to make a few test requests and guarantee the API functions as expected.

Then for the PRO, ULTRA, and MEGA plans, we recommend having a good distribution of pricing. Each API is different based on API operating costs, but in general, we have seen the following work well:

BASIC - Free with a Hard Limit in place
PRO - $25
ULTRA - $75
MEGA - $150

You can have up to four different pricing tiers. To add a plan to a tier, click the Add Plan

2390

You will then be directed to this screen, where you can set the type, price, rate limit, and base URL for the plan.

2388

You will notice that your plans will be priced by a monthly or daily quota. If a developer goes over the monthly quota, they will incur an overage fee for each call that exceeds the quota. RapidAPI alerts developers when they approach 85% of their quota limit and when they reach 100% of their quota limit. For most APIs, we don't recommend an overage fee higher than $1 unless your operating cost of making the call is above $1.

🚧

Overages and forgivness

Occasionally, a developer will have a bug in their code that causes large accidental overages. RapidAPI can not forgive an overage without explicit permission from the API Provider. To read more about payouts and forgiveness, see our Payouts and Finance section

Hard limits

To prevent developers from making any overages, you can set a hard limit. If a hard limit is in place, developers will be capped at the quota limit and will be blocked from making more calls once the limit is reached. Set a hard limit by selecting "hard limit" from the limit type dropdown.

1667

Customizing pricing tiers

You can customize which objects and features are associated with each pricing tier. This gives you the ability to set API request limits, as well as specify other features that are available with each plan. See the plan below for an example.

893

📘

Custom quotas

Learn more about creating custom quotas on our Custom Quotas doc

Embed a contract (DocuSign)

Embedding a contract will require the developers to e-sign it when subscribing to the plan. Currently, contracts are supported through DocuSign. This option is useful for APIs that might provide sensitive data or have special usage requirements.

To embed a contract, you need a DocuSign account. You will want to create a template in DocuSign for the contract you would like to embed in your pricing plan.

Edit the pricing plan you would like to embed the contact in. If you have multiple plans, you will have to add the DocuSign template to each plan. Click the Login With Docusign button, and select your desired template. Save the plan once you have completed these steps.

📘

When a developer subscribes to your API, they will be redirected to the DocuSign contract. They will only be successfully subscribed to the API if they complete the e-signature.

Changing a pricing plan

You can disable or change a pricing plan at any time. Disabling a plan hides it from the RapidAPI Hub 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.

If you modify an existing plan, the changes will also display on the RapidAPI Hub 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.


What’s Next