Keyword briefs

Open any keyword on SEO results and you can generate a brief: a comparison between your page and the five pages currently ranking above it, turned into instructions someone could work from.

It reads your ranking page and each of the top five, then looks for what they cover, structure, or answer that yours does not. A subtopic that several of the top results share and yours lacks is the strongest signal available here, so the brief calls those out by name rather than offering general advice.

Briefs are stored, and dated

A brief is written once and kept. Re-opening the keyword shows the stored copy immediately — no waiting, and no cost. It is always shown with the date it was written, because it is a snapshot of a moment in the search results and acting on a months-old comparison without knowing its age is a real way to waste an afternoon.

When a newer scan has landed since the brief was written, it is marked New results since. That is not a warning that the brief is wrong — the advice usually still holds — only that the comparison describes the previous week's page. Refresh when the marker appears and the keyword matters.

Refreshing, and why there is a limit

Reading a brief is free and unlimited. Generating or refreshing one is not: it reads six pages and runs a language model, so each account gets a number of refreshes per week.

Plan	Refreshes per week
Free	5
Starter	8
Pro	25
Multi-Pro	75

The allowance is account-wide — an agency spends it wherever that week's work is, rather than having it stranded per domain — and it resets every Monday.

Weekly rather than monthly is deliberate. A brief is built from the week's search results, so it only goes stale when a new scan lands; a weekly ceiling matches what the data can actually say. A monthly ceiling of comparable size could be spent in a single afternoon by a script, which is the case the limit exists for.

If you need more, +50 refreshes per week is $15/month and stacks — add as many as you need. In practice, working in the app, you are unlikely to reach even the plan allowance: you open a handful of keywords, and re-opening a brief you already have costs nothing.

What a brief will not do

• It names the pages it actually read. Some sites block automated access; when one does, the brief says so and tells you how many of the top five it worked from. "Compared with the top 5" is a claim you can check, not a round number.
• It will not invent facts about your business. Recommendations come from what is on the pages, not from assumptions about what you sell.
• With no stored search results, it says so. A keyword that has never been scanned produces a brief based on your page alone, clearly labelled — run a rank check first for the comparison that makes it useful.

Over the API

Both halves are available, and split the same way: GET /v1/keyword-briefs reads stored briefs for free, and POST /v1/keyword-briefs generates or refreshes one against the weekly allowance. Sync from the GET; spend on the POST. See the API reference and spending and quotas.