Search

Users Search

Description

This endpoint searches for Instagram users based on a query string.

Endpoint

GET api/v1/realtime/social/instagram/v1/users/search?q={keyword}

Parameters

Param

Required

Param Type

Description

q

Yes

Query Param

String | The search term used to find Instagram users.

Example Request

curl -X GET 'https://api.webit.live/api/v1/realtime/social/instagram/v1/users/search?q=wim%20hof' \
--header 'Authorization: Basic <credential string>'

Example Response

{
    "num_results": 30,
    "users": [
        {
            "pk": 1678411508,
            "pk_id": "1678411508",
            "full_name": "Wim Hof",
            "is_private": false,
            "fbid_v2": "17841400345266225",
            "third_party_downloads_enabled": 2,
            "strong_id__": "1678411508",
            "show_ig_app_switcher_badge": true,
            "id": "1678411508",
            "profile_pic_id": "1579117830469473639_1678411508",
            "profile_pic_url": "https://scontent-mia3-2.cdninstagram.com/v/t51.2885-19/20687104_373447083071014_2355263668880408576_a.jpg?stp=dst-jpg_e0_s150x150&_nc_ht=scontent-mia3-2.cdninstagram.com&_nc_cat=110&_nc_ohc=pL6VYWrUOOoQ7kNvgFPT0SI&edm=AM7KJZYBAAAA&ccb=7-5&oh=00_AYBO1HjfIUdYxX3be1qByWC_XhjQLBp-KBRkAo-hd_jOBA&oe=66D12383&_nc_sid=8ec269",
            "username": "iceman_hof",
            "has_anonymous_profile_picture": false,
            "account_badges": [],
            "is_verified": true,
            "has_opt_eligible_shop": false,
            "show_text_post_app_badge": true,
            "friendship_status": {
                "following": false,
                "is_private": false,
                "incoming_request": false,
                "outgoing_request": false,
                "is_bestie": false,
                "is_restricted": false,
                "is_feed_favorite": false
            },
            "latest_reel_media": 0,
            "is_verified_search_boosted": false,
            "should_show_category": true
        },
        ...
    ],
    "has_more": false,
    "rank_token": "1724598620692|37393af27dc079e3ad78414e2a2c89f6267ee83834eb4e1885c3ad6fe54ac7f4",
    "clear_client_cache": false,
    "status": "ok"
}

Hashtag Search

Description

This endpoint searches for Instagram hashtag.

Endpoint

GET api/v1/realtime/social/instagram/v1/tags/search?q={keyword}

Parameters

Param

Required

Param Type

Description

q

Yes

Query Param

String | The search term or hashtag to find Instagram posts

Example Request

curl -X GET 'https://api.webit.live/api/v1/realtime/social/instagram/v1/tags/search?q=olympics2024' \
--header 'Authorization: Basic <credential string>'

Example Response

{
    "results": [
        {
            "id": "17842077919064646",
            "name": "olympics2024",
            "media_count": 407008,
            "formatted_media_count": "407K",
            "search_result_subtitle": "407K posts",
            "profile_pic_url": "",
            "use_default_avatar": true,
            "challenge_id": 1
        },
        ...
    ],
    "has_more": false,
    "inform_module": null,
    "rank_token": "1724599891213|a2ef0abf85175da1d4bfeb5a8f56a8e50588152eced35e425ce3f4439f414f50",
    "page_token": null,
    "status": "ok"
}

Location Search

Description

This endpoint searches for Instagram posts based on a location specified by latitude and longitude.

Endpoint

GET api/v1/realtime/social/instagram/v1/location_search?latitude={lat}&longitude={lon}

Parameters

Param

Required

Param Type

Description

latitude

Yes

Query Param

Float | The latitude of the location.

longitude

Yes

Query Param

Float | The longitude of the location.

search_query

Query Param

String | An optional search term to refine the search results.

Example Request

curl -X GET 'https://api.webit.live/api/v1/realtime/social/instagram/v1/location_search?latitude=20.216741&longitude=-87.454153' \
--header 'Authorization: Basic <credential string>'

Example Response

{
    "rank_token": "",
    "request_id": "fa16e66a53124af6923da016a3eba6b9",
    "venues": [
        {
            "external_id": 108310065433126,
            "external_id_source": "facebook_places",
            "name": "Tulum, México",
            "address": "0.7mi · Tulum",
            "lat": 20.210472697317,
            "lng": -87.46323
        },
        ...
    ],
    "status": "ok"
}

Top Search

Description

This endpoint performs a top search on Instagram based on a query string

Endpoint

GET api/v1/realtime/social/instagram/v1/fbsearch/top_serp?query={keyword}

Parameters

Param

Required

Param Type

Description

query

Yes

Query Param

String | The search term for finding top results on Instagram

next_max_id

Query Param

String | Send only after the first request, get the value from media_grid

next_max_id in the previous response.

reels_max_id

Query Param

String | Send only after the first request, get the value from media_grid. reels_max_id in the previous response.

rank_token

Query Param

String | Send only after the first request, get the value from media_grid.

rank_token in the previous response.

has_more_reels

Query Param

Boolean | Send only after the first request, get the value from media_grid.

has_more_reels in the previous response.

Example Request

