Recipes
Recipe: Where do we stand against our competitors?
Read share-of-voice standing with ranks and movement, then find the topics where a rival currently leads.
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Read share-of-voice standing with ranks and movement, then find the topics where a rival currently leads.
investigate(projectId, question="competitive_position", days=30)
get_share_of_voice(projectId, compare="previous_period")
get_topic_analysis(projectId, days=30)
get_topic_analysis(projectId, view="prompts", topicId="<contested topic>")
search_sources(projectId, topicId="<contested topic>")
get_source_detail(projectId, level="domain", domain="<a source they own>")
get_share_of_voice(projectId, group_by="date", days=90)
| What you see | What it usually means |
|---|---|
| Your share fell, absolute visibility flat | You did not get worse — someone else got better. Respond to them, not to your own content. |
| Your share rose, absolute visibility flat | A rival lost ground. Worth understanding why before assuming it holds. |
| Strong overall, weak on several topics | The usual shape. Topic gaps are where the remaining share actually is. |
| A rival leads a topic you do not cover | Not a loss — an unentered market. Cheaper to win than a contested one. |
| One rival gaining across every topic | A category-level move (a launch, a campaign, a partnership), not a topic problem. |