eternalsocial.dev
Instagram

Get Instagram reels

POST
/api/instagram/reels

Authorization

bearerAuth
AuthorizationBearer <token>

JWT token from /auth/login or API key from /keys

In: header

Request Body

application/json

username*string
Length1 <= length
maxReels?number

Maximum number of reels to fetch. Charged per 10 reels.

Default10
Range1 <= value <= 1000
oldestDate?number

Only include reels posted on or after this date (Unix timestamp in milliseconds).

webhookUrl?string

Webhook URL to receive results. If provided, request returns immediately.

Formaturi

Response Body

application/json

application/json

application/json

curl -X POST "http://localhost:3222/api/instagram/reels" \  -H "Content-Type: application/json" \  -d '{    "username": "instagram"  }'
{
  "success": true,
  "requestId": "string",
  "data": [
    {
      "id": "string",
      "pk": "string",
      "code": "string",
      "shortcode": "string",
      "taken_at": 0,
      "media_type": 0,
      "product_type": "string",
      "image_versions2": {
        "candidates": [
          {
            "url": "string",
            "width": 0,
            "height": 0
          }
        ]
      },
      "video_versions": [
        {
          "url": "string"
        }
      ],
      "play_count": 0,
      "view_count": 0,
      "like_count": 0,
      "comment_count": 0,
      "share_count": 0,
      "caption": {
        "text": "string",
        "pk": "string",
        "user_id": "string",
        "created_at": 0
      },
      "user": {
        "pk": "string",
        "pk_id": "string",
        "id": "string",
        "strong_id__": "string",
        "fbid_v2": "string",
        "username": "string",
        "full_name": "string",
        "profile_pic_url": "string",
        "profile_pic_id": "string",
        "has_anonymous_profile_picture": true,
        "is_verified": true,
        "is_private": true,
        "third_party_downloads_enabled": 0,
        "account_badges": [
          null
        ],
        "latest_reel_media": 0,
        "is_verified_search_boosted": true,
        "is_ring_creator": true,
        "show_ring_award": true,
        "social_context": null,
        "search_social_context": "string",
        "search_social_context_snippet_type": 0,
        "should_show_category": true,
        "has_opt_eligible_shop": true,
        "show_text_post_app_badge": true,
        "show_ig_app_switcher_badge": true,
        "unseen_count": 0,
        "friendship_status": null
      },
      "owner": {
        "pk": "string",
        "pk_id": "string",
        "id": "string",
        "strong_id__": "string",
        "fbid_v2": "string",
        "username": "string",
        "full_name": "string",
        "profile_pic_url": "string",
        "profile_pic_id": "string",
        "has_anonymous_profile_picture": true,
        "is_verified": true,
        "is_private": true,
        "third_party_downloads_enabled": 0,
        "account_badges": [
          null
        ],
        "latest_reel_media": 0,
        "is_verified_search_boosted": true,
        "is_ring_creator": true,
        "show_ring_award": true,
        "social_context": null,
        "search_social_context": "string",
        "search_social_context_snippet_type": 0,
        "should_show_category": true,
        "has_opt_eligible_shop": true,
        "show_text_post_app_badge": true,
        "show_ig_app_switcher_badge": true,
        "unseen_count": 0,
        "friendship_status": null
      },
      "clips_metadata": {
        "mashup_info": {
          "is_shared_to_fb": true
        }
      },
      "crosspost_metadata": {
        "is_feedback_aggregated": true
      },
      "original_width": 0,
      "original_height": 0,
      "has_audio": true,
      "video_duration": 0,
      "media_overlay_info": null,
      "boosted_status": "string",
      "boost_unavailable_identifier": "string",
      "boost_unavailable_reason": "string",
      "like_and_view_counts_disabled": true,
      "audience": "string",
      "clips_tab_pinned_user_ids": [
        "string"
      ],
      "has_views_fetching": true,
      "carousel_media": [
        null
      ],
      "preview": "string",
      "ad_id": "string",
      "caption_is_edited": true,
      "feed_demotion_control": null,
      "feed_recs_demotion_control": null,
      "inventory_source": "string",
      "is_dash_eligible": true,
      "number_of_qualities": 0,
      "video_dash_manifest": "string",
      "sharing_friction_info": null,
      "is_paid_partnership": true,
      "sponsor_tags": [
        null
      ],
      "affiliate_info": null,
      "organic_tracking_token": "string",
      "link": null,
      "story_cta": null,
      "group": null,
      "coauthor_producers": [
        null
      ],
      "invited_coauthor_producers": [
        null
      ],
      "follow_hashtag_info": null,
      "title": "string",
      "comments_disabled": true,
      "commenting_disabled_for_viewer": true,
      "has_liked": true,
      "top_likers": [
        "string"
      ],
      "facepile_top_likers": [
        null
      ],
      "can_see_insights_as_brand": true,
      "social_context": null,
      "can_reshare": true,
      "can_viewer_reshare": true,
      "ig_media_sharing_disabled": true,
      "photo_of_you": true,
      "usertags": null,
      "carousel_parent_id": "string",
      "carousel_media_count": 0,
      "location": null,
      "is_shared_from_basel": true,
      "clips_attribution_info": null,
      "media_attributions_data": null,
      "wearable_attribution_info": null,
      "accessibility_caption": "string",
      "display_uri": "string",
      "media_cropping_info": null,
      "profile_grid_thumbnail_fitting_style": "string",
      "thumbnails": null,
      "timeline_pinned_user_ids": [
        "string"
      ],
      "upcoming_event": null,
      "media_notes": null,
      "logging_info_token": "string",
      "explore": null,
      "main_feed_carousel_starting_media_id": "string",
      "is_seen": true,
      "floating_context_items": [
        null
      ],
      "open_carousel_submission_state": "string",
      "previous_submitter": null,
      "all_previous_submitters": [
        null
      ],
      "headline": null,
      "hidden_likes_string_variant": "string",
      "fb_like_count": 0,
      "enable_media_notes_production": true,
      "media_repost_count": 0,
      "saved_collection_ids": [
        "string"
      ],
      "has_viewer_saved": true,
      "__typename": "string",
      "__isXDTGraphMediaInterface": "string",
      "thumbnail_src": "string",
      "dimensions": {
        "height": 0,
        "width": 0
      },
      "gating_info": null,
      "fact_check_overall_rating": null,
      "fact_check_information": null,
      "sensitivity_friction_info": null,
      "media_preview": "string",
      "display_url": "string",
      "display_resources": [
        {
          "src": "string",
          "config_width": 0,
          "config_height": 0
        }
      ],
      "is_video": true,
      "tracking_token": "string",
      "edge_media_to_tagged_user": null,
      "edge_media_to_caption": null,
      "has_ranked_comments": true,
      "edge_media_to_parent_comment": null,
      "edge_media_to_hoisted_comment": null,
      "edge_media_preview_comment": null,
      "taken_at_timestamp": 0,
      "edge_media_preview_like": null,
      "edge_media_to_sponsor_user": null,
      "is_affiliate": true,
      "nft_asset_info": null,
      "viewer_has_liked": true,
      "viewer_has_saved": true,
      "viewer_has_saved_to_collection": true,
      "viewer_in_photo_of_you": true,
      "viewer_can_reshare": true,
      "is_ad": true,
      "edge_web_media_to_related_media": null,
      "pinned_for_users": [
        null
      ],
      "fbid": "string",
      "deleted_reason": 0,
      "client_cache_key": "string",
      "strong_id__": "string",
      "device_timestamp": 0,
      "filter_type": 0,
      "has_shared_to_fb": 0,
      "has_delayed_metadata": true,
      "mezql_token": "string",
      "should_request_ads": true,
      "has_privately_liked": true,
      "subtype_name_for_REST__": "string",
      "has_views_fetching_on_search_grid": true,
      "collaborator_edit_eligibility": null,
      "integrity_review_decision": "string",
      "is_reshare_of_text_post_app_media_in_ig": true,
      "is_visual_reply_commenter_notice_enabled": true,
      "share_count_disabled": true,
      "carousel_media_pending_post_count": 0,
      "can_modify_carousel": true,
      "carousel_media_ids": [
        "string"
      ],
      "music_metadata": null,
      "product_suggestions": [
        null
      ],
      "comment_inform_treatment": null,
      "igbio_product": null,
      "is_open_to_public_submission": true,
      "is_social_ufi_disabled": true,
      "open_carousel_show_follow_button": true,
      "fb_user_tags": null,
      "coauthor_producer_can_see_organic_insights": true,
      "is_in_profile_grid": true,
      "profile_grid_control_enabled": true,
      "boost_unavailable_reason_v2": null,
      "subscribe_cta_visible": true,
      "creative_config": null,
      "is_cutout_sticker_allowed": true,
      "cutout_sticker_info": null,
      "is_tagged_media_shared_to_viewer_profile_grid": true,
      "should_show_author_pog_for_tagged_media_shared_to_profile_grid": true,
      "meta_ai_suggested_prompts": [
        null
      ],
      "gen_ai_chat_with_ai_cta_info": null,
      "can_reply": true,
      "is_eligible_content_for_post_roll_ad": true,
      "is_photo_comments_composer_enabled_for_author": true,
      "can_view_more_preview_comments": true,
      "preview_comments": [
        null
      ],
      "hide_view_all_comment_entrypoint": true,
      "eligible_insights_entrypoints": [
        "string"
      ],
      "video_sticker_locales": [
        null
      ],
      "is_eligible_for_poe": true,
      "is_eligible_for_organic_eager_refresh": true,
      "shop_routing_user_id": "string",
      "featured_products": [
        null
      ],
      "gen_ai_detection_method": null,
      "community_notes_info": null,
      "has_high_risk_gen_ai_inform_treatment": true,
      "can_viewer_save": true,
      "is_comments_gif_composer_enabled": true,
      "is_organic_product_tagging_eligible": true,
      "is_post_live_clips_media": true,
      "media_reposter_bottomsheet_enabled": true,
      "original_media_has_visual_reply_media": true,
      "report_info": null
    }
  ],
  "itemCount": 0,
  "creditsCharged": 0
}
{
  "success": true,
  "requestId": "string",
  "status": "processing",
  "message": "string"
}
{
  "success": false,
  "error": "string",
  "requestId": "string"
}