---
title: "Get audience affinity / genre adjacency for an agent (BETA)"
method: GET
path: "/v1/agents/{id}/affinity"
tags: ["Content Research Agents"]
---

# Get audience affinity / genre adjacency for an agent (BETA)

`GET /v1/agents/{id}/affinity`

## Request

- Base URL: `https://api.virlo.ai`
- URL: `https://api.virlo.ai/v1/agents/{id}/affinity`
- Auth: HTTP bearer

**BETA** — directional signal, methodology may evolve. Genre-adjacency derived from the agent’s corpus: dominant creator topics, co-occurring hashtags, and co-occurring sounds. This is NOT a follow-graph. Free — reads on already-paid-for data.

## Path parameters

- `id` string, required

## Response `200`

Audience affinity signals

- AgentAffinityResponseDto
  - `data` object, required: Genre adjacency derived from the niche corpus (exploratory). `creator_topics` = dominant topics from curated outlier creators; `related_hashtags` = co-occurring hashtags; `related_sounds` = co-occurring sounds. NOT a follow-graph.

## Other responses

- `401`: Missing or invalid API key (`missing_api_key` / `invalid_api_key`)
- `404`: Agent not found
- `429`: Rate limit exceeded (`rate_limit_exceeded`); see the Retry-After header

---

[API](https://skmtc.dev/virlo/apis/virlo-public-api.md) · [All operations](https://skmtc.dev/virlo/apis/virlo-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/virlo/apis/virlo-public-api/revisions/3b69c6145087?raw)