# Creadores similares

**API:** Data API

**Endpoint:** `POST /v1/beta/waveinflu/similar`

**Tags:** Creator Data

Encuentra creadores similares usando el target_account obligatorio. platform es opcional, usa youtube de forma predeterminada y admite instagram, tiktok y youtube. Sigue los filtros documentados para acotar los resultados. billingRequestId es una referencia del proveedor, no un recibo de facturación de Felo.

### Referencia de precios

- Medición: unidades de respuesta medidas.
- Estimación de referencia por solicitud: USD 0.124425.
- Base de costo unitario: USD 0.004977.
- Unidad de recurso: `similar_creator_point`.
- Multiplicador de referencia del cliente: 1.0. No lo apliques de nuevo a un importe de cliente ya liquidado.
- Las bases de costo no determinan el precio final del cliente, incluso cuando son cero.

Solo metadatos de referencia, no una cotización de la cuenta, un precio garantizado ni un límite de gasto. Los créditos de recursos no son créditos de Felo. Los cargos finales se rigen por los registros de facturación de Felo.

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Request body

Required: **yes**

### application/json

Schema:

```json
{
  "type": "object",
  "properties": {
    "platform": {
      "default": "youtube",
      "enum": [
        "instagram",
        "tiktok",
        "youtube"
      ],
      "type": "string"
    },
    "target_account": {
      "type": "string",
      "description": "Cuenta semilla: un identificador de creador (con o sin @) o URL de perfil para el que buscar creadores similares.",
      "example": "@onkimia"
    },
    "limit": {
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "filters": {
      "type": "object",
      "description": "Filtros opcionales aplicados antes de la coincidencia. Todos los campos son opcionales.",
      "properties": {
        "regions": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Regiones del creador (códigos de país ISO), por ejemplo [\"US\", \"GB\", \"JP\"]."
        },
        "languages": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Idiomas del creador, por ejemplo [\"en\", \"ja\", \"zh-cn\"]."
        },
        "minFollowers": {
          "type": "number",
          "description": "Número mínimo de seguidores / suscriptores."
        },
        "maxFollowers": {
          "type": "number",
          "description": "Número máximo de seguidores / suscriptores."
        },
        "minPlayCount": {
          "type": "number",
          "description": "Número mínimo de reproducciones / visualizaciones, medido por `playCountMetric`."
        },
        "maxPlayCount": {
          "type": "number",
          "description": "Número máximo de reproducciones / visualizaciones, medido por `playCountMetric`."
        },
        "playCountMetric": {
          "type": "string",
          "enum": [
            "median",
            "average"
          ],
          "description": "Si `minPlayCount` / `maxPlayCount` se comparan con la mediana o con el promedio de reproducciones."
        },
        "genders": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Géneros de creador inferidos, por ejemplo [\"female\", \"male\"]."
        },
        "ethnicities": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Etnias de creador inferidas."
        },
        "creatorTypes": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Tipos de cuenta de creador, por ejemplo [\"individual\", \"brand\"]."
        },
        "faceVisibilities": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Clasificaciones de visibilidad del rostro, por ejemplo [\"clear_face\", \"mixed\", \"no_face\"]."
        },
        "workspaceDeduplicationEnabled": {
          "type": "boolean",
          "description": "Cuando es true, los creadores ya guardados en tu espacio de trabajo se excluyen de los resultados."
        }
      }
    }
  },
  "required": [
    "target_account"
  ]
}
```

## Responses

### 200 — Creadores similares devueltos

Headers:
- `X-Request-Id` (string) — Identificador de la solicitud que se debe incluir al contactar con el soporte de Felo.

**application/json**

Schema: object

```json
{
  "type": "object",
  "properties": {
    "requestId": {
      "type": "string",
      "description": "ID de solicitud para soporte y supervisión.",
      "example": "req-b33"
    },
    "billingRequestId": {
      "type": "string",
      "description": "Referencia de facturación del proveedor, no un recibo de facturación de Felo.",
      "example": "a328145e-3cc9-45c7-89f9-a5f15b236d4f"
    },
    "data": {
      "$ref": "#/components/schemas/ResponseEb32A34A5274_CreatorSearchData"
    }
  }
}
```

