Attribution, Linking and Rate Limits

On this page we'll discuss some specific rules of the road that you'll need to follow when accessing and displaying data from the Marvel Comics API on your web site or application. These rules of the road basically boil down to:

    • Understand your rate limit.
    • Attribute Marvel as the source when displaying API data.
    • Link to Marvel when you display large images.

Rate Limits

You will only be able to call most services a certain number of times within a particular time period (calculated on a rolling basis). Most services default to 3000 calls per day but some services may have different rate limits. You can view your particular rate limits on your developer account page. If you attempt to make more API calls to a service than your allotted amount, the call will be rejected by the Marvel Comics API. A call rejected for exceeding a rate limit will return an HTTP status code of 429 and an error message indicating that your rate limit has been surpassed.

Note: Rejected calls still count against your limit, so if you do exceed your allotted call volume, please stop making requests until you are back in compliance with your personal rate limit

If you have questions about your rate limit, please contact us using the help form.

Tips for staying within rate limits:

Here's some best-practices to help reduce the number of requests you make to the Marvel Comics API and to help keep you within your rate limit.

    • Cache results. You may not cache results indefinitely (and our data does change on a regular basis so caching for long periods of time will make your results out of date), but caching API call results for limited amounts of time is OK. Caching calls for 24 hours is usually a good amount.
    • Only make the calls you need. Only make calls that are necessary to display information pertinent to your application. Don't pre-load information your users haven't asked for.

Attribution

You must attribute Marvel as the source of data whenever you display any results from the Marvel Comics API. Please use the following text on every application screen or web page which displays the API result: "Data provided by Marvel. © [the current year] Marvel"

Linking to Marvel

Linking from your application and web pages to Marvel helps us understand how applications are being used by end-users, which applications are most successful, and which presentations of Marvel content is most impactful, all of which helps us improve our API products.

You must link to Marvel whenever you show any information from the API beyond the title and small (100px width or smaller) thumbnail of an entity. For example, displaying a set of comics with only the title and small thumbnail would require only the attribution language above. If that same set were displayed with any additional information, each comic would need to have a link back to one or more of the URLs associated with that comic.

Links from URL arrays

Most entities return URL arrays, which are one or more public URLs associated with an entity. For example, a comic may have a URL array that contains a link to its detail page on Marvel.com, a link to purchase it on the web, and a link to the Marvel digital comics reader for that comic.

If a URL array is present for an entity, please use one of the links provided when linking back to Marvel. Feel free to use any of the URLs present, whichever makes most sense for your application. (URL block links are automatically tagged with your API key so that we can properly credit your web site or application with any traffic driven from your link.)

Linking back when no URL array is present

If a URL array is not present for an entity simply link to the Marvel.com homepage (http://marvel.com) in your attribution notice.