# Perfiles de usuarios de Felo en X

POST /api/v1/data/x/user/info

Elige la operación para los datos que necesitas. Los cinco endpoints usan POST y devuelven JSON en la raíz, sin un contenedor común `data`.

Todos los ejemplos usan `FELO_API_KEY` de la [vista general](https://openapi.felo.ai/es/docs/data-api/guides/felo-overview.md). Las llamadas usan **saldo de la plataforma**, no créditos Felo Pro. Los ejemplos de respuesta son ilustrativos; el contenido en vivo y los campos opcionales varían.





## 1. Obtener perfiles de usuario

`POST /api/v1/data/x/user/info`

| Campo | Tipo | Requerido | Significado |
|---|---|---|---|
| `usernames` | arreglo de strings | Sí | De 1 a 100 nombres de usuario; envía los handles sin `@` |

```bash
curl -sS --request POST "https://openapi.felo.ai/api/v1/data/x/user/info" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["OpenAI"]}'
```

La respuesta contiene `users` y `total`. Cada usuario incluye `user_id`, `username` y `display_name`; el texto del perfil, los conteos de seguidores, la verificación y otros metadatos también pueden estar presentes. Un lote puede devolver menos perfiles de los solicitados. Haz la coincidencia por nombre de usuario o ID, no por posición en el arreglo.

```json
{"users":[{"user_id":"example-user-id","username":"example","display_name":"Example"}],"total":1}
```



## Paginación y control de costes

`total` cuenta el arreglo correspondiente en la respuesta actual: publicaciones de nivel superior para consultas de publicaciones, o respuestas dentro de cada entrada de resultado para consultas de respuestas. No es un recuento global de coincidencias, ni el recuento completo de respuestas de una publicación, ni el recuento final facturable.

1. Envía la primera solicitud sin `cursor`.
2. Lee `has_next` y `next_cursor` de la respuesta. Para respuestas, léelos en cada entrada de resultado.
3. Si existe otra página y el cursor no está vacío, envíalo sin cambios con la misma consulta. Para un lote de respuestas, continúa cada publicación por separado.
4. Detente cuando no haya página siguiente, cuando un cursor se repita o cuando se alcance tu propio límite de página o gasto.

Los metadatos de paginación reflejan la última respuesta upstream; la colección devuelta puede truncarse en un tope de resultados. Incluso `has_next=false` no garantiza que se haya recuperado todo el historial o las respuestas de X. Muestra el recuento real devuelto en lugar de etiquetar como todos los datos disponibles un conjunto de resultados limitado.

Cada página exitosa puede incurrir en un cargo. Estas cinco operaciones se facturan por resultados devueltos, no con una tarifa fija por solicitud. Las respuestas anidadas y otros registros devueltos pueden afectar el recuento facturado; no estimes el coste solo por la longitud del arreglo de nivel superior. Consulta los [precios actuales](https://openapi.felo.ai/api/v1/data/prices) y el uso en la consola. Los campos completos de los objetos están en el [esquema OpenAPI](https://openapi.felo.ai/api/v1/data/openapi.json).