Audiences
The Audience service manages target audiences — demographic segments that define who your content is for and who your digital twins represent.
Concepts
Target Audiences
A target audience is a demographic profile with attributes like:
- Age range — Minimum and maximum age
- Location — Residence, country
- Gender distribution — Percentage breakdown across male, female, non-binary
- Interests — What the audience cares about
- Pain points — Problems they experience
- Needs — What they're looking for
Default Target Audiences
Each workspace can mark one target audience as the default. The default is used when a request needs an audience but none is specified. See Default Target Audiences.
Endpoints
All endpoints use the base path: https://app.neuroflash.com/api/audience-service
| Method | Endpoint | Description |
|---|---|---|
POST | /v1/workspaces/{id}/target-audiences | Create a target audience |
GET | /v1/workspaces/{id}/target-audiences | List target audiences |
GET | /v1/workspaces/{id}/target-audiences/{id} | Get a target audience |
PUT | /v1/workspaces/{id}/target-audiences/{id} | Update a target audience |
DELETE | /v1/workspaces/{id}/target-audiences/{id} | Delete a target audience |
GET | /v1/workspaces/{id}/target-audiences/{id}/image | Get audience image |
PUT | /v1/workspaces/{id}/target-audiences/{id}/image | Update audience image |
DELETE | /v1/workspaces/{id}/target-audiences/{id}/image | Delete audience image |
GET | /v1/workspaces/{id}/default-target-audience | Get the default target audience |
PUT | /v1/workspaces/{id}/default-target-audience | Set the default target audience |
GET | /v1/workspaces/{id}/default-target-audiences | List default target audiences |