Facebook ID/Benutzername-Profil API: Profile in Masse

Prüfen Sie Facebook-Profile und -Seiten (Pages) anhand der numerischen Profil-ID, des Benutzernamens (Vanity-Name) oder der Profil-URL und erhalten Sie das Profilfoto (neu gehostet unter einer dauerhaften URL), die numerische ID, den kanonischen Benutzernamen, den Anzeigenamen, die kurze Tagline sowie die Anzahl der Follower und der Personen, die darüber sprechen. Das Produkt liest ausschließlich die öffentliche, abgemeldet sichtbare Facebook-Profilseite: Es wird kein Login verwendet und es werden keine Freundesdaten erhoben. Profile, die nicht existieren, deaktiviert sind oder für abgemeldete Besucher nicht sichtbar sind, werden als nicht aktiviert zurückgegeben. Die Aufgabe nutzt den standardmäßigen asynchronen Batch-Ablauf.

Eingabeformat

Laden Sie eine Textdatei mit einem Facebook-Identifikator pro Zeile hoch. Akzeptierte Formen:

• Numerische Profil-ID, z. B. 4
• Benutzername (Vanity-Name), z. B. zuck oder @zuck; Buchstaben, Ziffern und Punkte, 1–50 Zeichen, Groß-/Kleinschreibung wird ignoriert
• Profil-URL, z. B. facebook.com/zuck, facebook.com/profile.php?id=100003012457235 oder facebook.com/people/<Name>/<ID>

facebook.com-URLs, die kein Profil sind (Gruppen, Seitenverwaltung, Login und ähnliche Pfade), werden als ungültige Einträge abgewiesen.

4
zuck
@Meta
https://www.facebook.com/profile.php?id=100003012457235
https://www.facebook.com/people/Mark-Zuckerberg/4/

Aufgabe erstellen

POST https://api.checknumber.ai/v1/tasks

curl --location 'https://api.checknumber.ai/v1/tasks' \
--header 'X-API-Key: YOUR_API_KEY' \
--form 'file=@"./input.txt"' \
--form 'task_type="facebook_profile"'

Die API gibt eine Aufgaben-ID zurück. Bewahren Sie sie für die Statusabfrage auf.

Upload-Antwort

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "pending",
  "total": 5000,
  "estimated_amount": {
    "amount": "1.500000",
    "currency": "USD"
  },
  "message": "Task created successfully"
}

Aufgabenstatus prüfen

POST https://api.checknumber.ai/v1/gettasks

curl --location 'https://api.checknumber.ai/v1/gettasks' \
--header 'X-API-Key: YOUR_API_KEY' \
--form 'task_id="d4g8o46p2jvh04o9uolg"'

Fragen Sie ab, bis status exported ist. Behandeln Sie pending oder processing nicht als Endergebnis.

Antwort in Bearbeitung

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "processing",
  "total": 5000,
  "success": 2500,
  "failure": 0
}

Exportierte Antwort

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "exported",
  "total": 5000,
  "success": 5000,
  "failure": 0,
  "result_url": "https://example-link-to-results.zip",
  "actual_amount": {
    "amount": "1.500000",
    "currency": "USD"
  }
}

Ergebnisfelder

Die Ergebnis-CSV enthält die folgenden Spalten in dieser Reihenfolge: username,activated,avatar,fb_id,fb_username,name,image,tagline,followers,talking_about.

