Locations
Location Story
Description
This endpoint retrieves stories associated with a specific Instagram location based on its location ID.
Endpont
GET api/v1/realtime/social/instagram/v1/locations/{{locationId}}/story/
Parameters
Param
Required
Param Type
Description
locationId
Yes
Path Param
String | The hashtag name for which media information is to be retrieved
Example Request
curl -X GET 'https://api.webit.live/api/v1/realtime/social/instagram/v1/locations/240488270/story/' \
--header 'Authorization: Basic <credential string>'Example Response
{
"reels": {
"location:240488270:1724613099979": {
"id": "location:240488270:1724613099979",
"strong_id__": "location:240488270:1724613099979",
"latest_reel_media": 1724607325,
"seen": 0,
"can_reply": false,
"can_gif_quick_reply": true,
"can_reshare": false,
"can_react_with_avatar": false,
"reel_type": "mas_reel",
"ad_expiry_timestamp_in_millis": null,
"is_cta_sticker_available": null,
"app_sticker_info": null,
"should_treat_link_sticker_as_cta": null,
"pool_refresh_ttl_in_sec": null,
"expiring_at": 1724693725,
"owner": {...},
"location": {
"type": "location",
"pk": "240488270",
"name": "Mykonos International Airport",
"profile_pic_url": "https://instagram.fedi1-1.fna.fbcdn.net/v/t51.29350-15/212565049_832722627637715_2133819703791985873_n.jpg?stp=c0.44.1440.1440a_dst-jpg_e35_s150x150&_nc_ad=z-m&_nc_ht=instagram.fedi1-1.fna.fbcdn.net&_nc_cat=111&_nc_ohc=tSgtoSbDatoQ7kNvgHlVF0W&edm=AA0lj5EBAAAA&ccb=7-5&ig_cache_key=MjYxNDE0MTAxNTk2MTA2NzU2Mw%3D%3D.2.c-ccb7-5&oh=00_AYCeB3b89ZHURspVIcqdIBaSVgH25bqFqsJDBnIVM4M13w&oe=66D166CD&_nc_sid=0a490e",
"lat": 37.434133566496,
"lng": 25.346101645375,
"location_dict": {...},
"short_name": "Mykonos International Airport",
"profile_pic_username": "m_boushehri",
"challenge_id": null
},
"items": [...],
"is_nux": false,
"prefetch_count": 0,
"unique_integer_reel_id": "3441939261113259330",
"media_count": 20,
"media_ids": [...],
"disabled_reply_types": [...]
}
},
"status": "ok"
}Location Map
Description
This endpoint retrieves a list of places centered around a specific geographical coordinate, optionally filtered by category.
Endpont
GET api/v1/realtime/social/instagram/v1/locations/map?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.
radius
Yes
Query Param
Float | The radius in Km from the lat/lan coordinates
category
No
Query Param
Enum | the category of the location. can be one of:
restaurantssightscafeshotelsgardensbars
Example Request
curl -X GET 'https://api.webit.live/api/v1/realtime/social/instagram/v1/locations/map?latitude=40.739372213413816&longitude=-73.99255514144897' \
--header 'Authorization: Basic <credential string>'Example Response
{
"pins": [
{
"lat": 41.44937345101,
"lng": "-72.845621663288",
"location": {...},
"page_info": {...},
"media_id": "3426156791081767231",
"thumbnail_url": "...",
"preview_medias": [
{
"media_id": "3329794255483291961",
"media_fbid": "17875286058061706",
"thumbnail_url": "..."
},
...
],
"media_count": 56614,
"formatted_media_count": "56.6K posts",
"rank": 0,
"story": null,
"has_story": false,
"pin_type": "FEED",
"sticker": null,
"effect": null,
"clip": null
},
],
"refinements": [
{
"display_text": "Restaurants",
"attributes": {
"map_query": {
"query_type": "category",
"query_value": "1436055710025360"
},
"category_id": "1436055710025360"
}
},
...
],
"query_token": "2a77ea1a-0f81-42f2-a10d-282f48492edd",
"list_type": "LIST",
"needs_story_fetch": true,
"needs_profile_fetch": false,
"guides_index": 0,
"needs_guides_fetch": false,
"status": "ok"
}Location Feed
Description
This endpoint retrieves sections of the feed for a specific Instagram location.
Endpont
POST api/v1/realtime/social/instagram/v1/locations/{{locationId}}/sections/
Parameters
Param
Required
Param Type
Description
locationId
Yes
Path Param
String | The hashtag name for which media information is to be retrieved
tab
Yes
Body Param
Enum | The section of the feed to retrieve:
top (default)
ranked
recent
Example Request
curl -X POST 'https://api.webit.live/api/v1/realtime/social/instagram/v1/locations/240488270/sections/' \
--header 'Content-Type: application/json' \
--data '{
"tab": "recent"
}'Example Response
{
"sections": [
{
"layout_type": "media_grid",
"layout_content": {
"medias": [
{
"media": {
"taken_at": 1724613263,
"pk": "3442627847929355285",
"id": "3442627847929355285_8603778219",
"fbid": "18061344655638186",
"device_timestamp": "1724613240947988",
"caption_is_edited": false,
"strong_id__": "3442627847929355285_8603778219",
"deleted_reason": 0,
"has_shared_to_fb": 0,
"has_delayed_metadata": false,
"mezql_token": "",
"share_count_disabled": false,
"is_visual_reply_commenter_notice_enabled": true,
"like_and_view_counts_disabled": false,
"is_post_live_clips_media": false,
"comment_threading_enabled": true,
"is_unified_video": false,
"commerciality_status": "not_commercial",
"client_cache_key": "MzQ0MjYyNzg0NzkyOTM1NTI4NQ==.2",
"integrity_review_decision": "pending",
"should_request_ads": false,
"is_reshare_of_text_post_app_media_in_ig": false,
"has_privately_liked": false,
"filter_type": 0,
"can_see_insights_as_brand": false,
"media_type": 2,
"code": "C_Gq8mxslwV",
"caption": {...},
"fundraiser_tag": {...},
"sharing_friction_info": {...},
"play_count": 31,
"original_media_has_visual_reply_media": false,
"creator_viewer_insights": [],
"fb_user_tags": {...},
"coauthor_producers": [],
"invited_coauthor_producers": [],
"is_in_profile_grid": false,
"profile_grid_control_enabled": false,
"media_cropping_info": {...},
"user": {...},
"owner": {...},
"image_versions2": {...},
"original_width": 982,
"original_height": 1746,
"is_artist_pick": false,
"enable_media_notes_production": false,
"product_type": "clips",
"is_paid_partnership": false,
"location": {...},
"music_metadata": null,
"organic_tracking_token": "...",
"is_third_party_downloads_eligible": true,
"ig_media_sharing_disabled": false,
"are_remixes_crosspostable": false,
"boost_unavailable_identifier": null,
"boost_unavailable_reason": null,
"lng": 25.346101645375,
"lat": 37.434133566496,
"subscribe_cta_visible": false,
"is_cutout_sticker_allowed": false,
"gen_ai_detection_method": {...},
"fb_aggregated_like_count": 0,
"fb_aggregated_comment_count": 0,
"has_high_risk_gen_ai_inform_treatment": false,
"open_carousel_show_follow_button": false,
"is_tagged_media_shared_to_viewer_profile_grid": false,
"should_show_author_pog_for_tagged_media_shared_to_profile_grid": false,
"is_eligible_for_media_note_recs_nux": false,
"is_social_ufi_disabled": false,
"is_eligible_for_meta_ai_share": false,
"can_view_more_preview_comments": false,
"preview_comments": [],
"comment_count": 0,
"hide_view_all_comment_entrypoint": false,
"is_comments_gif_composer_enabled": true,
"comment_inform_treatment": {...},
"has_liked": false,
"like_count": 4,
"facepile_top_likers": [],
"top_likers": [],
"is_dash_eligible": 1,
"video_dash_manifest": "...",
"video_codec": "avc1.64001f",
"number_of_qualities": 4,
"video_versions": [...],
"video_duration": 2.791,
"has_audio": true,
"clips_tab_pinned_user_ids": [],
"clips_metadata": {...},
"can_viewer_save": true,
"can_viewer_reshare": true,
"shop_routing_user_id": null,
"is_organic_product_tagging_eligible": false,
"igbio_product": null,
"product_suggestions": [],
"has_more_comments": false,
"max_num_visible_preview_comments": 2,
"explore_hide_comments": false,
"likers": [...],
"is_open_to_public_submission": false
}
},
...
]
},
"feed_type": "media",
"explore_item_info": {
"num_columns": 3,
"total_num_columns": 3,
"aspect_ratio": 3,
"autoplay": false
}
},
...
],
"more_available": true,
"next_page": 1,
"next_media_ids": [
"3426420204974483639"
],
"next_max_id": "QVFBV25fdlJJRmF2QTRIbjRSNTc2Tzk4QXJRNDBISkw2a2VyUDZfLXVGS3dxTnkwbGFJY0hGZDBpcWxDNlFxUUJZeDFta0pXS3FhUXYweGN4QWx2emRKdg==",
"status": "ok"
}
Last updated