# Ranqo API

> Read your Ranqo data from your own tools with an API key. Brands, visibility, competitors, prompts, answers, audits and recommendations.

Source: https://ranqo.ai/docs/api

The Ranqo API gives your own tools read access to what the dashboard shows: your brands, their visibility and competitors, the prompts you track and the answers AI gave them, Site Access, page audits, Action Center recommendations and Outreach targets. Use it to feed a BI dashboard, a client report or an agent.

It is read-only JSON over HTTPS at `https://api.ranqo.ai/v1`. Every request carries an API key in its `Authorization` header. The whole API is described in an [OpenAPI document](https://ranqo.ai/docs/openapi.json) you can load into an API client or a code generator.

## Who can use it

API access is included on Pro and above, and a plan in its trial has the same access. Each key's rate limit depends on the plan:

| Plan | Requests per minute | Active keys |
| --- | --- | --- |
| Starter | Not included | Not included |
| Pro | 60 | 5 |
| Agency Growth | 120 | 10 |
| Agency Scale | 300 | 25 |

Business is a custom plan with limits set together with you. [Book a demo](https://ranqo.ai/#book-demo) to shape one. Keys are created and revoked by the account owner, in the **API keys** section of [Settings](https://app.ranqo.ai/settings); teammates cannot create them.

## The same numbers as the dashboard

The reports are computed by the code behind the Visibility page, over the same window and filters, and rounded the way the page prints them. For the same period, filters and time zone, a figure the API returns matches the page. Two differences to know:

- The dashboard counts days in your browser's time zone. The API counts them in `tz`, and in UTC when you leave it out, so send your zone to get the page's figures. See [Dates and time zones](https://ranqo.ai/docs/api/dates-and-time-zones).
- The Competitors page reads a 365-day or custom period as 7, 30 or 90 days. The API reads the window you ask for, so over those periods its competitor figures can differ from that page.

Where a field differs in any other way, its reference page says so.

## Start here

  - [Quickstart](https://ranqo.ai/docs/api/quickstart): Create a key and make your first requests.
  - [Authentication](https://ranqo.ai/docs/api/authentication): How keys work, where to send them and how to keep them safe.
  - [Errors](https://ranqo.ai/docs/api/errors): Every error the API returns, and what to do about it.
  - [Dates and time zones](https://ranqo.ai/docs/api/dates-and-time-zones): How report windows are set and how a window with no run is read.

## What you can read

  - [Brands](https://ranqo.ai/docs/api/reference/list-brands): The brands a key can read, with their latest run's scores.
  - [Visibility](https://ranqo.ai/docs/api/reference/get-visibility): Visibility, share of voice, position and sentiment over a window.
  - [Competitors](https://ranqo.ai/docs/api/reference/list-competitors): The brands AI names alongside yours, ranked.
  - [Prompts and answers](https://ranqo.ai/docs/api/reference/list-answers): The questions you track and what AI answered.
  - [Recommendations](https://ranqo.ai/docs/api/reference/list-recommendations): Action Center work and what it measurably changed.
  - [Site Access](https://ranqo.ai/docs/api/reference/get-site-access): Whether AI crawlers and search engines can fetch your site.