Profil Arama

GET/v1/instagram/search/profiles1 kredi

Bir anahtar kelimeyle eşleşen Instagram profillerini arar.

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/profiles?query=national+geographic" \
  -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/profiles?query=national%20geographic

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "query": "national geographic",
  "source": "google",
  "profiles": [
    {
      "id": "787132",
      "username": "natgeo",
      "full_name": "National Geographic",
      "biography": "Step into wonder and find your inner explorer with National Geographic 🌎",
      "bio_links": [
        {
          "image_url": "",
          "is_pinned": false,
          "link_id": "17954981494900183",
          "link_type": "external",
          "lynx_url": "https://l.instagram.com/?u=http%3A%2F%2Fvisitstore.bio%2Fnatgeo&e=AUAzvM5PwrAx6X8hNVKa9ihlupBs1lBYJycHA5GC90NBzMQDmsIrO8FhfxyAke3zHBixCWNHNZzIwFludk_MaAJPIFNTH3IVM4mNfI4KjFCdmGdvHP78_jR4bRp7M30MOBxd7bD3DM_Hz_m18ZIeisy9iXs",
          "media_accent_color_hex": "",
          "media_type": "none",
          "title": "",
          "url": "http://visitstore.bio/natgeo",
          "creation_source": "NONE"
        },
        {
          "image_url": "",
          "is_pinned": false,
          "link_id": "17908403766429128",
          "link_type": "external",
          "lynx_url": "https://l.instagram.com/?u=https%3A%2F%2Fngmdomsubs.nationalgeographic.com%2Fservlet%2FOrdersGateway%3Fcds_mag_code%3DNGM%26cds_page_id%3D283562%26cds_response_key%3DI5FX10002&e=AUD6J9euEN0GUlby5cUvYuFMRzA51R24OS8bFL2qrlK8Y-fmz-d77wX6acW_rdN7OrRBcu1ANL3g-566spqyUl9k7rAoJiD_7HzGrk_7yNyDH7U7aApcw9GGN-G67T7wJlKU9arCN7TKx6R2oZDFHqr9S7Q",
          "media_accent_color_hex": "",
          "media_type": "none",
          "title": "Subscribe Here!",
          "url": "https://ngmdomsubs.nationalgeographic.com/servlet/OrdersGateway?cds_mag_code=NGM&cds_page_id=283562&cds_response_key=I5FX10002",
          "creation_source": "NONE"
        }
      ],
      "external_url": "http://visitstore.bio/natgeo",
      "is_private": false,
      "is_verified": true,
      "is_business_account": false,
      "is_professional_account": true,
      "category_name": null,
      "profile_pic_url": "https://scontent.cdninstagram.com/v/t51.82787-19/683576066_18653628823019133_9051036240972105113_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=110&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy40MDAuQzMifQ%3D%3D&_nc_ohc=Wrw6QVW6ynMQ7kNvwEHGRfu&_nc_oc=AdqmM17ULKtZcQo7nKgisj_hFSyEclJLBMVepQ_KAW9TQcFHaKTzCn2zwePikxgaCZI&_nc_zt=24&_nc_ht=scontent.cdninstagram.com&_nc_gid=j9sC85o4lHNgGN…",
      "follower_count": 268287573,
      "following_count": 195,
      "media_count": 32000,
      "url": "https://www.instagram.com/natgeo/",
      "matched_from": "profile",
      "google_title": null,
      "google_description": null
    },
    {
      "id": "175833277",
      "username": "natgeotvturkiye",
      "full_name": "National Geographic Türkiye",
      "biography": "#NationalGeographic'i Digiturk 181,D-Smart 63, Kablo TV 112, Tivibu 102,TV+ 98 kanallarından ve TOD, S Sport Plus platformlarından izleyebilirsin.",
      "bio_links": [
        {
          "image_url": "",
          "is_pinned": false,
          "link_id": "17859652730800801",
          "link_type": "external",
          "lynx_url": "https://l.instagram.com/?u=https%3A%2F%2Fwww.natgeotv.com%2Ftr&e=AUDO6bjTyXcWNQUNKCrAZwiME7YCXszZA5rj4QmuRBfyrqNdPMoxW3386s8_PiXxGvFP7dUcZKnF0VmJZhyy8gM1-i_Gtifc_827FLJma9kuQvn2B0YWaM2Ca_euLx0gFkAtpaVVOn53SFlSh-zmxWf0Alc",
          "media_accent_color_hex": "",
          "media_type": "none",
          "title": "",
          "url": "https://www.natgeotv.com/tr",
          "creation_source": "NONE"
        }
      ],
      "external_url": "https://www.natgeotv.com/tr",
      "is_private": false,
      "is_verified": true,
      "is_business_account": false,
      "is_professional_account": true,
      "category_name": null,
      "profile_pic_url": "https://scontent.cdninstagram.com/v/t51.2885-19/94467556_238527100892040_5219465156857167872_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=103&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy45ODAuQzMifQ%3D%3D&_nc_ohc=xwAkMS3AjycQ7kNvwEfazPx&_nc_oc=AdrW_utxYmQgOp_DN5s3oZq5sA-vdMqcsx3LdFI35U7fHNtew3fSteznYvhCGEZFzuQ&_nc_zt=24&_nc_ht=scontent.cdninstagram.com&_nc_ss=7b289&oh=00_AQPbco1…",
      "follower_count": 511724,
      "following_count": 15,
      "media_count": 9874,
      "url": "https://www.instagram.com/natgeotvturkiye/",
      "matched_from": "profile",
      "google_title": null,
      "google_description": null
    }
  ],
  "cursor": null
}

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

Profiller `profiles` içindedir. Her sonuç herkese açık profilinden doldurulur: `id`, `full_name`, `biography`, `bio_links`, `external_url`, `is_private`, `is_verified`, işletme ve profesyonel hesap bayrakları, `category_name`, `profile_pic_url`, `follower_count`, `following_count` ve `media_count` (Instagram kesin sayı vermediğinde 10.000 gönderinin üzerinde yuvarlanmış). Profili zamanında yanıt vermeyen sonuçta bu alanlar null kalır. `google_title` ve `google_description` null gelir. Sonuçlar tek sayfada döner ve `cursor` her zaman null'dır. 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.