Profiles

User Info

Description

This endpoint retrieves detailed information about a specific Instagram user based on their user ID.

Endpont

GET api/v1/realtime/social/instagram/v1/users/{userId}/info

Parameters

Param
Required
Param Type
Description

userId

Yes

Path Param

String | The unique identifier for the Instagram user whose information is to be retrieved

Example Request
curl -X GET 'https://api.webit.live/api/v1/realtime/social/instagram/v1/users/8576021806/info' \
--header 'Authorization: Basic <credential string>'
Example Response
{
    "user": {
        "primary_profile_link_type": 0,
        "show_fb_link_on_profile": false,
        "show_fb_page_link_on_profile": false,
        "can_hide_category": true,
        "account_type": 2,
        "current_catalog_id": null,
        "mini_shop_seller_onboarding_status": null,
        "account_category": "",
        "can_add_fb_group_link_on_profile": false,
        "can_use_affiliate_partnership_messaging_as_creator": false,
        "can_use_affiliate_partnership_messaging_as_brand": false,
        "existing_user_age_collection_enabled": true,
        "fbid_v2": "17841400345266225",
        "feed_post_reshare_disabled": false,
        "full_name": "Wim Hof",
        "has_guides": false,
        "has_ig_profile": true,
        "has_public_tab_threads": true,
        "highlight_reshare_disabled": false,
        "include_direct_blacklist_status": true,
        "is_direct_roll_call_enabled": true,
        "is_eligible_for_meta_verified_links_in_reels": true,
        "is_new_to_instagram": false,
        "is_parenting_account": false,
        "is_private": false,
        "is_secondary_account_creation": false,
        "pk": 1678411508,
        "pk_id": "1678411508",
        "profile_type": 0,
        "show_account_transparency_details": true,
        "show_ig_app_switcher_badge": true,
        "show_post_insights_entry_point": true,
        "show_text_post_app_switcher_badge": true,
        "third_party_downloads_enabled": 2,
        "is_opal_enabled": false,
        "strong_id__": "1678411508",
        "id": "1678411508",
        "biography": "Guided breathing bubble | Events | Online courses | Videos | Latest news ❤️❄️↙️",
        "biography_with_entities": {...},
        "external_lynx_url": "...",
        "external_url": "http://linktr.ee/iceman_hof",
        "can_hide_public_contacts": true,
        "category": "",
        "should_show_category": true,
        "category_id": 0,
        "is_category_tappable": true,
        "should_show_public_contacts": true,
        "is_eligible_for_smb_support_flow": true,
        "is_eligible_for_lead_center": true,
        "lead_details_app_id": "com.bloks.www.ig.smb.lead_gen.subpage",
        "is_business": true,
        "professional_conversion_suggested_account_type": 3,
        "direct_messaging": "UNKNOWN",
        "fb_page_call_to_action_id": "",
        "instagram_location_id": "139200219431269",
        "address_street": "",
        "business_contact_method": "UNKNOWN",
        "city_id": 0,
        "city_name": "",
        "contact_phone_number": "",
        "is_profile_audio_call_enabled": false,
        "latitude": 0,
        "longitude": 0,
        "public_email": "[email protected]",
        "public_phone_country_code": "",
        "public_phone_number": "",
        "zip": "",
        "displayed_action_button_partner": null,
        "smb_delivery_partner": null,
        "smb_support_delivery_partner": null,
        "displayed_action_button_type": "",
        "smb_support_partner": null,
        "is_call_to_action_enabled": false,
        "num_of_admined_pages": null,
        "page_id": 139200219431269,
        "page_name": "The Iceman (Wim Hof)",
        "ads_page_id": 139200219431269,
        "ads_page_name": "The Iceman (Wim Hof)",
        "shopping_post_onboard_nux_type": null,
        "ads_incentive_expiration_date": null,
        "account_badges": [],
        "active_standalone_fundraisers": {...},
        "additional_business_addresses": [],
        "auto_expand_chaining": null,
        "avatar_status": {...},
        "bio_links": [...],
        "birthday_today_visibility_for_viewer": "NOT_VISIBLE",
        "broadcast_chat_preference_status": {...},
        "can_use_branded_content_discovery_as_brand": false,
        "can_use_branded_content_discovery_as_creator": false,
        "can_use_paid_partnership_messaging_as_creator": true,
        "chaining_upsell_cards": [],
        "charity_profile_fundraiser_info": {...},
        "creator_shopping_info": {
            "linked_merchant_accounts": []
        },
        "enable_add_school_in_edit_profile": false,
        "fan_club_info": {...},
        "follow_friction_type": 0,
        "follower_count": 3562759,
        "following_count": 0,
        "has_active_charity_business_profile_fundraiser": false,
        "has_anonymous_profile_picture": false,
        "has_chaining": true,
        "has_chains": false,
        "has_collab_collections": false,
        "has_exclusive_feed_content": false,
        "has_fan_club_subscriptions": false,
        "has_highlight_reels": true,
        "has_igtv_series": false,
        "has_music_on_profile": false,
        "has_private_collections": false,
        "has_videos": true,
        "hd_profile_pic_url_info": {...},
        "hd_profile_pic_versions": [...],
        "highlights_tray_type": "DEFAULT",
        "interop_messaging_user_fbid": 109610587101592,
        "is_bestie": false,
        "is_creator_agent_enabled": false,
        "is_eligible_for_diverse_owned_business_info": false,
        "is_eligible_for_meta_verified_enhanced_link_sheet": false,
        "is_eligible_for_meta_verified_enhanced_link_sheet_consumption": false,
        "is_eligible_for_meta_verified_multiple_addresses_creation": false,
        "is_eligible_for_meta_verified_multiple_addresses_consumption": false,
        "is_eligible_for_meta_verified_related_accounts": false,
        "is_eligible_for_post_boost_mv_upsell": false,
        "meta_verified_related_accounts_count": 0,
        "is_meta_verified_related_accounts_display_enabled": false,
        "is_eligible_for_meta_verified_label": true,
        "is_eligible_to_display_diverse_owned_business_info": false,
        "is_facebook_onboarded_charity": false,
        "is_favorite": false,
        "is_favorite_for_stories": false,
        "is_favorite_for_igtv": false,
        "is_favorite_for_clips": false,
        "is_favorite_for_highlights": false,
        "is_in_canada": false,
        "is_interest_account": true,
        "is_memorialized": false,
        "is_potential_business": false,
        "is_regulated_news_in_viewer_location": false,
        "is_remix_setting_enabled_for_posts": true,
        "is_remix_setting_enabled_for_reels": true,
        "is_profile_broadcast_sharing_enabled": true,
        "is_regulated_c18": false,
        "is_stories_teaser_muted": false,
        "is_recon_ad_cta_on_profile_eligible_with_viewer": true,
        "is_supervision_features_enabled": false,
        "is_verified": true,
        "is_whatsapp_linked": false,
        "latest_besties_reel_media": 0,
        "latest_reel_media": 0,
        "live_subscription_status": "default",
        "media_count": 2393,
        "merchant_checkout_style": "none",
        "mutual_followers_count": 0,
        "nametag": {...},
        "profile_context": "",
        "profile_context_facepile_users": [],
        "profile_context_links_with_user_ids": [],
        "profile_pic_id": "1579117830469473639_1678411508",
        "profile_pic_url": "...",
        "pronouns": [],
        "recon_features": {...},
        "relevant_news_regulation_locations": [],
        "remove_message_entrypoint": false,
        "seller_shoppable_feed_type": "none",
        "show_schools_badge": null,
        "show_shoppable_feed": false,
        "show_text_post_app_badge": true,
        "spam_follower_setting_enabled": true,
        "text_app_last_visited_time": null,
        "text_post_app_joiner_number_label": "100M+",
        "text_post_app_badge_label": "100M+",
        "text_post_new_post_count": 0,
        "eligible_for_text_app_activation_badge": false,
        "total_ar_effects": 0,
        "total_clips_count": 1,
        "total_igtv_videos": 19,
        "transparency_product_enabled": false,
        "upcoming_events": [],
        "username": "iceman_hof",
        "whatsapp_number": "",
        "is_profile_picture_expansion_enabled": true,
        "recs_from_friends": {...},
        "adjusted_banners_order": [],
        "is_eligible_for_request_message": false,
        "is_open_to_collab": false,
        "threads_profile_glyph_url": "https://www.threads.net/@iceman_hof?xmt=AQGzh8K_l7oCw19OseFI6yZi62KrhlvXeqaP5JyvG6j49aE",
        "has_ever_selected_topics": false,
        "is_oregon_custom_gender_consented": false
    },
    "status": "ok"
}

