# Profili utente Felo X

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

Scegli l'operazione per i dati di cui hai bisogno. Tutti e cinque gli endpoint usano POST e restituiscono JSON alla radice, senza un wrapper comune `data`.

Tutti gli esempi usano `FELO_API_KEY` dalla [panoramica](https://openapi.felo.ai/it/docs/data-api/guides/felo-overview.md). Le chiamate usano **il saldo della piattaforma**, non i crediti Felo Pro. Gli esempi di risposta sono illustrativi; il contenuto live e i campi opzionali variano.





## 1. Ottieni profili utente

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

| Campo | Tipo | Obbligatorio | Significato |
|---|---|---|---|
| `usernames` | array di stringhe | Sì | 1–100 username; invia gli handle senza `@` |

```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 risposta contiene `users` e `total`. Ogni utente include `user_id`, `username` e `display_name`; possono essere presenti anche testo del profilo, conteggi dei follower, verifica e altri metadati. Un batch può restituire meno profili di quelli richiesti. Abbina per username o ID, non per posizione nell'array.

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



## Paginazione e controllo dei costi

`total` conta l'array corrispondente nella risposta corrente: post di primo livello per le query sui post, o risposte all'interno di ciascuna voce risultato per le query sulle risposte. Non è un conteggio globale delle corrispondenze, né il conteggio completo delle risposte di un post, né il conteggio finale fatturabile.

1. Invia la prima richiesta senza `cursor`.
2. Leggi `has_next` e `next_cursor` dalla risposta. Per le risposte, leggili in ogni voce risultato.
3. Se esiste un'altra pagina e il cursor non è vuoto, invialo invariato con la stessa query. Per un batch di risposte, continua separatamente per ogni post.
4. Fermati quando non c'è più una pagina successiva, quando un cursor si ripete o quando raggiungi il tuo limite di pagine o di spesa.

I metadati di paginazione riflettono l'ultima risposta upstream; la raccolta restituita può essere troncata da un limite di risultati. Anche `has_next=false` non garantisce che tutta la cronologia X o tutte le risposte siano state recuperate. Mostra il conteggio effettivo restituito invece di etichettare un insieme di risultati limitato come tutti i dati disponibili.

Ogni pagina riuscita può comportare un addebito. Queste cinque operazioni sono fatturate in base ai risultati restituiti, non con una tariffa fissa per richiesta. Le risposte annidate e altri record restituiti possono influire sul conteggio fatturato; non stimare il costo solo dalla lunghezza dell'array di primo livello. Controlla i [prezzi attuali](https://openapi.felo.ai/api/v1/data/prices) e l'utilizzo nella console. I campi completi degli oggetti sono nello [schema OpenAPI](https://openapi.felo.ai/api/v1/data/openapi.json).