# ✅ Instagram User Reels Scraper (`datamagnet/instagram-reels-downloader`) Actor

Download reels from a single Instagram profile into a ready-to-use dataset. Collect Instagram reels exactly as returned by the source, optionally include trial reels, and keep loading more results automatically until your limit is reached or no more reels are available.

- **URL**: https://apify.com/datamagnet/instagram-reels-downloader.md
- **Developed by:** [Datamagnet](https://apify.com/datamagnet) (community)
- **Categories:** Social media, Videos
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Instagram Reels Scraper

Instagram Reels Scraper is a simple data collector for downloading reels from a single Instagram profile into a ready-to-use dataset. It helps marketers, researchers, creators, and social media teams collect Instagram reels data for review, archiving, and analysis without manual copying. Enter a username, user ID, or profile URL, choose whether to include trial reels, and get the reel records exactly as provided by the source. It is ideal when you need reliable Instagram reels extraction for content tracking, competitive research, or building your own media archive.

### Key Features

- **Collect** reels from one Instagram profile in a clean dataset you can use right away.
- **Include** trial reels when you want a more complete view of the account’s content.
- **Keep loading** more reels automatically until your chosen limit is reached or no more results are available.
- **Preserve** the reel data exactly as returned, so you can review the original fields without losing detail.
- **Capture** rich metadata such as captions, timestamps, play counts, likes, comments, shares, and media links.
- **Support** embed-safe media links when you need reel URLs that are easier to use on websites.
- **Export** the results for reporting, archiving, spreadsheet analysis, or content workflows.

### Use Cases

#### Content Research
Social media managers use this actor to study how a creator structures captions, posting cadence, and engagement patterns. Fields like `caption.text`, `taken_at_date`, `like_count`, `comment_count`, `share_count`, and `play_count` make it easy to compare which reels perform best over time.

#### Competitive Analysis
Brands and agencies can track a competitor’s reel strategy by collecting the full reel dataset from a profile. With fields such as `video_duration`, `thumbnail_url`, `has_audio`, `tagged_users`, and `clips_metadata`, teams can spot recurring formats, collaborations, and content styles that drive attention.

#### Creator Archiving
Creators and talent managers often want a backup of published reels for recordkeeping or repurposing. This actor returns the original reel details, including media links, captions, and publication timestamps, so teams can preserve a historical archive of content from a profile.

#### Influencer Vetting
Influencer marketing teams can review a creator’s reel history before outreach or partnership decisions. Data such as `user.username`, `user.is_verified`, `caption.mentions`, `tagged_users`, and engagement counts helps buyers understand audience fit, brand associations, and content quality.

#### Campaign Reporting
Agencies running social campaigns can collect reels from a profile and use the dataset to build performance reports. Metrics like `ig_play_count`, `like_count`, `comment_count`, `share_count`, and `taken_at_ts` help teams summarize reach and engagement in a format that is easy to share with clients.

#### Media Review and Compliance
Teams that need to review content for brand safety or internal compliance can inspect the exact reel records returned by the source. Fields such as `caption.text`, `integrity_review_decision`, `is_paid_partnership`, `sponsor_tags`, and `report_info` provide useful context for content review workflows.

### Input

| Field | Type | Required | Description | Example |
|---|---|---:|---|---|
| Instagram profile | string | Yes | Enter the Instagram username, user ID, or profile URL for the account whose reels you want. | mrbeast |
| Include trial reels | boolean | No | Turn this on if you also want trial reels included in the results. | false |
| Embed-safe links | boolean | No | Turn this on if you need reel media links that are safe to embed on a website. | false |
| Max results | integer | No | Set the maximum number of reels to collect. The actor will keep loading more reels until this limit is reached. | 100 |

### Output

| Field | Type | Description |
|---|---|---|
| are_remixes_crosspostable | boolean | Shows whether the reel can be remixed or shared in remix-style ways. |
| boost_unavailable_identifier | string or null | A label explaining why promotion or boosting may not be available, if provided. |
| boost_unavailable_reason | string or null | A plain-language reason why boosting is unavailable, if provided. |
| boost_unavailable_reason_v2 | string or null | A newer version of the boost restriction reason, if available. |
| can_reply | boolean | Tells you whether replies are allowed on the reel. |
| can_reshare | boolean | Tells you whether the reel can be reshared. |
| can_save | boolean | Tells you whether the reel can be saved. |
| caption | object | The reel caption details, including text, hashtags, mentions, author info, and timestamps. |
| caption_is_edited | boolean | Shows whether the caption was edited after posting. |
| clips_demotion_control | object | Information related to content preference controls and “not interested” options. |
| clips_metadata | object | Extra reel metadata such as audio details, reuse settings, and creator-related information. |
| clips_tab_pinned_user_ids | array | User IDs pinned to the reels tab, if any. |
| coauthor_producer_can_see_organic_insights | boolean | Shows whether coauthor producers can view organic insights. |
| coauthor_producers | array | Lists coauthor producers connected to the reel, if any. |
| code | string | The short reel code used to identify the post. |
| collaborator_edit_eligibility | boolean | Shows whether collaborators can edit the reel. |
| comment_count | integer | The number of comments on the reel. |
| comment_inform_treatment | object | Information about comment-related notices or treatments. |
| community_notes_info | object | Information about note submission and community note eligibility. |
| creative_config | object or null | Creative settings or configuration details, if available. |
| crosspost_metadata | object | Information about cross-posting and downstream sharing. |
| cutout_sticker_info | array | Sticker-related cutout information, if present. |
| deleted_reason | integer | A code showing whether the reel was deleted and why. |
| device_timestamp | integer | A device-based timestamp associated with the reel record. |
| disable_caption_and_comment | boolean | Shows whether captions and comments are disabled. |
| eligible_insights_entrypoints | string | Indicates whether insights are available for this reel. |
| fb_like_count | integer | The number of likes recorded on the connected Facebook version, if available. |
| fb_play_count | integer | The number of plays recorded on the connected Facebook version, if available. |
| fb_user_tags | object | Facebook-side user tags associated with the reel, if any. |
| fbid | string | The Facebook identifier linked to the reel, if available. |
| featured_products | array | Products featured in the reel, if any. |
| filter_type | integer | A code describing the reel’s filter type. |
| floating_context_items | array | Extra contextual items attached to the reel, if any. |
| fundraiser_tag | object | Fundraiser-related information attached to the reel, if present. |
| gen_ai_chat_with_ai_cta_info | object or null | Information about AI chat prompts or calls to action, if available. |
| gen_ai_detection_method | object | Information about how AI-generated content detection was handled. |
| has_audio | boolean | Shows whether the reel includes audio. |
| has_high_risk_gen_ai_inform_treatment | boolean | Shows whether the reel has a high-risk AI-related notice. |
| has_liked | boolean | Shows whether the viewer has liked the reel. |
| has_privately_liked | boolean | Shows whether the viewer has privately liked the reel. |
| has_shared_to_fb | integer | Indicates whether the reel was shared to Facebook. |
| has_tagged_users | boolean | Shows whether the reel includes tagged users. |
| has_views_fetching | boolean | Shows whether view counts are available or being tracked. |
| hidden_likes_string_variant | integer | A display variant for hidden likes, if used. |
| id | string | The unique reel ID. |
| ig_media_sharing_disabled | boolean | Shows whether sharing is disabled for the reel. |
| ig_play_count | integer | The number of plays on Instagram. |
| igbio_product | object or null | Product information linked from the bio, if available. |
| image_versions | object | Thumbnail and preview image versions for the reel. |
| integrity_review_decision | string | The current integrity review status, if provided. |
| invited_coauthor_producers | array | Invited coauthor producers, if any. |
| is_affiliate_commission_eligible | boolean | Shows whether the reel is eligible for affiliate commission features. |
| is_comments_gif_composer_enabled | boolean | Shows whether GIF comments are enabled. |
| is_cutout_sticker_allowed | boolean | Shows whether cutout stickers are allowed. |
| is_dash_eligible | integer | A code showing whether the reel is eligible for DASH playback. |
| is_educational | boolean or null | Indicates whether the reel is marked as educational, if available. |
| is_eligible_content_for_post_roll_ad | boolean | Shows whether the reel can be used for post-roll ads. |
| is_eligible_for_autodub | boolean | Shows whether the reel is eligible for automatic dubbing. |
| is_eligible_for_autodub_upsell | boolean | Shows whether the reel can be promoted for automatic dubbing. |
| is_eligible_for_organic_eager_refresh | boolean | Shows whether the reel is eligible for organic refresh features. |
| is_eligible_for_poe | boolean | Shows whether the reel is eligible for a particular product experience. |
| is_eligible_for_poe_premium | boolean | Shows whether the reel is eligible for the premium version of that experience. |
| is_eligible_for_rta | boolean | Shows whether the reel is eligible for real-time ads or related features. |
| is_in_profile_grid | boolean | Shows whether the reel appears in the profile grid. |
| is_meta_ai_invocation_blocked_by_author | boolean | Shows whether the author blocked AI-related use. |
| is_open_to_public_submission | boolean | Shows whether the reel accepts public submissions. |
| is_organic_product_tagging_eligible | boolean | Shows whether product tagging is allowed organically. |
| is_paid_partnership | boolean | Shows whether the reel is marked as a paid partnership. |
| is_photo_comments_composer_enabled_for_author | boolean | Shows whether the author can use photo comments. |
| is_pinned | boolean | Shows whether the reel is pinned. |
| is_post_live_clips_media | boolean | Shows whether the reel is tied to live clips media. |
| is_quiet_post | boolean | Shows whether the reel is marked as a quiet post. |
| is_reshare_of_text_post_app_media_in_ig | boolean | Shows whether the reel is a reshare of text-post app media. |
| is_reuse_allowed | boolean | Shows whether reuse is allowed. |
| is_short_drama | boolean | Shows whether the reel is marked as short drama content. |
| is_social_ufi_disabled | boolean | Shows whether social feedback features are disabled. |
| is_tagged_media_shared_to_viewer_profile_grid | boolean | Shows whether tagged media is shared to the viewer’s profile grid. |
| is_third_party_downloads_eligible | boolean | Shows whether third-party downloads are allowed. |
| is_video | boolean | Shows whether the reel is a video. |
| like_and_view_counts_disabled | boolean | Shows whether likes and views are hidden or disabled. |
| like_count | integer | The number of likes on the reel. |
| location | object or null | Location information attached to the reel, if any. |
| locations | array | A list of locations attached to the reel, if any. |
| media_attributions_data | array | Attribution details for media used in the reel. |
| media_cropping_info | object | Cropping details for how the reel is displayed. |
| media_format | string | The media format, such as video. |
| media_name | string | The media type name, such as reel. |
| media_notes | object | Notes attached to the media, if any. |
| media_overlay_info | object or null | Overlay information for the reel, if available. |
| media_reposter_bottomsheet_enabled | boolean | Shows whether reposting options are enabled. |
| media_type | integer | A numeric code for the media type. |
| media_ui_attributions_data | array | UI attribution details, if any. |
| media_ui_attributions_data_v2 | array | Updated UI attribution details, if any. |
| meta_ai_suggested_prompts | array | Suggested AI prompts related to the reel, if any. |
| music_metadata | object or null | Music-related metadata, if available. |
| number_of_qualities | integer | The number of available video quality options. |
| original_height | integer | The original video height in pixels. |
| original_lang_for_translations | string | The original language used for translations. |
| original_width | integer | The original video width in pixels. |
| play_count | integer | The total number of plays recorded for the reel. |
| product_type | string | The product category for the post, such as clips. |
| related_ads_pivots_media_info | string | Information about related ad pivots, if provided. |
| related_ads_pivots_response | object | Response details for related ad pivots, if available. |
| report_info | object | Information about reports submitted by viewers. |
| share_count | integer | The number of times the reel has been shared. |
| share_count_disabled | boolean | Shows whether share counts are hidden. |
| sharing_friction_info | object | Information about sharing restrictions or friction. |
| shop_routing_user_id | string or null | Shopping-related user routing information, if available. |
| should_show_author_pog_for_tagged_media_shared_to_profile_grid | boolean | Shows whether the author profile picture should appear for tagged media on the profile grid. |
| social_context | array | Social context items related to the reel. |
| sponsor_tags | array | Sponsor or brand tags attached to the reel. |
| subscribe_cta_visible | boolean | Shows whether a subscribe button is visible. |
| subtype_name_for_REST__ | string | The internal subtype name for the reel record. |
| tagged_users | array | A list of users tagged in the reel. |
| taken_at | integer | The time the reel was posted, as a timestamp. |
| taken_at_date | string | The posting date in a readable format. |
| taken_at_ts | integer | Another timestamp value for when the reel was posted. |
| teen_project_info | object or null | Teen-related project information, if available. |
| thumbnail_url | string | The main thumbnail image for the reel. |
| timeline_pinned_user_ids | array | User IDs pinned on the timeline, if any. |
| top_likers | array | A list of top likers, if available. |
| translated_langs_for_autodub | array | Languages available for automatic dubbing, if any. |
| tya_media_related_topics | array | Related topics attached to the reel, if any. |
| user | object | The profile owner’s account details, including username, verification, and profile info. |
| video_codec | string | The video codec used for the reel. |
| video_duration | number | The length of the reel in seconds. |
| video_sticker_locales | array | Locales used for video stickers, if any. |
| video_subtitles_locale | string | The subtitle language, if available. |
| video_subtitles_uri | string | A link to the subtitle file, if available. |
| video_url | string | A direct link to the reel video. |
| video_versions | array | Available video file versions and quality options. |
| view_state_item_type | integer | A numeric code describing how the item is displayed. |

### Sample Output

```json
{
  "are_remixes_crosspostable": true,
  "boost_unavailable_identifier": null,
  "boost_unavailable_reason": null,
  "boost_unavailable_reason_v2": null,
  "can_reply": false,
  "can_reshare": true,
  "can_save": true,
  "caption": {
    "created_at": 1746633751,
    "created_at_utc": 1746633751,
    "did_report_as_spam": false,
    "hashtags": [],
    "id": "3627347799613702778",
    "is_covered": false,
    "is_ranked_comment": false,
    "mentions": ["@jacklinksjerky"],
    "private_reply_status": 0,
    "share_enabled": false,
    "text": "It’s my Birthday so I’m giving away $500,000 to my followers! Like and Comment on this post tagging 2 friends to enter! 10 people that do will win $50,000 each! Make sure you’re FOLLOWING so I can dm you if you win the money and share this to your story! Winners will be contacted in 14 days!...",
    "text_translation": "It’s my Birthday so I’m giving away $500,000 to my followers! Like and Comment on this post tagging 2 friends to enter! 10 people that do will win $50,000 each! Make sure you’re FOLLOWING so I can dm you if you win the money and share this to your story! Winners will be contacted in 14 days!...",
    "type": 1,
    "user": {
      "fbid_v2": "17841402202464771",
      "full_name": "MrBeast",
      "id": "2278169415",
      "is_private": false,
      "is_unpublished": false,
      "is_verified": true,
      "profile_pic_id": "1765328607101572916",
      "profile_pic_url": "https://scontent-lhr11-1.cdninstagram.com/v/t51.2885-19/31077884_211593632905749_1394765701385814016_n.jpg?...",
      "username": "mrbeast"
    },
    "user_id": "2278169415"
  },
  "caption_is_edited": false,
  "clips_demotion_control": {
    "confirmation_body": "We'll suggest fewer posts like this.",
    "confirmation_icon": "none",
    "confirmation_style": "bottomsheet",
    "confirmation_title": "Post hidden",
    "confirmation_title_style": "large_left",
    "enable_word_wrapping": true,
    "followup_options": [
      {
        "data": "author_id:2278169415",
        "demotion_control": {
          "confirmation_body": "We won't suggest posts from mrbeast.",
          "confirmation_icon": "eye-off-pano",
          "confirmation_style": "bottomsheet",
          "confirmation_title": "",
          "undo_style": "inline"
        },
        "id": "dislike",
        "show_icon": true,
        "style": null,
        "subtitle": null,
        "text": "Don't suggest posts from mrbeast"
      }
    ],
    "title": "Not interested",
    "title_style": "normal",
    "undo_style": "top_right"
  },
  "clips_metadata": {
    "audio_type": "original_sounds",
    "original_sound_info": {
      "audio_id": 1204140734428816,
      "duration_in_ms": 17000,
      "original_audio_title": "Original audio",
      "progressive_download_url": "https://scontent-lhr8-2.cdninstagram.com/o1/v/t2/f2/m86/AQPt8Rsa4iqmtTUFJR3TRyB037zhyRgcrzpv0TR2AK_tHO2pXDZd_CnrtNIndlSfFHOcp5vRADYX3Mzz5xm15yr1.mp4?..."
    }
  },
  "code": "DJW7ZrwxQJ6",
  "comment_count": 7599260,
  "deleted_reason": 0,
  "fb_like_count": 82,
  "fb_play_count": 965,
  "fbid": "18273313165284551",
  "has_audio": true,
  "has_tagged_users": true,
  "id": "3627347799613702778",
  "ig_play_count": 448348091,
  "image_versions": {
    "items": [
      {
        "height": 640,
        "is_spatial_image": false,
        "url": "https://scontent-lhr6-1.cdninstagram.com/v/t51.75761-15/495950972_18472568746073416_3105750293122405818_n.jpg?...",
        "width": 360
      }
    ]
  },
  "integrity_review_decision": "pending",
  "is_paid_partnership": false,
  "is_third_party_downloads_eligible": true,
  "is_video": true,
  "like_count": 8847458,
  "media_format": "video",
  "media_name": "reel",
  "play_count": 448349056,
  "product_type": "clips",
  "share_count": 1177497,
  "tagged_users": [
    {
      "position": [0, 0],
      "user": {
        "full_name": "Jack Link's",
        "id": "364861460",
        "is_verified": true,
        "username": "jacklinksjerky"
      }
    }
  ],
  "taken_at_date": "2025-05-07T16:02:28+00:00",
  "thumbnail_url": "https://scontent-lhr6-1.cdninstagram.com/v/t51.75761-15/495950972_18472568746073416_3105750293122405818_n.jpg?...",
  "user": {
    "full_name": "MrBeast",
    "id": "2278169415",
    "is_verified": true,
    "username": "mrbeast"
  },
  "video_duration": 17.01799964904785,
  "video_url": "https://scontent-lhr11-1.cdninstagram.com/o1/v/t2/f2/m367/AQOEmEes7dnflSXIkcnlFc_BS7lW8UNb9ZLiymEeokytM02Rn6lf7-6PmKzgnVDMPdJFVtw88gA5KI2wBPABDSHOjrxX98N8VEglVMk.mp4?...",
  "video_versions": [
    {
      "bandwidth": 1840137,
      "height": 1280,
      "id": "1386719463023965v",
      "type": 101,
      "url": "https://scontent-lhr11-1.cdninstagram.com/o1/v/t2/f2/m367/AQOEmEes7dnflSXIkcnlFc_BS7lW8UNb9ZLiymEeokytM02Rn6lf7-6PmKzgnVDMPdJFVtw88gA5KI2wBPABDSHOjrxX98N8VEglVMk.mp4?...",
      "width": 720
    }
  ],
  "view_state_item_type": 128
}
````

### How It Works

1. You enter the Instagram profile you want to collect reels from.
2. You choose whether to include trial reels and whether you want embed-safe links.
3. You set the maximum number of reels you want in the dataset.
4. The actor automatically gathers reel records from that profile and keeps going until it reaches your limit or runs out of reels.
5. Your results are delivered as a structured dataset you can review, archive, or analyze.

### Getting Started

Getting started is easy and does not require coding. Just click **Try for free**, fill in the Instagram profile you want to collect from, choose any optional settings, and click **Run**. The actor will do the rest and return your results in a format that is easy to work with. You can export the dataset as **JSON, CSV, or Excel** depending on how you want to review or share the reels.

### Frequently Asked Questions

#### Do I need technical skills?

No. This actor is designed for business users, marketers, researchers, and creators who want Instagram reels data without manual work. You only need to enter a profile and choose a few simple options.

#### How fast does it run?

Speed depends on how many reels you request and how much content is available on the profile. Smaller requests finish quickly, while larger collections may take longer because the actor keeps loading more reels until it reaches your limit.

#### What format is the output?

The results are available as a dataset you can export in common formats such as JSON, CSV, or Excel. That makes it easy to open the data in spreadsheets, share it with teammates, or import it into your own workflow.

#### Is this legal to use?

You should always use the data responsibly and in line with applicable laws, platform rules, and your own internal policies. This actor is intended for legitimate research, archiving, analysis, and business workflows, but you are responsible for how you use the results.

#### Can I schedule it to run automatically?

Yes, you can set it up to run on a schedule if you want regular updates from the same profile. That is useful for ongoing monitoring, recurring reports, or keeping an archive current over time.

# Actor input Schema

## `username_or_id_or_url` (type: `string`):

Enter an Instagram username, user ID, or profile URL to download reels from.

## `include_trial_reels` (type: `boolean`):

Turn this on to include trial reels in the results.

## `max_results` (type: `integer`):

Maximum number of reels to download.

## Actor input object example

```json
{
  "username_or_id_or_url": "mrbeast",
  "max_results": 10
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "username_or_id_or_url": "mrbeast"
};

// Run the Actor and wait for it to finish
const run = await client.actor("datamagnet/instagram-reels-downloader").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "username_or_id_or_url": "mrbeast" }

