Share of Voice Trend

What it does

Builds SOV time series and trend direction per brand.

Why this is insightful

You see momentum, not just a single snapshot. This helps detect whether visibility is compounding or decaying.

Required API fields

• createdAt
• query.keyword
• rankings.brands[].name
• rankings.brands[].rank

How to use

1. Compute SOV per period using weighted rank.
2. Build per-brand series.
3. Calculate slope and short-term momentum.

Expected output

• SOV trend series
• slope by brand
• momentum label: rising/flat/falling
• inflection points

Copy-ready skill prompt

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

Skill: Share of Voice Trend
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.