> For the complete documentation index, see [llms.txt](https://hitsubscribe.gitbook.io/home/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hitsubscribe.gitbook.io/home/osiris/ranking/primary-keyword-rankings.md).

# Primary Keyword Rankings

In this report, you can see your rankings for every URL with an identified primary keyword.  Compared to the [Important to Own](/home/osiris/ranking/important-to-own.md) view, this is your master list of all relevant keywords.

This report is structured as a heatmap, with the map reflecting the relationship between where the mode expects you to rank and where you actually rank.  Overperformers are at the top and underperformers at the bottom.

Here are the columns in the chart:

* URL: the URL targeting the keyword.
* Keyword: the keyword for which the URL is trying to rank.
* Last Touched: the last time an intervention (published/refresh) was performed on the URL.
* Projected: the rank our model projects you should have for this keyword.
* Actual: where you're actually ranking for it.
* Gap: the difference between expectation and reality.

You can filter this report, like [the Refresh Candidates report](/home/osiris/actionables/refresh-candidates.md), by omitting content touched within the last X months.  The reason for this is that it'd be a little noisy to see ranking data about URLs that you just published or just refreshed.

Here's what the report looks like.

<figure><img src="/files/mJRFJs3dLOTaEkVCj7a7" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://hitsubscribe.gitbook.io/home/osiris/ranking/primary-keyword-rankings.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.