LinkedIn Kullanıcı Adı Profil API'si: Toplu Profiller

LinkedIn herkese açık profillerini kullanıcı adı veya profil URL’si ile kontrol edin; profil fotoğrafı, ad, başlık, konum, ülke, şirket, takipçi sayısı, hakkında, diller, eğitim ve iş deneyimi bilgilerini alın. Var olmayan veya gizli profiller etkinleştirilmemiş olarak döndürülür. Görev standart asenkron toplu iş akışını kullanır.

Girdi biçimi

Her satırda bir LinkedIn kullanıcı adı olan bir metin dosyası yükleyin. Profil slug’ı, @slug ve tam linkedin.com/in/<slug> URL’si kabul edilir; eşleştirme büyük/küçük harfe duyarlı değildir.

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

Görev oluşturma

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

API bir görev kimliği döndürür. Bu kimliği saklayın ve görev durumunu sorgulamak için kullanın.

Yükleme yanıtı

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

Görev durumunu kontrol etme

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

status değeri exported olana kadar sorgulayın. pending ve processing tamamlanmış sonuç değildir.

İşleme yanıtı

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

Dışa aktarılan yanıt

{
  "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"
  }
}

Sonuç alanları

Alan	Açıklama	Örnek
username	Gönderildiği şekliyle kullanıcı adı veya profil URL’si.	williamhgates
activated	Kullanıcı adı için herkese açık profil bulundu mu (no gizli ve var olmayan profilleri de kapsar).	yes
avatar	Profilin gerçek fotoğrafı var mı (yes/no).	yes
avatar_url	Profil fotoğrafı URL’si (süresi dolmaz).	https://media.licdn.com/dms/image/…
name	Tam ad.	Bill Gates
headline	Profil başlığı.	Chair, Gates Foundation
location	Profilde gösterilen konum metni.	Seattle, Washington, United States
country	Konumdan türetilen ISO ülke kodu.	US
company	Mevcut şirket.	Gates Foundation
followers	Takipçi sayısı.	40653538
about	Hakkında bölümü metni.	Chair of the Gates Foundation. …
badges	Doğrulama etiketleri, örn. Creator, Top Voice.	Creator, Top Voice
languages	Diller, ; ile ayrılmış.	English;German
current_title	Sahibi gizlemediyse mevcut unvan.	Co-chair
education	{organization,start,end} JSON listesi.	[{“organization”:“Harvard University”,“start”:1973,“end”:1975}]
experience	{organization,start,end} JSON listesi.	[{“organization”:“Gates Foundation”,“start”:2000}]
masked	Görünürlük ayarlarıyla gizlenen alanlar, ; ile ayrılmış.	jobTitle;worksFor

Sonuç dosyası işlemleri

Dosyayı result_url üzerinden yalnızca görev dışa aktarıldıktan sonra indirin. Dosyayı işlerken döndürülen sütun adlarını koruyun.

Yanıt alanları

Alan	Açıklama
created_at	Görevin oluşturulduğu zaman.
updated_at	Son görev durumu güncellemesinin zamanı.
task_id	Benzersiz görev tanımlayıcısı.
status	pending, processing, exported veya failed.
total	İşlenen toplam giriş değeri.
success	Başarıyla işlenen değerler.
failure	İşlenemeyen değerler.
result_url	Görev dışa aktarıldığında indirme URL’si.
actual_amount	Varsa kesinleşen tutar.
estimated_amount	Görev oluşturulurken döndürülen tahmini tutar.

Durum kodları

Status	Açıklama
200	İstek başarılı.
202	Görev başarıyla oluşturuldu ve tahmini ücret uygulandı.
400	Geçersiz dosya, desteklenmeyen görev türü veya çok az geçerli giriş.
401	API anahtarı eksik veya geçersiz.
402	Yetersiz hesap bakiyesi.
403	Ürün hesabınız için kullanılamıyor (kaldırıldı veya yalnızca beyaz listedeki müşterilere açık); destekle iletişime geçin.
404	Görev bulunamadı.
413	Yüklenen dosya çok büyük.
500	Dahili sunucu hatası; daha sonra tekrar deneyin.
503	Ürün geçici olarak kullanılamıyor (bakım için duraklatıldı); ücret alınmaz, daha sonra tekrar deneyin.

Operasyon notları

• Görev eşzamansızdır; durumu sorgulamak için görev kimliğini kullanın.
• Yüklemeden önce ürüne özel giriş sınırlarını kontrol edin.
• Başarısız satırlar dışa aktarılan sonuçta raporlanır ve görev sayaçlarına yansıtılır.
• Yukarıdaki alanlar mevcut canlı sample temelindedir ve dışa aktarma şeması değişirse değişebilir.