# Felo X profily uživatelů

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

Zvolte operaci pro data, která potřebujete. Všech pět koncových bodů používá POST a vrací JSON v kořeni, bez společného obalu `data`.

Všechny příklady používají `FELO_API_KEY` z [přehledu](https://openapi.felo.ai/cs/docs/data-api/guides/felo-overview.md). Volání používají **zůstatek platformy**, nikoli Felo Pro credits. Příklady odpovědí jsou ilustrativní; živý obsah a volitelná pole se liší.





## 1. Získejte profily uživatelů

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

| Pole | Typ | Povinné | Význam |
|---|---|---|---|
| `usernames` | pole stringů | Ano | 1–100 uživatelských jmen; posílejte handly bez `@` |

```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"]}'
```

Odpověď obsahuje `users` a `total`. Každý uživatel zahrnuje `user_id`, `username` a `display_name`; může být přítomen také text profilu, počty sledujících, ověření a další metadata. Dávka může vrátit méně profilů, než bylo požadováno. Porovnávejte podle uživatelského jména nebo ID, nikoli podle pozice v poli.

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



## Stránkování a řízení nákladů

`total` počítá odpovídající pole v aktuální odpovědi: příspěvky na nejvyšší úrovni pro dotazy na příspěvky nebo odpovědi uvnitř každé položky výsledku pro dotazy na odpovědi. Není to globální počet shod, úplný počet odpovědí na příspěvek ani konečný zpoplatněný počet.

1. Odešlete první požadavek bez `cursor`.
2. Přečtěte `has_next` a `next_cursor` z odpovědi. U odpovědí je čtěte v každé položce výsledku.
3. Pokud existuje další stránka a cursor není prázdný, odešlete jej beze změny se stejným dotazem. U dávky odpovědí pokračujte u každého příspěvku samostatně.
4. Zastavte se, když není další stránka, když se cursor opakuje nebo když je dosažen váš vlastní limit stránek či utrácení.

Metadata stránkování odrážejí poslední upstream odpověď; vrácený soubor může být zkrácen na limit výsledků. Ani `has_next=false` není zárukou, že byla načtena veškerá historie X nebo všechny odpovědi. Zobrazte skutečný vrácený počet místo označení omezené sady výsledků jako všech dostupných dat.

Každá úspěšná stránka může být zpoplatněna. Těchto pět operací je účtováno podle vrácených výsledků, nikoli paušálním poplatkem za požadavek. Zanořené odpovědi a další vrácené záznamy mohou ovlivnit zpoplatněný počet; náklady neodhadujte pouze podle délky pole na nejvyšší úrovni. Zkontrolujte [aktuální ceny](https://openapi.felo.ai/api/v1/data/prices) a využití v konzoli. Úplná pole objektů jsou ve [schématu OpenAPI](https://openapi.felo.ai/api/v1/data/openapi.json).