New Entrant Detector

What it does

Detects brands newly entering top N and measures persistence.

Why this is insightful

Early entrant detection helps teams react before new competitors consolidate visibility.

Required API fields

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

Input params

• topN (default 20)
• minPersistencePeriods (default 2)

How to use

1. Detect first topN appearance.
2. Track consecutive retention periods.
3. Score entrant strength by entry rank + persistence.

Expected output

• new entrants list
• persistence score
• early winner candidates

Copy-ready skill prompt

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

Skill: New Entrant Detector
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.