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

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

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

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