### 400 — No se pudo procesar la solicitud. Comprueba los parámetros de la solicitud.

### 401 — Se requiere una clave de API de Felo válida.

### 402 — La solicitud no puede continuar porque no se cumple un requisito de facturación.

### 403 — La cuenta no tiene permiso para realizar esta operación.

### 429 — Se ha alcanzado un límite de solicitudes o de gasto.

### 502 — El servicio no pudo completar la solicitud.

### 503 — La API o el servicio de facturación no están disponibles temporalmente.

### 504 — El servicio agotó el tiempo de espera al procesar la solicitud.

### default — Respuesta de error; las respuestas de paso del upstream pueden usar formatos del proveedor

**application/json**

Schema:

```json
{}
```

## Schema definitions

### ResponseEb32A34A5274_Creator

`#/components/schemas/ResponseEb32A34A5274_Creator`

```json
{
  "type": "object",
  "description": "Un creador coincidente. Los campos son coherentes entre Similar Creators y AI Search.",
  "properties": {
    "id": {
      "type": "string",
      "description": "ID del creador en la plataforma."
    },
    "username": {
      "type": "string",
      "description": "Identificador del creador (sin la @ inicial)."
    },
    "fullName": {
      "type": "string",
      "description": "Nombre para mostrar del creador."
    },
    "biography": {
      "type": "string",
      "description": "Texto de la biografía del perfil."
    },
    "email": {
      "type": [
        "string",
        "null"
      ],
      "description": "Correo electrónico de contacto extraído del perfil, cuando está disponible."
    },
    "followerCount": {
      "type": "number",
      "description": "Número de seguidores/suscriptores."
    },
    "region": {
      "type": "string",
      "description": "Región del creador (código de país ISO)."
    },
    "language": {
      "type": "string",
      "description": "Idioma principal del contenido."
    },
    "averagePlayCount": {
      "type": "number",
      "description": "Media de reproducciones/vistas en las publicaciones recientes."
    },
    "medianPlayCount": {
      "type": "number",
      "description": "Recuento mediano de reproducciones / visualizaciones en las publicaciones recientes."
    },
    "averageEngagementRate": {
      "type": "number",
      "description": "Tasa media de interacción (0–1)."
    },
    "medianEngagementRate": {
      "type": "number",
      "description": "Tasa de interacción mediana (0–1)."
    },
    "gender": {
      "type": "string",
      "description": "Género inferido, o `unknown`."
    },
    "ageRange": {
      "type": "string",
      "description": "Rango de edad inferido (por ejemplo, `25_34`) o `unknown`."
    },
    "ethnicity": {
      "type": "string",
      "description": "Etnia inferida o `unknown`."
    },
    "faceVisibility": {
      "type": "string",
      "description": "Clasificación de visibilidad del rostro, por ejemplo, `clear_face`, `mixed`, `no_face`."
    },
    "accountPositioning": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Etiquetas cortas generadas por IA que resumen el nicho/posicionamiento del creador."
    },
    "aiDescription": {
      "type": "string",
      "description": "Resumen generado por IA del contenido, el estilo y los elementos visuales habituales del creador."
    },
    "platform": {
      "type": "string",
      "description": "Plataforma a la que pertenece este creador: instagram, tiktok o youtube."
    },
    "profileUrl": {
      "type": "string",
      "description": "URL del perfil del creador."
    },
    "score": {
      "type": "number",
      "description": "Puntuación de relevancia de la coincidencia (0–1), ordenada de forma descendente."
    }
  }
}
```

### ResponseEb32A34A5274_CreatorSearchData

`#/components/schemas/ResponseEb32A34A5274_CreatorSearchData`

```json
{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/ResponseEb32A34A5274_Creator"
      },
      "description": "Creadores coincidentes, ordenados por `score` de forma descendente."
    },
    "count": {
      "type": "number",
      "description": "Número de creadores entregados. La facturación se basa en este recuento entregado.",
      "example": 2
    }
  }
}
```
