Authentication

Rumo requires an account to submit queries, and keys to authenticate requests.

Your API key carries many privileges. You should keep it secure. Do not share your secret API key in publicly accessible areas such as GitHub, client-side code, and so forth.

To authenticate with Rumo, name the x-api-key key in the header of your requests after the API key we send you during your registration process.

Your API key allows you:

  • to use one source;
  • to submit 2,000 content pieces;
  • up to 1,000 requests/second;
  • and up to 100,000 recommendation requests/month.

You have access to a free trial API key for 90 days after you first received it. Your key can expire earlier if we detect an infringement.