Profile Search

GET/v1/instagram/search/profiles1 credit

Searches for Instagram profiles matching a keyword.

01Query parameters

Name	Type	Description
queryrequired	string	Search term, e.g. a name or brand.

02Request

curl "https://api.scrapesocial.ai/v1/instagram/search/profiles?query=national+geographic" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

Real answers from the API. Lists are shortened to 2 items.

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
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notes

Profiles are in `profiles`. Each hit is filled from its public profile: `id`, `full_name`, `biography`, `bio_links`, `external_url`, `is_private`, `is_verified`, the business and professional flags, `category_name`, `profile_pic_url`, `follower_count`, `following_count` and `media_count` (rounded above 10,000 posts when Instagram gives no exact count). A hit whose profile does not answer in time keeps nulls in those fields. `google_title` and `google_description` are null. Results come in one page and `cursor` is always null. No match is an empty list for 0 credits. Web search engines also answer loosely related pages when nothing matches, so only results that name the query's words (in their title, snippet or URL) are kept: a query nothing matches answers the empty list for 0 credits.

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.