Felo API PlatformFelo API Platform

Felo X Nutzerprofile

Anbieter: Felo · Bezahlt mit Plattform-Guthaben

Authentifizierung & EinrichtungAbrechnung & FehlerVollständiger Workflow-Leitfaden

Wähle die Operation für die Daten, die du benötigst. Alle fünf Endpunkte verwenden POST und geben JSON an der Root zurück, ohne einen gemeinsamen data-Wrapper.

Alle Beispiele verwenden FELO_API_KEY aus der Übersicht. Aufrufe verwenden Plattform-Guthaben, nicht Felo-Pro-Guthaben. Antwortbeispiele sind illustrativ; Live-Inhalte und optionale Felder variieren.

1. Nutzerprofile abrufen

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

FeldTypErforderlichBedeutung
usernamesstring arrayJa1–100 Benutzernamen; Handles ohne @ senden
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"]}'

Die Antwort enthält users und total. Jeder Nutzer umfasst user_id, username und display_name; Profiltext, Follower-Zahlen, Verifizierung und andere Metadaten können ebenfalls vorhanden sein. Eine Batch kann weniger Profile zurückgeben als angefordert. Abgleichen nach Benutzername oder ID, nicht nach Array-Position.

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

Paginierung und Kostenkontrolle

total zählt das entsprechende Array in der aktuellen Antwort: Top-Level-Beiträge für Beitragsanfragen oder Antworten innerhalb jedes Ergebniseintrags für Antwortanfragen. Es ist keine globale Trefferanzahl, keine vollständige Antwortanzahl eines Beitrags und nicht die endgültig abrechenbare Anzahl.

  1. Sende die erste Anfrage ohne cursor.
  2. Lies has_next und next_cursor aus der Antwort. Bei Antworten lies sie in jedem Ergebniseintrag.
  3. Wenn eine weitere Seite existiert und der Cursor nicht leer ist, sende ihn unverändert mit derselben Anfrage. Für eine Antworten-Batch fahre für jeden Beitrag separat fort.
  4. Stoppe, wenn es keine nächste Seite gibt, wenn sich ein Cursor wiederholt oder wenn deine eigene Seiten- oder Ausgabenobergrenze erreicht ist.

Die Paginierungsmetadaten spiegeln die letzte Upstream-Antwort wider; die zurückgegebene Sammlung kann bei einer Ergebnisobergrenze abgeschnitten sein. Selbst has_next=false ist keine Garantie dafür, dass die gesamte X-Historie oder alle Antworten abgerufen wurden. Zeige die tatsächlich zurückgegebene Anzahl an, statt einen begrenzten Ergebnissatz als alle verfügbaren Daten zu kennzeichnen.

Jede erfolgreiche Seite kann eine Gebühr verursachen. Diese fünf Operationen werden nach zurückgegebenen Ergebnissen und nicht mit einer pauschalen Anfragegebühr abgerechnet. Verschachtelte Antworten und andere zurückgegebene Datensätze können die abgerechnete Anzahl beeinflussen; schätze die Kosten nicht allein anhand der Länge des Top-Level-Arrays. Prüfe die aktuellen Preise und die Nutzung in der Konsole. Vollständige Objektfelder stehen im OpenAPI-Schema.

Brauchst du Hilfe?