Username Info

Description

This endpoint retrieves detailed information about an Instagram user based on their username.

Endpont

GET api/v1/realtime/social/instagram/v1/users/{username}/usernameinfo

Parameters

Param
Required
Param Type
Description

username

Yes

Path Param

The Instagram username of the user whose information is to be retrieved

Example Request
curl -X GET 'https://api.webit.live/api/v1/realtime/social/instagram/v1/users/iceman_hof/usernameinfo' \
--header 'Authorization: Basic <credential string>'
Example Response
{
    "user": {
        "primary_profile_link_type": 0,
        "show_fb_link_on_profile": false,
        "show_fb_page_link_on_profile": false,
        "can_hide_category": true,
        "account_type": 2,
        "can_add_fb_group_link_on_profile": false,
        "fbid_v2": "17841400345266225",
        "full_name": "Wim Hof",
        "is_private": false,
        "pk": 1678411508,
        "pk_id": "1678411508",
        "third_party_downloads_enabled": 2,
        "current_catalog_id": null,
        "mini_shop_seller_onboarding_status": null,
        "has_guides": false,
        "is_parenting_account": false,
        "show_ig_app_switcher_badge": true,
        "show_text_post_app_switcher_badge": true,
        "strong_id__": "1678411508",
        "id": "1678411508",
        "biography": "Guided breathing bubble | Events | Online courses | Videos | Latest news ❤️❄️↙️",
        "biography_with_entities": {...},
        "external_lynx_url": "https://l.instagram.com/?u=http%3A%2F%2Flinktr.ee%2Ficeman_hof%3Ffbclid%3DPAZXh0bgNhZW0CMTEAAabsEJtM-XvKhdU8LzcpGarLU7GlFJmmsAKtMAktLHEaH_CknCeAa1Q_beE_aem_UxDZ2SrKRjeOKLEdSFvLew&e=AT0_8yE0Xm4bzgVJgVYnsJQuX3chDhppbqx2qAj8BDeDSxU1jiPMxHEDgcjhRt84XQuaparhuJqBqUHGYJIJLtUDthw0JS-0rkL7kkg",
        "external_url": "http://linktr.ee/iceman_hof",
        "can_hide_public_contacts": true,
        "category": "",
        "should_show_category": true,
        "category_id": 0,
        "is_category_tappable": true,
        "should_show_public_contacts": true,
        "is_eligible_for_smb_support_flow": true,
        "is_eligible_for_lead_center": true,
        "lead_details_app_id": "com.bloks.www.ig.smb.lead_gen.subpage",
        "is_business": true,
        "professional_conversion_suggested_account_type": 3,
        "direct_messaging": "UNKNOWN",
        "fb_page_call_to_action_id": "",
        "instagram_location_id": "139200219431269",
        "address_street": "",
        "business_contact_method": "UNKNOWN",
        "city_id": 0,
        "city_name": "",
        "contact_phone_number": "",
        "is_profile_audio_call_enabled": false,
        "latitude": 0,
        "longitude": 0,
        "public_email": "[email protected]",
        "public_phone_country_code": "",
        "public_phone_number": "",
        "zip": "",
        "displayed_action_button_partner": null,
        "smb_delivery_partner": null,
        "smb_support_delivery_partner": null,
        "displayed_action_button_type": "",
        "smb_support_partner": null,
        "is_call_to_action_enabled": false,
        "num_of_admined_pages": null,
        "page_id": 139200219431269,
        "page_name": "The Iceman (Wim Hof)",
        "ads_page_id": 139200219431269,
        "ads_page_name": "The Iceman (Wim Hof)",
        "bio_links": [...],
        "account_badges": [],
        "follower_count": 3562755,
        "following_count": 0,
        "has_anonymous_profile_picture": false,
        "is_verified": true,
        "latest_reel_media": 0,
        "media_count": 2393,
        "profile_pic_id": "1579117830469473639_1678411508",
        "username": "iceman_hof",
        "shopping_post_onboard_nux_type": null,
        "ads_incentive_expiration_date": null,
        "active_standalone_fundraisers": {...},
        "charity_profile_fundraiser_info": {...},
        "has_active_charity_business_profile_fundraiser": false,
        "has_chaining": true,
        "has_igtv_series": false,
        "hd_profile_pic_url_info": {...},
        "hd_profile_pic_versions": [...],
        "is_facebook_onboarded_charity": false,
        "is_favorite": false,
        "is_favorite_for_clips": false,
        "is_favorite_for_igtv": false,
        "is_favorite_for_stories": false,
        "live_subscription_status": "default",
        "merchant_checkout_style": "none",
        "mutual_followers_count": 0,
        "pinned_channels_info": {...},
        "profile_context": "",
        "profile_context_links_with_user_ids": [],
        "profile_context_facepile_users": [],
        "profile_pic_url": "https://scontent-iad3-1.cdninstagram.com/v/t51.2885-19/20687104_373447083071014_2355263668880408576_a.jpg?stp=dst-jpg_e0_s150x150&_nc_ht=scontent-iad3-1.cdninstagram.com&_nc_cat=110&_nc_ohc=pL6VYWrUOOoQ7kNvgGvLXp2&edm=AKralEIBAAAA&ccb=7-5&oh=00_AYDwrd1R1cGxQVITGfD84y5zTMTIRcMoaz0u0xEbXA4Kqw&oe=66D12383&_nc_sid=2fe71f",
        "seller_shoppable_feed_type": "none",
        "show_shoppable_feed": false,
        "show_text_post_app_badge": true,
        "text_post_app_joiner_number_label": "100M+",
        "eligible_for_text_app_activation_badge": false,
        "total_clips_count": 1,
        "total_igtv_videos": 19,
        "upcoming_events": [],
        "adjusted_banners_order": [],
        "is_eligible_for_request_message": false,
        "is_open_to_collab": false
    },
    "status": "ok"
}

