Arama
GET/v1/instagram/search1 kredi
Bir anahtar kelimeyle eşleşen Instagram hesaplarını arar; kullanıcı adlarını, adlarını ve profil bağlantılarını döndürür.
01Sorgu parametreleri
| Ad | Tür | Açıklama |
|---|---|---|
| queryzorunlu | string | Arama terimi, örneğin bir isim ya da marka. |
02İstek
curl "https://api.scrapesocial.ai/v1/instagram/search?query=natgeo" \ -H "x-api-key: $SCRAPESOCIAL_KEY"
03Yanıtlar
API'nin gerçek yanıtları. Listeler 2 öğeye kısaltılmıştır.
GET /v1/instagram/search?query=natgeo
{
"success": true,
"credits_remaining": 4980,
"credits_charged": 1,
"query": "natgeo",
"users": [
{
"position": 0,
"id": null,
"username": "natgeo",
"full_name": "National Geographic",
"is_verified": null,
"profile_pic_url": null,
"url": "https://www.instagram.com/natgeo/"
},
{
"position": 1,
"id": null,
"username": "natgeotravel",
"full_name": "National Geographic Travel",
"is_verified": null,
"profile_pic_url": null,
"url": "https://www.instagram.com/natgeotravel/"
}
],
"hashtags": [],
"places": [],
"keywords": [],
"rank_token": null,
"source": "google"
}Tüm uç noktalarda ortak
Her rota bunları döndürebilir: eksik ya da hatalı anahtar, biten kredi, yanıt vermeyen platform ya da bizim tarafımızdaki bir hata. Hiçbiri kredi harcamaz.
GET /v1/cosmos/profile?handle=design
{
"success": false,
"message": "Invalid API key"
}04Notlar
Hesaplar sıralı olarak `users` içindedir; yalnızca `position`, `username`, `full_name` ve `url` doludur, diğer kullanıcı alanları null gelir; `hashtags`, `places` ve `keywords` her zaman boştur. Tek sayfa döner, genellikle 20 civarı hesap içerir. Sonuç yoksa 0 kredilik boş liste döner. Web arama motorları hiçbir şey eşleşmediğinde de gevşek ilgili sayfalar döndürür; bu yüzden yalnızca başlığında, özetinde veya URL'sinde sorgunun kelimelerini geçiren sonuçlar tutulur: hiçbir şeyle eşleşmeyen bir sorgu 0 krediyle boş liste döndürür.
05Hatalar ve krediler
Her hatada success: false ve gerçek bir HTTP durum kodu döner; kredi düşmez.
400missing_parameter
Zorunlu bir parametre eksik veya geçersiz.
403private_account
Hesap gizli ya da yaş kısıtlamalı.
404not_found
Böyle bir hesap yok.
503upstream_error
Platform şu an cevap vermiyor; tekrar deneyin.