Modelo de datos - Profound

Tu Organization contiene muchas Categories. Cada Category contiene sus Assets (las marcas que sigues), agrupados en Topics, compuestos por Prompts. Cada Prompt se despliega luego en cuatro dimensiones (Platform, Region, Persona y Tag), que es como los informes segmentan los datos.

Referencia de entidades

Entidad	Qué es
Organization	Tu cuenta de Profound. Tiene muchas Categories.
Category	Un espacio de trabajo, normalmente una marca y su conjunto competitivo. Cada consulta de informe se limita a una Category.
Asset	Una marca, empresa o producto seguido en la Category. Tiene `is_owned`, `website` y `alternate_domains`.
Topic	Una agrupación de prompts relacionados (p. ej., “Precios”, “Integraciones”).
Prompt	Una pregunta recopilada frente a modelos de IA (p. ej., “¿Mejor CRM para startups?”).
Platform	La superficie de IA que respondió (ChatGPT, Claude, Perplexity, …). Se llama `model` en los parámetros de la API.
Region	El país al que se limita la respuesta (EE. UU., Reino Unido, Alemania, …).
Persona	Un perfil de audiencia (p. ej., “propietario de una pequeña empresa”).
Tag	Una etiqueta de formato libre aplicada a un Prompt.

Qué significa esto para las consultas

Cada llamada de informe se limita a un category_id. No hay consultas entre categorías.
filters restringen qué prompts contribuyen: por asset_name, topic_id, tag_id y similares.
dimensions desglosan los resultados por segmento: model, region, persona o tag.

Endpoints por entidad

Entidad	Endpoint de listado
Categories	`GET /v1/org/categories`
Topics	`GET /v1/org/categories/{id}/topics`
Prompts	`GET /v1/org/categories/{id}/prompts`
Tags	`GET /v1/org/categories/{id}/tags`
Assets	`GET /v1/org/categories/{id}/assets`
Personas	`GET /v1/org/categories/{id}/personas`
Platforms (nivel de organización)	`GET /v1/org/models`
Regions (nivel de organización)	`GET /v1/org/regions`

Haz clic en cualquiera de los endpoints anteriores para ir a su referencia completa de parámetros.