User Feed

Description

This endpoint retrieves the feed of posts for a specific Instagram user based on their user ID.

Endpont

GET api/v1/realtime/social/instagram/v1/feed/user/{userId}

Parameters

Param
Required
Param Type
Description

userId

Yes

Path Param

String | The unique identifier for the Instagram user whose information is to be retrieved

Example Request
curl -X GET 'https://api.webit.live/api/v1/realtime/social/instagram/v1/feed/user/8576021806' \
--header 'Authorization: Basic <credential string>'
Example Response
{
    "profile_grid_items": null,
    "profile_grid_items_cursor": null,
    "pinned_profile_grid_items_ids": null,
    "num_results": 12,
    "more_available": true,
    "items": [...],
    "next_max_id": "3423024352180611841_1678411508",
    "user": {
        "pk": 1678411508,
        "pk_id": "1678411508",
        "full_name": "Wim Hof",
        "is_private": false,
        "strong_id__": "1678411508",
        "profile_grid_display_type": "default",
        "id": "1678411508",
        "username": "iceman_hof",
        "is_verified": true,
        "profile_pic_id": "1579117830469473639_1678411508",
        "profile_pic_url": "https://scontent-dfw5-1.cdninstagram.com/v/t51.2885-19/20687104_373447083071014_2355263668880408576_a.jpg?stp=dst-jpg_e0_s150x150&_nc_ht=scontent-dfw5-1.cdninstagram.com&_nc_cat=110&_nc_ohc=pL6VYWrUOOoQ7kNvgGXSVy-&edm=ABmJApABAAAA&ccb=7-5&oh=00_AYBsVq086Su80bW3tZaU1rjgoGjWVGNbnPEj1cD6BaputQ&oe=66D12383&_nc_sid=b41fef"
    },
    "auto_load_more_enabled": true,
    "status": "ok"
}

