---
title: "Controller Handle Audience Insights For Timeframe"
method: POST
path: "/stats/insights/timeframe/generate"
---

# Controller Handle Audience Insights For Timeframe

`POST /stats/insights/timeframe/generate`

Generate Content, Media and Purchase insights for a specific audience for a specific timeframe

## Request body

- TimeframeInsightsPayload
  - `audience_id` string, required — Audience ID to generate insights for
  - `timeframe` SrcStatsInsightsModelTimeframe, required
    - `timeframe_start` string, date-time, required
    - `timeframe_end` string, date-time, required
  - `insight_group` MEDIA_TOP_GENRES,COUNTS,AGE,GENDER | COUNTS,AGE,INCOME,GENDER,HOUSEHOLD_OWNS_HOME | EDUCATION,LOCATION,MARITAL_STATUS,AGE_OF_CHILDREN_IN_HOUSEHOLD,NUMBER_OF_CHILDREN_IN_HOUSEHOLD,STATE,ETHNICITY_PREDICTION,PRESENCE_OF_CHILDREN_IN_HOUSEHOLD,OCCUPATION | NUM_PEOPLE_IN_HOUSEHOLD,HOUSEHOLD_MEDIAN_HOMEVALUE_BY_STATE | FINANCIAL_HEALTH,NET_WORTH,CREDIT_CARDS,INVESTMENTS | PURCHASE_CATEGORY,PURCHASE_AVERAGE_SPEND | GENERAL_INTERESTS,SPORTS_INTERESTS,READING_INTERESTS,TRAVEL_INTERESTS | MEDIA_APPS,MEDIA_NETWORKS,MEDIA_TOP_TITLES,MEDIA_TOP_GENRES,MEDIA_INPUT_DEVICES | CAR_BRANDS,CAR_TYPES,CAR_MAKE_MODEL,CAR_FUEL_TYPES,CAR_SIZE | ONLINE_CONTENT_CONSUMPTION | POI_CATEGORIES | 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,POI_CHAINS,COUNTS | INCOME,HOUSEHOLD_OWNS_HOME,NUM_PEOPLE_IN_HOUSEHOLD,PRESENCE_OF_CHILDREN_IN_HOUSEHOLD,NUMBER_OF_CHILDREN_IN_HOUSEHOLD,AGE_OF_CHILDREN_IN_HOUSEHOLD,HOUSEHOLD_MEDIAN_HOMEVALUE_BY_STATE, required
    - unknown

## Response `201`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

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