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
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.
Endpont
GET api/v1/realtime/social/instagram/v1/tags/search?q={keyword}
Parameters
Param
Required
Param Type
Description
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
Float | The latitude of the location.
Float | The longitude of the location.
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
String | The search term for finding top results on Instagram
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
Endpont
GET api/v1/realtime/social/instagram/v1/fbsearch/account_serp?query={keyword}
Parameters
Param
Required
Param Type
Description
String | The search term for finding Instagram accounts.
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
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