User Followers

Description

This endpoint retrieves a list of followers for a specific Instagram user based on their user ID.

Endpont

GET api/v1/realtime/social/instagram/v1/friendships/{userId}/followers

Parameters

Param
Required
Param Type
Description

userId

Yes

Path Param

String | The unique identifier for the Instagram user whose information is to be retrieved

Example Request
curl -X GET 'https://api.webit.live/api/v1/realtime/social/instagram/v1/friendships/8576021806/followers' \
--header 'Authorization: Basic <credential string>'
Example Response
{
    "users": [
        {
            "pk": 68756284677,
            "pk_id": "68756284677",
            "id": "68756284677",
            "full_name": "",
            "is_private": true,
            "fbid_v2": "17841468780324535",
            "third_party_downloads_enabled": 0,
            "strong_id__": "68756284677",
            "profile_pic_id": "3442429531422170871_68756284677",
            "profile_pic_url": "https://instagram.fedi1-1.fna.fbcdn.net/v/t51.2885-19/456560893_1021612722618858_1056436897878728372_n.jpg?stp=dst-jpg_e0_s150x150&_nc_ad=z-m&_nc_ht=instagram.fedi1-1.fna.fbcdn.net&_nc_cat=106&_nc_ohc=egGX7yPkQGMQ7kNvgGiKGaO&edm=APQMUHMBAAAA&ccb=7-5&oh=00_AYBKSebR1SHTYIMod7eUvsmtkncCTKe7HlsuiAGDcaDfoA&oe=66D14860&_nc_sid=6ff7c8",
            "is_verified": false,
            "username": "celesterodriguez6075",
            "has_anonymous_profile_picture": false,
            "account_badges": [],
            "latest_reel_media": 0
        },
        ...
    ],
    "big_list": false,
    "page_size": 49,
    "has_more": false,
    "should_limit_list_of_followers": false,
    "use_clickable_see_more": false,
    "show_spam_follow_request_tab": false,
    "status": "ok"
}

