Getting Started with the Metrics API

Last updated: October 29, 2026

The Metrics API gives you the same data you see in Rankscale, so you can pull it into your own reports, dashboards and tools. You can also use it to set up brands, topics and search terms automatically.

Is the API Included in your Plan?

The Metrics API is available on selected plans. See rankscale.ai/pricing for details.

What You Can Do with It

Area

What you can do

Reporting

Get dashboard metrics, search term results, sentiment, citations, sources, query fanout, shopping, ads, Local Results and Follow-up Forms data for any brand

Workspace management

Create, update and delete brands, topics and search terms, create or update up to 100 search terms in one request, start or pause search terms, and run a search term now

Raw run export

Export the individual runs of your search terms, optionally for a date range

Brand analysis

Find names that were wrongly counted as your brand or missed, manage the brand names used for matching, and recalculate metrics

Prompt research

Start a prompt research run and fetch its results

Credits

Check your credit balance and how long your credits will last

Create your API Key

  1. Click your name at the bottom of the sidebar to open Settings.

  2. Open the Integrations tab.

  3. In the REST API (Metrics API) card, click Generate API Key.

  4. Click the copy icon next to Your API Key and store the key somewhere safe.

The card now shows API Key Active, and your key is ready to use.

Keep your Key Secret

Anyone with your API key can read your data and change your workspace. Store it on a server, never in a website or app that others can open. If a key leaks, revoke it in the same card and generate a new one.

Who Can See What

An API key has the same permissions as the person who created it.

  • If you are a workspace member, your key only returns the brands you can see in Rankscale.

  • To change a brand, its topics or its search terms through the API, you need write access to that brand.

Tip: Agencies: to give a client API access to their brand only, invite them as a workspace member with access to that one brand, and let them create their own key.

Limits

Each API key can make up to 200 requests per minute. If you go over, wait a moment and try again.

Full Documentation

Every endpoint, with examples, is in Integration Docs in the account menu at the bottom of the sidebar. You can also reach it from the setup guide link in the REST API (Metrics API) card.