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.

Your key can expire if we detect an infringement.