User Following

Description

This endpoint retrieves a list of users that a specific Instagram user is following, based on their user ID.

Endpont

GET api/v1/realtime/social/instagram/v1/friendships/{userId}/following?rank_token={token}

Parameters

Param
Required
Param Type
Description

userId

Yes

Path Param

String | The unique identifier for the Instagram user whose information is to be retrieved

rank_token

Yes

Query Param

String | A UUID version 5 used for ranking and pagination. For each request, generate a new UUID, and use the same rank_token for all pagination requests. (see here)

Example Request
curl -X GET 'https://api.webit.live/api/v1/realtime/social/instagram/v1/friendships/6625549790/following?rank_token=6cc09a49-07a2-4562-8099-02cbd2c1ca0f' \
--header 'Authorization: Basic <credential string>'
Example Response
{
    "users": [
        {
            "pk": 57878512329,
            "pk_id": "57878512329",
            "id": "57878512329",
            "full_name": "Arthur",
            "is_private": false,
            "fbid_v2": "17841457849874814",
            "third_party_downloads_enabled": 0,
            "strong_id__": "57878512329",
            "profile_pic_id": "3355739642401448670_57878512329",
            "profile_pic_url": "https://scontent-lga3-2.cdninstagram.com/v/t51.2885-19/440173268_803708755006579_4347620883227966308_n.jpg?stp=dst-jpg_e0_s150x150&_nc_ht=scontent-lga3-2.cdninstagram.com&_nc_cat=107&_nc_ohc=qmWgtJxBBggQ7kNvgEybDRr&edm=ALB854YBAAAA&ccb=7-5&oh=00_AYBpof6FBqtVzhGjJ1JcU2IzGIqcI1jN4xCBzWhry8eieA&oe=66D11DCA&_nc_sid=ce9561",
            "is_verified": false,
            "username": "arthurblns",
            "has_anonymous_profile_picture": false,
            "account_badges": [],
            "latest_reel_media": 1724536355,
            "is_favorite": false
        },
        ...
    ],
    "big_list": true,
    "page_size": 25,
    "next_max_id": "25",
    "hashtag_count": 0,
    "preview_hashtags": [],
    "has_more": false,
    "should_limit_list_of_followers": false,
    "use_clickable_see_more": false,
    "status": "ok"
}

