# Return a niche summary as JSON for my validation agent

> A fixed-schema summary of the niche behind an idea, with fields that say what Megido does not know.

**Who asks:** Data team building an idea-validation agent

## Example

**Question:** Return a JSON summary of the niche for the idea «habit tracker app» for my validation agent.

**Megido calls:**

- `search_cohorts`: 1 niche
- `get_cohort`: distributions

**Answer:**

```json
{"idea": "habit tracker app", "niche_id": "<id>", "niche": "Habit tracking & personal development apps", "size": "10-49", "median_index": 58,
 "share_growing": 33, "share_declining": 38,
 "scale": {"<500": 11, "500-3k": 16, "3k-15k": 32, "15k-75k": 24, "75k-1M": 14, "1M+": 3},
 "leading_countries": {"US": 40, "BR": 21, "IN": 19},
 "revenue_observed": true,
 "not_in_corpus": ["revenue", "prices", "trend_beyond_last_month"]}
```

Real data from the corpus, as of August 2026. Growth compares the latest month with the one before.

## How your agent answers

1. `search_cohorts` matched the idea to a niche.
2. `get_cohort` returned the niche's size, growth, scale and countries.

## Where it stops

The `not_in_corpus` field is fixed on purpose: Megido has no revenue, prices or trend beyond one month, and your agent should not fill them in. Ids are issued to each organization, so the example shows <id>.

## Ask your agent

```text
Return a JSON summary of the niche for the idea «[your idea]» for my validation agent.
```