Top 20 Over Time

What it does

Tracks who appears in top 20 per period and how positions change.

Why this is insightful

You can separate stable leaders from temporary spikes and detect who is entering/exiting competitive visibility.

Required API fields

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

How to use

1. Ingest snapshots for multiple periods.
2. Group by day/week.
3. Keep ranks <= 20.
4. Compute entrants, exits, retention, rank deltas.

Expected output

• top20_by_period[]
• entrants[], exits[]
• retention_rate_percent
• biggest_movers[]

Copy-ready skill prompt

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

Skill: Top 20 Over Time
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.