Instagram ID/Benutzername-Profil API: Profile in Masse

Prüfen Sie Instagram-Konten anhand des Benutzernamens (ID) oder der Profil-URL und erhalten Sie ein neu gehostetes Gesichtsfoto aus dem neuesten Beitrag mit einem Gesicht, den vollständigen Namen, die Anzahl der Beiträge, Follower und Abonnements sowie die Kennzeichen privat und verifiziert. Nicht existierende Konten werden als nicht aktiviert zurückgegeben; private Konten als aktiviert mit Profildaten, aber ohne Foto. Die Aufgabe nutzt den standardmäßigen asynchronen Batch-Ablauf.

Eingabeformat

Laden Sie eine Textdatei mit einem Instagram-Benutzernamen (ID) pro Zeile hoch. username, @username und vollständige instagram.com/<username>-URLs werden akzeptiert; der Abgleich ignoriert Groß-/Kleinschreibung.

cristiano
@zuck
https://www.instagram.com/natgeo/

Aufgabe erstellen

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

curl --location 'https://api.numberchecker.ai/v1/tasks' \
--header 'X-API-Key: YOUR_API_KEY' \
--form 'file=@"./input.txt"' \
--form 'task_type="instagram_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.250000",
    "currency": "USD"
  },
  "message": "Task created successfully"
}

Aufgabenstatus prüfen

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

curl --location 'https://api.numberchecker.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.250000",
    "currency": "USD"
  }
}

Ergebnisfelder

Feld	Beschreibung	Beispiel
username	Übermittelter Benutzername bzw. Profil-URL, unverändert.	cristiano
activated	Ob das Konto existiert (no = kein solcher Benutzername).	yes
avatar	Öffentliche URL des Gesichtsfotos aus dem neuesten Beitrag mit Gesicht, gehostet auf ins.waavatar.xyz (läuft nicht ab); leer, wenn kein Gesicht gefunden wurde, das Konto privat ist oder keine Beiträge hat.	https://ins.waavatar.xyz/ins/ec966a0f864e4aba1fd2899dce2c3fed.jpg
full_name	Im Profil angezeigter Name.	Cristiano Ronaldo
posts	Anzahl der Beiträge.	4138
followers	Anzahl der Follower.	679725371
following	Anzahl der Abonnements.	636
private	Ob das Konto privat ist (yes/no).	no
verified	Ob das Konto ein Verifizierungsabzeichen hat (yes/no).	yes
face_status	Ergebnis der Gesichtsextraktion: ok (Ausschnitt größer als 400 px), ok_small (kleineres Gesicht beibehalten), no_face, no_640_face (kein Beitragsbild mit mindestens 640 px), private, empty (keine Beiträge), posts_missed.	ok

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.
• Prüfen Sie vor dem Upload die Eingabelimits des Produkts.
• Fehlgeschlagene Zeilen erscheinen im Export und in den Zählern.
• Fotos werden aus öffentlichen Beiträgen in der Auflösung geschnitten, die Instagram abgemeldeten Besuchern liefert (640 px); die meisten Ausschnitte liegen daher unter 400 px und werden als ok_small markiert.
• Die Felder basieren auf der aktuellen Stichprobe und können sich bei Änderungen des Exportschemas ändern.