Share of Voice Snapshot

What it does

Calculates brand visibility share using rank-weighted mentions from the latest snapshot.

Why this is insightful

Raw rank positions are hard to compare across many queries. This skill converts ranking presence into a single share metric so you can see which brands own AI visibility now.

Required API fields

• resultId
• query.keyword
• rankings.brands[].name
• rankings.brands[].rank
• recommendations[].type
• recommendations[].name

How to use

1. Ingest latest results once.
2. Normalize brand names.
3. Compute score per mention as 1/rank.
4. Aggregate by brand and convert to percentage share.

Expected output

• leaderboard: brand, weighted_score, sov_percent
• top 3 insights
• confidence score

Copy-ready skill prompt

Use this as a full copy/paste prompt in your AI tool:

Skill: Share of Voice Snapshot
Goal: Run this analysis on FullMention data only.
Data policy:
- Do one controlled ingestion pull from FullMention API.
- Store dataset locally (file/local DB) and analyze offline.
- No repeated API fetch loops during analysis.
Execution contract:
- Provide ingestion_plan, max_api_calls, cache_key, dataset_timestamp, analysis_mode=offline_only.
Required fields:
- Use the required API fields listed on this page.
Output requirements:
- Return summary, key metrics, and evidence_map with source_field_paths and sample_result_ids.
- Include limitations and confidence score rationale.