İçeriğe geç

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

AdTürAçıklama
queryzorunlustringArama 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.