Skip to main content
The ZeroRank API (application programming interface) lets your own programs talk to ZeroRank. You can read your results and manage your prompts, brands, tags, and topics. It uses plain web requests, so it works from almost any language.
A prompt is a question we ask AI engines for you. A chat is the answer an AI engine gave back. The API can read both.
Think of each part of the API as a labeled drawer. You open the one you need and take out just those things.

​
Who can use it

The API comes with every paid plan. That means Starter, Pro, Enterprise, and AppSumo plans. Your subscription just needs to be active or in its free trial.
The free tier cannot use the API. You need a paid plan or an active trial. Without one, requests are refused.

​
The base web address

Every request goes to the same base address:
You add the path for what you want on the end, like /prompts or /brands.

​
Every request needs a key

You send a key with each request. You put it in the Authorization header.
A key is tied to one workspace. It only ever sees that workspace’s data.

Make and use a key

Learn how to create a key, pick what it can do, and keep it safe.

​
How fast you can go

Each key can make a set number of requests per minute. The number grows with your plan. We send three headers back on every request so you can watch your limit:
  • X-RateLimit-Limit — your limit for the minute.
  • X-RateLimit-Remaining — how many requests you have left.
  • X-RateLimit-Reset — when the count starts over.
Go over the limit and you get a 429 reply. Wait the number of seconds in the Retry-After header, then try again.

​
What comes back

Every reply is JSON — JavaScript Object Notation, a simple text format that programs read. A reply that worked has the same shape:
When something goes wrong, success is false and message tells you why:

​
What you can do

Pick a group on the left to see each request, or jump in here:
  • Workspace — check the workspace, plan, and key behind a request.
  • Prompts — list, create, update, delete, and run prompts.
  • Brands — manage the brands you track, including competitors.
  • Tags and topics — label and sort your prompts.
  • Analytics — read your top sources, recent chats, and brand rankings, or pull a single chat’s full answer with every URL it cited.

​
Prefer plain chat?

You do not have to write code to reach your data. The MCP server lets your AI assistant read it for you in plain chat. MCP is short for Model Context Protocol.

​
Keep going

Authentication

Create a key and send it with your requests.

MCP server

Ask your AI assistant about your data in plain chat.