Skip to main content

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

MethodEndpointDescription
POST/v1/workspaces/{id}/target-audiencesCreate a target audience
GET/v1/workspaces/{id}/target-audiencesList 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}/imageGet audience image
PUT/v1/workspaces/{id}/target-audiences/{id}/imageUpdate audience image
DELETE/v1/workspaces/{id}/target-audiences/{id}/imageDelete audience image
POST/v1/workspaces/{id}/target-audience-importsImport audience from text/URL/file
GET/v1/workspaces/{id}/limits/target-audiencesGet audience creation limits