---
title: "Controller Adhoc Insights"
method: POST
path: "/stats/insights/adhoc"
---

# Controller Adhoc Insights

`POST /stats/insights/adhoc`

Generates an adhoc insight

## Request body

- InsightsPayload
  - `audience_id` string, required — Audience ID to generate insights for
  - `insight_context` 'AGE' | 'GENDER' | 'ETHNICITY_PREDICTION' | 'EDUCATION' | 'MARITAL_STATUS' | 'LOCATION' | 'STATE' | 'OCCUPATION' | 'HOUSEHOLD_MEDIAN_HOMEVALUE_BY_STATE' | 'PRESENCE_OF_CHILDREN_IN_HOUSEHOLD' | 'NUM_PEOPLE_IN_HOUSEHOLD' | 'HOUSEHOLD_OWNS_HOME' | 'AGE_OF_CHILDREN_IN_HOUSEHOLD' | 'NUMBER_OF_CHILDREN_IN_HOUSEHOLD' | 'INCOME' | 'GENERAL_INTERESTS' | 'SPORTS_INTERESTS' | 'READING_INTERESTS' | 'TRAVEL_INTERESTS' | 'CAR_BRANDS' | 'CAR_TYPES' | 'CAR_MAKE_MODEL' | 'CAR_FUEL_TYPES' | 'CAR_SIZE' | 'FINANCIAL_HEALTH' | 'NET_WORTH' | 'CREDIT_CARDS' | 'INVESTMENTS' | 'MEDIA_APPS' | 'MEDIA_NETWORKS' | 'MEDIA_TOP_TITLES' | 'MEDIA_TOP_GENRES' | 'MEDIA_INPUT_DEVICES' | 'PURCHASE_CATEGORY' | 'PURCHASE_AVERAGE_SPEND' | 'ONLINE_CONTENT_CONSUMPTION' | 'POI_CATEGORIES' | 'POI_CHAINS' | 'COUNTS', required
  - `filters` object, required — Filters to generate insights for
  - `timeframe` SrcStatsInsightsModelTimeframe
    - `timeframe_start` string, date-time, required
    - `timeframe_end` string, date-time, required

## Response `201`

Successful Response

- boolean

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/akk/apis/fastapi.md) · [All operations](https://skmtc.net/akk/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/akk/fastapi/revisions/6662a407c637/schema)