LinkedIn Benutzername-Profil-API: Profile im Batch

Prüfen Sie öffentliche LinkedIn-Profile per Benutzername oder Profil-URL und erhalten Sie Profilfoto, Name, Headline, Standort, Land, Unternehmen, Follower-Zahl, Über-mich-Text, Sprachen, Ausbildung und Berufserfahrung. Nicht existierende oder private Profile werden als nicht aktiviert zurückgegeben. Die Aufgabe nutzt den standardmäßigen asynchronen Batch-Workflow.

Eingabeformat

Laden Sie eine Textdatei mit einem LinkedIn-Benutzernamen pro Zeile hoch. Akzeptiert werden der Profil-Slug, @slug und die vollständige URL linkedin.com/in/<slug>; der Abgleich ignoriert Groß-/Kleinschreibung.

williamhgates
@satyanadella
https://www.linkedin.com/in/john-smith-1a2b3c4/

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="linkedin_username"'

Die API gibt eine Aufgaben-ID zurück. Bewahren Sie diese ID auf und verwenden Sie sie zur Abfrage des Aufgabenstatus.

Antwort beim Upload

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "pending",
  "total": 5000,
  "estimated_amount": {
    "amount": "0.500000",
    "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 den Status ab, bis status zu exported wechselt. pending und processing sind keine abgeschlossenen Ergebnisse.

Antwort während der Verarbeitung

{
  "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": "2.000000",
    "currency": "USD"
  }
}

Ergebnisfelder

Feld	Beschreibung	Beispiel
username	Benutzername oder Profil-URL genau wie übermittelt.	williamhgates
activated	Ob ein öffentliches Profil gefunden wurde (no umfasst auch private und nicht existierende Profile).	yes
avatar	Ob das Profil ein echtes Foto hat (yes/no).	yes
avatar_url	URL des Profilfotos (läuft nicht ab).	https://media.licdn.com/dms/image/…
name	Vollständiger Name.	Bill Gates
headline	Profil-Headline.	Chair, Gates Foundation
location	Standort wie im Profil angezeigt.	Seattle, Washington, United States
country	Aus dem Standort abgeleiteter ISO-Ländercode.	US
company	Aktuelles Unternehmen.	Gates Foundation
followers	Follower-Zahl.	40653538
about	Text des Über-mich-Abschnitts.	Chair of the Gates Foundation. …
badges	Verifizierungslabels, z. B. Creator, Top Voice.	Creator, Top Voice
languages	Sprachen, durch ; getrennt.	English;German
current_title	Aktuelle Position, sofern nicht vom Inhaber verborgen.	Co-chair
education	JSON-Liste aus {organization,start,end}.	[{“organization”:“Harvard University”,“start”:1973,“end”:1975}]
experience	JSON-Liste aus {organization,start,end}.	[{“organization”:“Gates Foundation”,“start”:2000}]
masked	Durch die Sichtbarkeitseinstellungen verborgene Felder, durch ; getrennt.	jobTitle;worksFor

Verarbeitung der Ergebnisdatei

Laden Sie die Datei erst nach dem Export der Aufgabe über result_url herunter. Bewahren Sie die zurückgegebenen Spaltennamen bei der weiteren Verarbeitung bei.

Antwortfelder

Feld	Beschreibung
created_at	Zeitstempel der Aufgabenerstellung.
updated_at	Zeitstempel der letzten Statusaktualisierung.
task_id	Eindeutige Aufgabenkennung.
status	pending, processing, exported oder failed.
total	Gesamtzahl der verarbeiteten Eingabewerte.
success	Erfolgreich verarbeitete Werte.
failure	Werte, deren Verarbeitung fehlgeschlagen ist.
result_url	Download-URL nach dem Export der Aufgabe.
actual_amount	Endgültig abgerechneter Betrag, sofern verfügbar.
estimated_amount	Beim Erstellen der Aufgabe zurückgegebener Schätzbetrag.

Statuscodes

Status	Beschreibung
200	Anfrage erfolgreich.
202	Aufgabe erfolgreich erstellt; der geschätzte Betrag wurde angewendet.
400	Ungültige Datei, nicht unterstützter Aufgabentyp oder zu wenige gültige Einträge.
401	API-Key fehlt oder ist ungültig.
402	Unzureichendes Kontoguthaben.
403	Produkt für Ihr Konto nicht verfügbar (eingestellt oder nur für Whitelist-Kunden); bitte Support kontaktieren.
404	Aufgabe nicht gefunden.
413	Die hochgeladene Datei ist zu groß.
500	Interner Serverfehler; versuchen Sie es später erneut.
503	Produkt vorübergehend nicht verfügbar (wegen Wartung pausiert); es wird nichts berechnet, später erneut versuchen.

Hinweise zum Betrieb

• Die Aufgabe ist asynchron. Verwenden Sie die Aufgaben-ID zur Statusabfrage.
• Prüfen Sie vor dem Upload die produktspezifischen Eingabelimits.
• Fehlerhafte Zeilen werden im exportierten Ergebnis ausgegeben und in den Aufgabenzählern berücksichtigt.
• Die obigen Felder basieren auf dem aktuellen Live-Sample und können sich ändern, wenn sich das vorgelagerte Exportschema ändert.