List tracked prompts for a project, each with a visibility status and per-model ranks.
Use this for ranks and visibility status. For the wording of an answer, call aiseo_list_snippets.
Why you need it
Every other visibility workflow needs the query list plus whether the brand shows up. Without this tool the agent guesses prompts or scrapes ChatGPT live.
Use it when you need to:
- Write a Monday summary of wins, gaps, and movement.
- Draft content for prompts where the brand is invisible.
- Compare ChatGPT vs Perplexity vs Gemini on the same query.
- Expand into adjacent prompts from clusters you already win.
Capabilities
- List tracked queries with ids and average rank.
- Classify each prompt as
winning,opportunities, ormissing. - Break out ranks by model (
chatgpt,perplexity,gemini,copilot,aioverview). - Filter by status so you can pull only gaps.
- Return a project-wide summary of counts (always for the full set, even when filtered).
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
projectSlug | string | Yes | From aiseo_list_projects |
status | string | No | winning, opportunities, or missing |
Status rules (from scan data):
| Status | Meaning |
|---|---|
winning | Brand has an average rank of 3 or better |
opportunities | Brand appears, but average rank is worse than 3 |
missing | No analyses yet, or no rank |
An invalid status is rejected. Omit it to get every prompt.