curl -X GET 'https://api.webit.live/api/v1/realtime/social/instagram/v1/fbsearch/top_serp?query=Tel%20Aviv' \
--header 'Authorization: Basic <credential string>'

Example Response

{
    "clear_client_cache": false,
    "media_grid": {
        "refinements": {},
        "sections": [
            {
                "layout_type": "one_by_two_right",
                "layout_content": {
                    "one_by_two_item": {
                        "clips": {
                            "id": "clips-07d2588a-6876-4d2b-ad49-32d12225a3a3",
                            "items": [
                                {
                                    "media": {...}
                                }
                            ],
                            "max_id": "r:8611fb1532ac40a5ab6c16be0990c024",
                            "more_available": true,
                            "design": "bottom_with_icon_horizontal",
                            "label": ""
                        }
                    },
                    "fill_items": [
                        {
                            "media": {...}
                        },
                        ...
                    ]
                },
                "feed_type": "clips",
                "explore_item_info": {
                    "num_columns": 3,
                    "total_num_columns": 3,
                    "aspect_ratio": 1.5,
                    "autoplay": true
                }
            },
            ...
        ],
        "rank_token": "5aea489d-1902-45ba-a3bf-a03e8926d7f2",
        "next_max_id": "70689feaed9942c08c36ed3435d1fb0d",
        "has_more": true,
        "auto_load_more_enabled": true,
        "grid_post_click_experience": "contextual",
        "topic_status": -1,
        "reels_max_id": "r:8611fb1532ac40a5ab6c16be0990c024",
        "has_more_reels": true,
        "reels_page_index": 3,
        "autoplay_type": "single"
    },
    "status": "ok"
}

Account Search

Description

This endpoint searches for Instagram accounts based on a query string

Endpoint

GET api/v1/realtime/social/instagram/v1/fbsearch/account_serp?query={keyword}

Parameters

Param

Required

Param Type

Description

query

Yes

Query Param

String | The search term for finding Instagram accounts.

page_token

Query Param

String | Send only after the first request, get the value from "page_token" in the previous response.

rank_token

Query Param

String | Send only after the first request, get the value from "rank_token" in the previous response.

Example Request

curl -X GET 'https://api.webit.live/api/v1/realtime/social/instagram/v1/fbsearch/account_serp?query=Prince' \
--header 'Authorization: Basic <credential string>'

Example Response

{
    "num_results": 20,
    "users": [
        {
            "pk": 46475666538,
            "pk_id": "46475666538",
            "full_name": "G5 Prince 🛩",
            "is_private": false,
            "fbid_v2": "17841446396159458",
            "third_party_downloads_enabled": 0,
            "strong_id__": "46475666538",
            "id": "46475666538",
            "profile_pic_id": "3400767865216283922_46475666538",
            "profile_pic_url": "https://instagram.fedi1-1.fna.fbcdn.net/v/t51.2885-19/449470118_1114708552967463_1119465779769206927_n.jpg?stp=dst-jpg_e0_s150x150&_nc_ad=z-m&_nc_ht=instagram.fedi1-1.fna.fbcdn.net&_nc_cat=103&_nc_ohc=Sz6k2-T5TTgQ7kNvgHHAFNE&edm=ALgmGsQBAAAA&ccb=7-5&oh=00_AYAYU7y6OdL9dvGSoP7eHPrne60sbUf1WkIgpT6JEBYWVA&oe=66D113DC&_nc_sid=2f557e",
            "username": "princehound_",
            "has_anonymous_profile_picture": false,
            "account_badges": [],
            "is_verified": false,
            "has_opt_eligible_shop": false,
            "friendship_status": {
                "following": false,
                "is_private": false,
                "incoming_request": false,
                "outgoing_request": false,
                "is_bestie": false,
                "is_restricted": false,
                "is_feed_favorite": false
            },
            "latest_reel_media": 1724546464,
            "is_verified_search_boosted": false,
            "search_serp_type": 3,
            "should_show_category": true
        },
        ...
    ],
    "has_more": true,
    "rank_token": "1724601219327|5fe113c71dbca0ba0ee5186a73950178df21abf147925db3a31a3364e58eaf45",
    "clear_client_cache": false,
    "page_token": "edc5ebab357b4735b819106639df4bb4",
    "status": "ok"
}

Places Search

Description

This endpoint searches for Instagram places based on a query string.

Endpoint

GET api/v1/realtime/social/instagram/v1/fbsearch/places?query={keyword}

Parameters

Param

Required

Param Type

Description

query

Yes

Query Param

String | The search term or place to find Instagram posts

Example Request

curl -X GET 'https://api.webit.live/api/v1/realtime/social/instagram/v1/fbsearch/places?query=Japan' \
--header 'Authorization: Basic <credential string>'

Example Response

{
    "items": [
        {
            "location": {
                "pk": 271456804,
                "short_name": "Japan",
                "facebook_places_id": 105672799466531,
                "external_source": "facebook_places",
                "name": "Japan",
                "address": "",
                "city": "",
                "has_viewer_saved": false,
                "lng": 136,
                "lat": 35
            },
            "title": "Japan",
            "subtitle": ""
        },
        ...
    ],
    "has_more": false,
    "rank_token": "1724601435945|09b3ae2525b66e8ce4ddd8d5de7f0c35c2ba8642bf6e5368f81b3f5bf00641be",
    "status": "ok"
}

Last updated 11 months ago