User Reels

Description

This endpoint retrieves the reels (short video clips) for a specific Instagram user based on their user ID.

Endpont

POST api/v1/realtime/social/instagram/v1/clips/users/

Parameters

Param
Required
Param Type
Description

target_user_id

Yes

Body Param

String | The unique identifier for the Instagram user whose information is to be retrieved

Example Request
curl -X POST 'https://api.webit.live/api/v1/realtime/social/instagram/v1/clips/users/' \
--header 'Authorization: Basic <credential string>' \
--header 'Content-Type: application/json' \
--data '{
    "target_user_id":"1678411508"
}'
Example Response
{
    "items": [
        {
            "media": {
                "taken_at": 1724347901,
                "pk": "3440401750515830427",
                "id": "3440401750515830427_1678411508",
                "fbid": "18051834568765184",
                "device_timestamp": 1724347859,
                "caption_is_edited": false,
                "strong_id__": "3440401750515830427_1678411508",
                "deleted_reason": 0,
                "has_shared_to_fb": 0,
                "has_delayed_metadata": false,
                "mezql_token": "",
                "share_count_disabled": false,
                "view_state_item_type": 128,
                "logging_info_token": "GCBiNzg2YzEzZjU1NmQ0NWQ4OGRmYTA2YTM2NjVjMGFhMQA=",
                "is_visual_reply_commenter_notice_enabled": true,
                "like_and_view_counts_disabled": false,
                "is_post_live_clips_media": false,
                "comment_threading_enabled": false,
                "is_unified_video": false,
                "commerciality_status": "not_commercial",
                "client_cache_key": "MzQ0MDQwMTc1MDUxNTgzMDQyNw==.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--wyoAIM6b",
                "caption": {...},
                "fundraiser_tag": {...},
                "sharing_friction_info": {...},
                "play_count": 821908,
                "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": 1080,
                "original_height": 1920,
                "is_artist_pick": false,
                "enable_media_notes_production": false,
                "product_type": "clips",
                "is_paid_partnership": false,
                "music_metadata": null,
                "social_context": [],
                "organic_tracking_token": "...",
                "is_third_party_downloads_eligible": false,
                "ig_media_sharing_disabled": false,
                "are_remixes_crosspostable": false,
                "boost_unavailable_identifier": null,
                "boost_unavailable_reason": null,
                "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,
                "clips_delivery_parameters": {},
                "is_reuse_allowed": true,
                "can_view_more_preview_comments": false,
                "comment_count": 155,
                "hide_view_all_comment_entrypoint": false,
                "is_comments_gif_composer_enabled": true,
                "comment_inform_treatment": {...},
                "has_liked": false,
                "like_count": 11765,
                "facepile_top_likers": [],
                "top_likers": [],
                "video_subtitles_locale": "en_US",
                "is_dash_eligible": 1,
                "video_dash_manifest": "...",
                "video_codec": "vp09.00.31.08.00.01.01.01.00",
                "number_of_qualities": 8,
                "video_versions": [...],
                "video_duration": 53.44,
                "has_audio": true,
                "clips_tab_pinned_user_ids": [],
                "clips_metadata": {...},
                "can_viewer_save": true,
                "can_viewer_reshare": true,
                "reshare_count": 2302,
                "shop_routing_user_id": null,
                "is_organic_product_tagging_eligible": false,
                "igbio_product": null,
                "featured_products": [],
                "product_suggestions": [],
                "commerce_integrity_review_decision": "",
                "has_more_comments": true,
                "max_num_visible_preview_comments": 2,
                "explore_hide_comments": false,
                "is_open_to_public_submission": false
            }
        },
        ...
    ],
    "paging_info": {
        "max_id": "QVFEVFZZdXlBXzVhWHNsUEdaSHJ2UmxTOU4wNzhMb1JXR0xrTGJRNm9iSlRhRXpqeHVuZ2pfUGJlbWpYbmdlRFRvR2diWU1MWmg2Q3NqUkZnWWFXT0I5Uw==",
        "more_available": true
    },
    "status": "ok"
}