# Run the Actor and wait for it to finish
run = client.actor("datamagnet/instagram-reels-downloader").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "username_or_id_or_url": "mrbeast"
}' |
apify call datamagnet/instagram-reels-downloader --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=datamagnet/instagram-reels-downloader",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "✅ Instagram User Reels Scraper",
        "description": "Download reels from a single Instagram profile into a ready-to-use dataset. Collect Instagram reels exactly as returned by the source, optionally include trial reels, and keep loading more results automatically until your limit is reached or no more reels are available.",
        "version": "0.0",
        "x-build-id": "Iky3whBMuB0wbznKO"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/datamagnet~instagram-reels-downloader/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-datamagnet-instagram-reels-downloader",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/datamagnet~instagram-reels-downloader/runs": {
            "post": {
                "operationId": "runs-sync-datamagnet-instagram-reels-downloader",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/datamagnet~instagram-reels-downloader/run-sync": {
            "post": {
                "operationId": "run-sync-datamagnet-instagram-reels-downloader",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "username_or_id_or_url"
                ],
                "properties": {
                    "username_or_id_or_url": {
                        "title": "Instagram profile",
                        "type": "string",
                        "description": "Enter an Instagram username, user ID, or profile URL to download reels from."
                    },
                    "include_trial_reels": {
                        "title": "Include trial reels",
                        "type": "boolean",
                        "description": "Turn this on to include trial reels in the results."
                    },
                    "max_results": {
                        "title": "Max results",
                        "type": "integer",
                        "description": "Maximum number of reels to download."
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
