Felo API PlatformFelo API Platform

Felo Пошук користувачів X

Провайдер: Felo · Оплата з балансу платформи

Автентифікація та налаштуванняБілінг і помилкиПовний посібник із робочого процесу

Оберіть операцію для потрібних вам даних. Усі п’ять кінцевих точок використовують POST і повертають JSON у корені, без спільної оболонки data.

У всіх прикладах використовується FELO_API_KEY з огляду. Виклики використовують баланс платформи, а не кредити Felo Pro. Приклади відповідей є ілюстративними; живий контент і необов’язкові поля можуть відрізнятися.

2. Пошук користувачів

POST /api/v1/data/x/user/search

ПолеТипОбов’язковеЗначення
querystringТак1–1,000 символів
cursorstringНіКурсор пагінації, до 4,000 символів
curl -sS --request POST "https://openapi.felo.ai/api/v1/data/x/user/search" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"AI research"}'

Відповідь містить users, total, has_next і next_cursor. У цій операції немає параметра limit.

{"users":[],"total":0,"has_next":false,"next_cursor":null}

Пагінація та контроль витрат

total рахує відповідний масив у поточній відповіді: дописи верхнього рівня для запитів дописів або відповіді в кожному елементі результату для запитів відповідей. Це не глобальна кількість збігів, не повна кількість відповідей на допис і не кінцева кількість, що підлягає оплаті.

  1. Надішліть перший запит без cursor.
  2. Прочитайте has_next і next_cursor у відповіді. Для відповідей читайте їх у кожному елементі результату.
  3. Якщо є ще одна сторінка і курсор непорожній, надішліть його без змін із тим самим запитом. Для пакета відповідей продовжуйте окремо для кожного допису.
  4. Зупиніться, коли немає наступної сторінки, коли курсор повторюється або коли досягнуто вашого власного ліміту сторінок чи витрат.

Метадані пагінації відображають останню вхідну відповідь; повернута колекція може бути обрізана на ліміті результатів. Навіть has_next=false не гарантує, що вся історія X або всі відповіді були отримані. Відображайте фактично повернену кількість замість того, щоб позначати обмежений набір результатів як усі доступні дані.

Кожна успішна сторінка може спричинити списання. Ці п’ять операцій оплачуються за повернутими результатами, а не фіксованою платою за запит. Вкладені відповіді та інші повернуті записи можуть впливати на кількість, що підлягає оплаті; не оцінюйте вартість лише за довжиною масиву верхнього рівня. Перевіряйте поточні ціни і використання в консолі. Повні поля об’єктів наведено у схемі OpenAPI.

Потрібна допомога?