Instagram ID/Benutzername-Profil API: Profile in Masse

Prüfen Sie Instagram-Konten anhand des Benutzernamens (ID) oder der Profil-URL und erhalten Sie das vollständige Bild des neuesten Beitrags mit einem Gesicht, unverändert neu gehostet, 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.

Numerische Instagram-IDs (pk) werden ebenfalls akzeptiert und zum Benutzernamen aufgelöst.

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

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.100000",
    "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.100000",
    "currency": "USD"
  }
}

Ergebnisfelder

Feld	Beschreibung	Beispiel
username	Übermittelter Benutzername bzw. Profil-URL, unverändert.	cristiano
activated	Ob für diese ID ein Avatarbild gewonnen wurde (yes/no). Bestehende Konten ohne verwertbares Beitragsbild (privat, keine Beiträge, kein Gesicht, Bild zu klein) und nicht existierende IDs sind no. Nur yes-Zeilen werden berechnet.	yes
avatar	Öffentliche URL des neuesten Beitragsbilds mit einem Gesicht, unverändert auf ins.waavatar.xyz gehostet (läuft nicht ab). Geliefert werden nur Bilder mit mehr als 500 px Kantenlänge; Profilbilder werden nicht verwendet. Leer, wenn kein solches Bild existiert (privates Konto, keine Beiträge, kein Gesicht).	https://ins.waavatar.xyz/ins/ec966a0f864e4aba1fd2899dce2c3fed.jpg
visibility	Ob das Instagram-Konto privat ist: private oder public; leer bei nicht existierenden Konten.	public
ig_username	Aufgelöster Instagram-Benutzername (auch wenn der übermittelte Wert eine numerische ID war); leer bei nicht existierenden Konten.	villavicenciopaul
full_name	Im Profil angezeigter Name.	Cristiano Ronaldo
posts	Anzahl der Beiträge.	4138
followers	Anzahl der Follower.	679725371
following	Anzahl der Abonnements.	636
verified	Ob das Konto ein Verifizierungsabzeichen hat (yes/no).	yes

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.
• Geliefert wird das vollständige Beitragsbild (kein Ausschnitt) in der Auflösung, die Instagram abgemeldeten Besuchern liefert (640 px an der längeren Seite); nur wenn die erkannte Gesichtsregion 250 px überschreitet.
• Die Felder basieren auf der aktuellen Stichprobe und können sich bei Änderungen des Exportschemas ändern.