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
Imports
You can auto-generate target audience profiles from:
- Text descriptions — Describe your audience in natural language
- URLs — Extract audience data from web pages
- Files — Upload documents (PDF, etc.) with audience information
- Brand voices — Derive audiences from existing brand voice profiles
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 |
POST | /v1/workspaces/{id}/target-audience-imports | Import audience from text/URL/file |
GET | /v1/workspaces/{id}/limits/target-audiences | Get audience creation limits |