User Tags Feed

Description

Endpont

GET api/v1/realtime/social/instagram/v1/usertags/{userId}/feed

Request Params

Param
Required
Param Type
Description

userId

Yes

Path Param

String | The unique identifier for the Instagram user whose information is to be retrieved

Example Request
curl -X GET 'https://api.webit.live/api/v1/realtime/social/instagram/v1/usertags/4248983367/feed' \
--header 'Authorization: Basic <credential string>'
Example Response
{
    "num_results": 21,
    "more_available": true,
    "items": [
        {
            "taken_at": 1589759824,
            "pk": "2311395392140752641",
            "id": "2311395392140752641_3491164",
            "fbid": "17860218631895351",
            "device_timestamp": "1589759648754731",
            "caption_is_edited": true,
            "strong_id__": "2311395392140752641_3491164",
            "deleted_reason": 0,
            "has_shared_to_fb": 0,
            "has_delayed_metadata": false,
            "is_quiet_post": 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": "MjMxMTM5NTM5MjE0MDc1MjY0MQ==.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,
            "usertags": {...},
            "photo_of_you": false,
            "can_see_insights_as_brand": false,
            "media_type": 1,
            "code": "CATudzkBjcB",
            "caption": {...},
            "fundraiser_tag": {...},
            "sharing_friction_info": {...},
            "original_media_has_visual_reply_media": false,
            "fb_user_tags": {...},
            "coauthor_producers": [],
            "invited_coauthor_producers": [],
            "mashup_info": {...},
            "is_in_profile_grid": false,
            "profile_grid_control_enabled": false,
            "user": {...},
            "owner": {...},
            "image_versions2": {...},
            "original_width": 1213,
            "original_height": 1251,
            "enable_media_notes_production": false,
            "product_type": "feed",
            "is_paid_partnership": false,
            "location": {...},
            "music_metadata": {...},
            "organic_tracking_token": "...",
            "ig_media_sharing_disabled": false,
            "boost_unavailable_identifier": null,
            "boost_unavailable_reason": null,
            "lng": 151.20723,
            "lat": -33.87096,
            "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,
            "is_reuse_allowed": false,
            "can_view_more_preview_comments": false,
            "preview_comments": [],
            "comment_count": 17,
            "hide_view_all_comment_entrypoint": false,
            "inline_composer_display_condition": "impression_trigger",
            "inline_composer_imp_trigger_time": 5,
            "is_comments_gif_composer_enabled": true,
            "comment_inform_treatment": {...},
            "has_liked": false,
            "like_count": 270,
            "clips_tab_pinned_user_ids": [],
            "can_viewer_save": true,
            "can_viewer_reshare": true,
            "shop_routing_user_id": null,
            "is_organic_product_tagging_eligible": false,
            "igbio_product": null,
            "featured_products": [],
            "product_suggestions": [],
            "has_more_comments": true,
            "max_num_visible_preview_comments": 2,
            "explore_hide_comments": false,
            "is_open_to_public_submission": false
        },
        ...
    ],
    "auto_load_more_enabled": true,
    "next_max_id": "2046647431686051138",
    "new_photos": [],
    "requires_review": false,
    "total_count": 1267,
    "status": "ok"
}

User Story

Description

This endpoint retrieves the current Instagram stories of a specific user based on their user ID.

Endpont

GET api/v1/realtime/social/instagram/v1/feed/user/{userId}/story

Parameters

Param
Required
Param Type
Description

userId

Yes

Path Param

String | The unique identifier for the Instagram user whose information is to be retrieved

Example Request
curl -X GET 'https://api.webit.live/api/v1/realtime/social/instagram/v1/feed/user/19410587/story' \
--header 'Authorization: Basic <credential string>'
Example Response
{
    "broadcast": null,
    "reel": {
        "id": 19410587,
        "strong_id__": "19410587",
        "latest_reel_media": 1724542517,
        "seen": 0,
        "can_reply": false,
        "can_gif_quick_reply": true,
        "can_reshare": true,
        "can_react_with_avatar": false,
        "reel_type": "user_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": 1724628917,
        "user": {...},
        "items": [...],
        "is_nux": false,
        "prefetch_count": 0,
        "has_besties_media": false,
        "media_count": 4,
        "media_ids": [...],
        "has_fan_club_media": false,
        "show_fan_club_stories_teaser": false,
        "disabled_reply_types": [...]
    },
    "status": "ok"
}