Feld	Beschreibung	Beispiel
username	Übermittelter Identifikator (ID, Benutzername oder Profil-URL), unverändert.	4
activated	Ob eine öffentliche Profilseite abgerufen wurde (yes/no). no bedeutet: Das Profil existiert nicht, ist deaktiviert oder für abgemeldete Besucher nicht sichtbar; Facebook zeigt in allen drei Fällen dieselbe Seite „Inhalt nicht verfügbar“, sie lassen sich daher nicht unterscheiden.	yes
avatar	Dauerhafte URL des Profilfotos, von uns auf fb.waavatar.xyz neu gehostet. Leer, wenn activated no ist.	https://fb.waavatar.xyz/ins/62e8bb6110133ef3115f55454ff66c4d.jpg
fb_id	Numerische Facebook-Profil-ID, aus der Seite ausgelesen.	4
fb_username	Kanonischer Benutzername (Vanity-Name) laut Facebook; leer bei Profilen, die nur eine ID haben.	zuck
name	Anzeigename.	Mark Zuckerberg
image	Facebooks eigene signierte CDN-URL des Profilfotos. Sie läuft innerhalb weniger Tage ab; verwenden Sie avatar für einen dauerhaften Link.	https://scontent.xx.fbcdn.net/v/…jpg?…&oe=…
tagline	Kurzer Bio-Text aus der Seitenbeschreibung; kann leer sein.	Bringing the world closer together.
followers	Anzahl der Follower. Bei Seiten (Pages) ist dies die Anzahl der „Gefällt mir“-Angaben. Ganzzahl; leer, wenn nicht angezeigt.	121439077
talking_about	Facebooks Zahl „Personen sprechen darüber“. Ganzzahl; leer, wenn nicht angezeigt.	918893

Beispielzeilen:

username,activated,avatar,fb_id,fb_username,name,image,tagline,followers,talking_about
4,yes,https://fb.waavatar.xyz/ins/62e8bb6110133ef3115f55454ff66c4d.jpg,4,zuck,Mark Zuckerberg,https://scontent.xx.fbcdn.net/v/....jpg?...&oe=...,Bringing the world closer together.,121439077,918893
zzqqxxjjkk993827a,no,,,,,,,,

Persönliche Profile und Seiten (Pages) werden gleichermaßen unterstützt. Meta wird beispielsweise zu fb_id 100080376596424 aufgelöst, und followers entspricht der „Gefällt mir“-Zahl der Seite.

Umgang mit der Ergebnisdatei

Laden Sie die Datei erst nach dem Export von result_url herunter. Behalten Sie die Spaltennamen bei der Weiterverarbeitung bei.

Antwortfelder

Feld	Beschreibung
created_at	Zeitpunkt der Aufgabenerstellung.
updated_at	Zeitpunkt der letzten Statusaktualisierung.
task_id	Eindeutige Aufgaben-ID.
status	pending, processing, exported oder failed.
total	Gesamtzahl verarbeiteter Eingaben.
success	Erfolgreich verarbeitete Werte.
failure	Fehlgeschlagene Werte.
result_url	Download-URL nach dem Export.
actual_amount	Endgültig abgerechneter Betrag, falls verfügbar.
estimated_amount	Geschätzter Betrag bei Erstellung der Aufgabe.

Statuscodes

Status	Beschreibung
200	Anfrage erfolgreich.
202	Aufgabe erstellt und geschätzte Gebühr angewendet.
400	Ungültige Datei, nicht unterstützter Aufgabentyp oder zu wenige gültige Einträge.
401	API-Schlüssel fehlt oder ist ungültig.
402	Unzureichendes Guthaben.
403	Produkt für Ihr Konto nicht verfügbar (eingestellt oder nur Whitelist); Support kontaktieren.
404	Aufgabe nicht gefunden.
413	Hochgeladene Datei zu groß.
500	Interner Serverfehler; später erneut versuchen.
503	Produkt vorübergehend nicht verfügbar (Wartung); keine Berechnung, später erneut versuchen.

Betriebshinweise

• Die Aufgabe ist asynchron; nutzen Sie die ID zur Statusabfrage.
• Preis: 3 $ pro 10.000 Identifikatoren. Abgerechnet wird nach übermittelter Menge: Jeder übermittelte Identifikator wird berechnet, unabhängig davon, ob ein Profil gefunden wird. Die Mindestabrechnungsmenge pro Aufgabe beträgt 500 Identifikatoren; kleinere Aufgaben werden als 500 berechnet.
• Die Ergebnisse spiegeln die öffentliche Profilseite zum Prüfzeitpunkt wider. Es wird kein Cache verwendet; jede Übermittlung wird neu geprüft.
• Prüfen Sie vor dem Upload die Eingabelimits des Produkts.
• Fehlgeschlagene Zeilen erscheinen im Export und in den Zählern.
• Die Felder basieren auf der aktuellen Stichprobe und können sich bei Änderungen der Seitenstruktur ändern.