# Felo X Kullanıcı Profilleri

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

İhtiyacınız olan veri için işlemi seçin. Beş uç noktanın tamamı POST kullanır ve ortak bir `data` sarmalayıcısı olmadan JSON’u kökte döndürür.

Tüm örnekler [genel bakış](https://openapi.felo.ai/tr/docs/data-api/guides/felo-overview.md) içindeki `FELO_API_KEY`’i kullanır. Çağrılar Felo Pro kredilerini değil, **platform bakiyesini** kullanır. Yanıt örnekleri açıklayıcıdır; canlı içerik ve isteğe bağlı alanlar değişebilir.





## 1. Kullanıcı profillerini alın

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

| Alan | Tür | Gerekli | Anlamı |
|---|---|---|---|
| `usernames` | string array | Evet | 1–100 kullanıcı adı; `@` olmadan gönderin |

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

Yanıt `users` ve `total` içerir. Her kullanıcı `user_id`, `username` ve `display_name` içerir; profil metni, takipçi sayıları, doğrulama ve diğer meta veriler de bulunabilir. Bir toplu istek, istenenden daha az profil döndürebilir. Dizi konumuna göre değil, kullanıcı adına veya kimliğe göre eşleştirin.

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



## Sayfalama ve maliyet kontrolü

`total`, geçerli yanıttaki ilgili diziyi sayar: gönderi sorguları için üst düzey gönderiler veya yanıt sorguları için her sonuç girdisindeki yanıtlar. Bu, genel bir eşleşme sayısı, bir gönderinin tam yanıt sayısı ya da nihai faturalandırılabilir sayı değildir.

1. İlk isteği `cursor` olmadan gönderin.
2. Yanıttan `has_next` ve `next_cursor` değerlerini okuyun. Yanıtlar için, bunları her sonuç girdisinde okuyun.
3. Başka bir sayfa varsa ve cursor boş değilse, aynı sorguyla değiştirmeden gönderin. Bir yanıt toplu isteği için her gönderi için ayrı ayrı devam edin.
4. Sonraki sayfa yoksa, bir cursor tekrar ederse veya kendi sayfa ya da harcama sınırınıza ulaşıldıysa durun.

Sayfalama meta verileri, son üst akış yanıtını yansıtır; dönen koleksiyon sonuç sınırında kesilmiş olabilir. `has_next=false` olması bile tüm X geçmişinin veya yanıtlarının alındığının garantisi değildir. Sınırlı bir sonuç kümesini mevcut tüm veri olarak etiketlemek yerine, gerçek dönen sayıyı gösterin.

Her başarılı sayfa bir ücret oluşturabilir. Bu beş işlem dönen sonuçlara göre faturalandırılır, sabit bir istek ücretiyle değil. İç içe yanıtlar ve diğer dönen kayıtlar, faturalandırılan sayımı etkileyebilir; maliyeti yalnızca üst düzey dizinin uzunluğuna göre tahmin etmeyin. [Güncel fiyatları](https://openapi.felo.ai/api/v1/data/prices) ve konsoldaki kullanımı kontrol edin. Tam nesne alanları [OpenAPI şemasında](https://openapi.felo.ai/api/v1/data/openapi.json) yer alır.