User Highlights

Description

This endpoint retrieves the highlights tray (saved stories) for a specific Instagram user based on their user ID.

Endpont

GET api/v1/realtime/social/instagram/v1/highlights/{userId}/highlights_tray

Parameters

Param
Required
Param Type
Description

userId

Yes

Path Param

String | The unique identifier for the Instagram user whose information is to be retrieved

Example Request
curl -X GET 'https://api.staging.webit.live/api/v1/highlights/217723373/highlights_tray' \
--header 'Authorization: Basic <credential string>'
Example Response
{
    "tray": [
        {
            "id": "highlight:17983358414459755",
            "strong_id__": "highlight:17983358414459755",
            "latest_reel_media": 1721609792,
            "seen": null,
            "can_reply": true,
            "can_gif_quick_reply": true,
            "can_reshare": null,
            "can_react_with_avatar": false,
            "reel_type": "highlight_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,
            "cover_media": {...},
            "user": {...},
            "ranked_position": -1721609849,
            "title": "🇺🇸",
            "created_at": 1706072311,
            "is_pinned_highlight": false,
            "seen_ranked_position": -1721609849,
            "prefetch_count": 0,
            "media_count": 46,
            "is_converted_to_clips": false,
            "disabled_reply_types": [...],
            "highlight_reel_type": "DEFAULT",
            "is_added_to_main_grid": false
        },
        ...
    ],
    "has_fetched_all_remaining_highlights": null,
    "last_paginated_highlights_node_edited_at_ts": null,
    "suggested_highlights": {},
    "cursor": null,
    "highlights_tray_type": "DEFAULT",
    "my_week_enabled": null,
    "status": "ok"
}

User Highlight Media

Description

This endpoint retrieves media from specified Instagram highlight reels.

Endpont

POST api/v1/realtime/social/instagram/v1/feed/reels_media_stream

Parameters

Param
Required
Param Type
Description

highlight_id

Yes

Body Param

List | A list of highlight reel IDs for which media is to be retrieved. Each ID should be in the format highlight:{ID}

Example Request
curl -X POST 'https://api.webit.live/api/v1/realtime/social/instagram/v1/feed/reels_media_stream/' \
--header 'Authorization: Basic <credential string>' \
--header 'Content-Type: application/json' \
--data '{
    "highlight_id": [
       "highlight:17894273282835396",
       "highlight:18258965881159660",
       "highlight:18048036724453539",
       "highlight:17940928880657332",
       "highlight:17984467709177464",
       "highlight:17973155732379398",
       "highlight:17972130146221751",
       "highlight:17926963691705879"
    ]
 }'
Example Response
{
    "reels": {
        "highlight:17894273282835396": {
            "id": "highlight:17894273282835396",
            "strong_id__": "highlight:17894273282835396",
            "latest_reel_media": 1687696750,
            "seen": null,
            "can_reply": true,
            "can_gif_quick_reply": true,
            "can_reshare": true,
            "can_react_with_avatar": false,
            "reel_type": "highlight_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,
            "cover_media": {...},
            "user": {...},
            "items": [...],
            "is_nux": false,
            "title": "🥘",
            "created_at": 1688511028,
            "is_pinned_highlight": false,
            "prefetch_count": 0,
            "media_count": 5,
            "media_ids": [...],
            "is_cacheable": true,
            "is_converted_to_clips": false,
            "disabled_reply_types": [...],
            "highlight_reel_type": "DEFAULT",
            "is_added_to_main_grid": false
        },
        "highlight:18258965881159660": {...},
        "highlight:18048036724453539": {...},
        "highlight:17940928880657332": {...},
        "highlight:17984467709177464": {...},
        "highlight:17973155732379398": {...},
        "highlight:17926963691705879": {...}
    },
    "status": "ok"
}

Last updated