Join For Free

Mashape API Usage Alert Posted 9 months ago

As an API Marketplace, Mashape facilitates billing for API providers and consumers.  As such, we continuously strive to provide features and tools that help developers manage their API subscriptions.  

We are happy to announce that we are now sending usage alerts.  When you approach 80% of your subscribed plan limit, we’ll send you an email.

We hope that you find this feature useful in managing your API subscriptions.  As always, please feel free to send us a note at if you have comments and suggestions.

New Feature: Secret Parameter and Headers Posted 11 months ago

It’s been a while since we announced a new feature from Mashape, so we’re very excited to announce this one:  Secret Parameters and Headers for API providers.

What is a Secret Parameter/Header?

A Secret Parameter or Header are fixed key-value that is added to the request coming from the Mashape proxy to the API provider. Only API providers can set these values in their API.


What is it useful for?

One particular useful use-case for them is where developers have to sign up for separate accounts from the API provider and Mashape.  Having these values allow API providers to set a dedicated pre-registered account that can represent all users coming from Mashape to their API; or as an alternative identifying method.  These users can be further identified using the X-Mashape-User header that the API receives from Mashape.

The effect is a more streamlined process of API registration, testing, and consumption.  This saves developers the extra step of signing up for several accounts.  

You can set your Secret Parameters and Headers in your API Admin page, under the Proxy tab.  See video below:

We are encouraging all API providers to use this feature.  Let us know what you think! - 

API Terms & Conditions Page in Mashape Posted 1 year ago

You can now set up a Terms & Conditions page for your API in Mashape

(Example above from IDlight)

To write the Terms & Conditions page for your API, just go to your API Admin page and click on the “Terms and Conditions” tab:

Remember to set the Visibility to “Public” then hit Save.  It would then appear in your API profile page under “Terms and Conditions”

Important Changes to Mashape Authorization Keys Posted 1 year ago


In our effort to improve the way keys are handled in Mashape, we have changed the naming and more importantly the way keys are used in Mashape.  This is an important change so we recommend that you read on.


This change is immediate and is reflected NOW in your Mashape account (e.g. Dashboard, Mashape keys, test console, client libraries, etc)


After receiving feedback regarding the trouble and complexity of generating an authorization hash from your Mashape private and public keys, we decided to change and improve the way these keys are interpreted and generated.  One of the problems that arose from generating a hash is when someone intercepts it.  It will compromise your Mashape account in its entirety, leaving all your API access open to anyone who may have intercepted the hash.


To address this problem, we have removed the requirement to generate any hash.  Instead there will be two main keys for you to manage:

  1. Universal key Testing -  used for testing and will have access to every API
  2. Restricted keys Production- used in production, and can be restricted to consume only a specified group of APIs.  (In theory, you can create one restricted key for each API).

Both Testing and the Production keys can be re-generated anytime.


Below are the areas in Mashape where you will see the changes:

Client library (Ruby example below):




Keystore panel


Client library download


Where did my Public and Private Mashape keys go?

To ensure a smooth transition, your original Public and Private keys will still work in your applications.  We would however recommend that you start using the new Universal and Restricted keys moving forward.

We would love to hear your feedback.  Please email us at for any comments and suggestions.

Introducing the “Consume with Mashape” button Posted 1 year ago

You guys are gonna love this.  We now have a Mashape embed button that you can use on your page to link back to your Mashape API profile page.

We even let you customize the button color and icon!

To get your Mashape button, go to your API Profile page and click Admin.

We hope you’ll use the new Mashape button for your landing pages and developer documentation pages.  Let us know if you do!  We’d love to hear about it - Facebook and Twitter.

Report and Track API Issues in Mashape Posted 1 year ago

We just released a new section in the API profile page called “Issues” that would allow developers to report an issue or open a discussion with the API owner regarding his/her API.

Developers can open an API issue by navigating to “Issues” on the left-hand side panel of the API profile page, and clicking on “New Issue” button on the upper-right hand corner.

You can then proceed to type in the Title and Description/Comment for your issue and click “Submit” when done.  At this point, the API owner will see that the “Issues” navigation panel section will be highlighted in gray, with a number representing the number of issues that are currently open.

The discussion can then proceed with several options:

  • Developers can "Like" the issue (A useful indicator to API owners that it is a common issue that needs to be addressed)
  • Developers can add Comments to provide other useful information for the API owner 
  • The developer or the API owner can choose to Close the issue if it has already been addressed.  Closed issues can be tracked inside the Closed tab for historical purposes.
  • Developers can Un-follow the Issues if you want to opt out of the notifications from the comments.

We hope that this new feature will encourage a healthy and robust discussion between API owners and consumers/developers.  This will result to better APIs, and therefore a stronger API Marketplace.

Send us your feedback through Facebook, Twitter, or email us at

"Getting Started" section for your API Posted 1 year ago

One of the top requests we get from API providers in Mashape is to add a section where they can go beyond just plain text when providing more in-depth information about their API (e.g. introduction, usage guidelines, sample codes, etc).  This requires a level of formatting that simply cannot be achieved with just plain text.

Also, having information in one place as opposed to having several browser tabs open to read through the API usage information, can be quite a time-saver.

We have now added a “Getting Started” section for your APIs in Mashape.  It supports GitHub Flavored Markdown.

You can check the example API above here.  Notice on the left navigation panel that a “Getting Started” section has been added.

To add a “Getting Started” section for your own API, click on the “Admin” button in your API profile page and navigate to the “Getting Started” tab, like below:

Don’t forget to set your Markdown to Public once you’re done.

We hope that you will find this feature very useful when communicating the intended use for your API to developers.  We highly encourage everyone to try it out and provide us feedback on your experience with it.  Send us a message in Facebook, Twitter, or

Get Notified by Email when your API is down Posted 1 year ago

We just launched a small yet very important feature - an email notification to the API provider when the API is down.

This feature is in line with our commitment to provide API providers with the necessary tools to keep them on top of things, and be able to react quickly to their developers when the API is down (e.g. send out a message to acknowledge the downtime, issue out a fix, etc).

If you wish to turn off the notification for your API, you can do so by navigating to your API Admin -> Settings:

We hope you like this feature!  Let us know in Facebook, Twitter, or send us an email at

Status snapshot display for APIs Posted 1 year ago

We have just rolled out another cool feature in Mashape - the Status snapshot display of  Mashape APIs

Check out an example here.

This “quick glance” information provides both app developers and API providers with useful information such as whether the API is currently online or offline, average uptime, latency, and the same data spread out for a week on a graph.  The Status display is a huge timesaver (and will complement your good old debug and log outputs) in scenarios such as:

1. Planning - e.g. “What average timeout value should I set in my application to consume this API?”

2. Historical Analysis - e.g. “My Party Night API seems to take longer to respond during Fridays. Hmm.”

To access the Status of a Mashape API, go to its Profile page and click the “Status” link on the left navigation pane.

We’re excited to hear your inputs on this new Mashape feature.  Send us your message through Facebook, Twitter or email us at 

Small feature: login with your username Posted 2 years ago

While we are working on a lot of big features for the upcoming version of Mashape, we have added a small feature, that our users asked us:

now you can login using your email or your username (case insensitive)


Stay tuned.. something big is about to happen!