Skip to main content

Instagram

Availability
Available CloudAvailable Self-Managed CommunityAvailable Self-Managed EnterpriseAvailable PyAirbyte
Support Level
Airbyte
Connector Version
4.2.0 (last updated a day ago)
Sync Success Rate
Usage Rate
Definition ID
6acf6b55-4f1e-4fca-944e-1a3caef8aba8

This page contains the setup guide and reference information for the Instagram source connector.

Prerequisites​

Setup guide​

Set up Instagram​

For Airbyte Cloud:​

  1. Log into your Airbyte Cloud account.
  2. Click Sources and then click + New source.
  3. On the Set up the source page, select Instagram from the Source type dropdown.
  4. Enter a name for the Instagram connector.
  5. Click Authenticate your Instagram account.
  6. Log in and authorize the Instagram account.
  7. (Optional) Enter the Start Date in YYYY-MM-DDTHH:mm:ssZ format. All data generated after this date will be replicated. If left blank, the start date will be set to 2 years before the present date.
  8. Click Set up source.

For Airbyte Open Source:​

  1. Navigate to the Airbyte Open Source dashboard.
  2. Click Sources and then click + New source.
  3. On the Set up the source page, select Instagram from the Source type dropdown.
  4. Enter a name for your source.
  5. Enter Access Token generated using Graph API Explorer or by using an app you can create on Facebook with the required permissions: instagram_basic, instagram_manage_insights, pages_show_list, pages_read_engagement.
  6. (Optional) Enter the Start Date in YYYY-MM-DDTHH:mm:ssZ format. All data generated after this date will be replicated. If left blank, the start date will be set to 2 years before the present date.
  7. Click Set up source.

Supported sync modes​

The Instagram source connector supports the following sync modes:

note

Incremental sync modes are only available for the User Insights stream.

Supported Streams​

The Instagram source connector supports the following streams. For more information, see the Instagram Graph API and Instagram Insights API documentation.

info

The Instagram connector syncs data related to Users, Media, and Stories and their insights from the Instagram Graph API. For performance data related to Instagram Ads, use the Facebook Marketing source.

Entity-Relationship Diagram (ERD)​

Data type map​

AirbyteRecords are required to conform to the Airbyte type system. This means that all sources must produce schemas and records within these types and all destinations must handle records that conform to this type system.

Integration TypeAirbyte Type
stringstring
numbernumber
arrayarray
objectobject

Limitations & Troubleshooting​

Expand to see details about Instagram connector limitations and troubleshooting.

Connector limitations​

Rate limiting​

Instagram limits the number of requests that can be made at a time. See Facebook's documentation on rate limiting for more information.

Troubleshooting​

  • Check out common troubleshooting issues for the Instagram source connector on our Airbyte Forum.

Reference​

Config fields reference

Field
Type
Property name
string
access_token
string
client_id
string
client_secret
integer
num_workers
string
start_date

Changelog​

Expand to review
VersionDatePull RequestSubject
4.2.02025-07-1763358Promoting release candidate 4.2.0-rc.1 to a main version.
4.2.0-rc.12025-07-1662954Migrate to manifest-only format.
4.1.02025-07-1463289Promoting release candidate 4.1.0-rc.3 to a main version.
4.1.0-rc.32025-07-1062902Revert add views metric to StoryInsights and MediaInsights streams.
4.1.0-rc.22025-07-0962844Migrate UserInsights stream to low-code
4.1.0-rc.12025-05-2760848Add views metric to StoryInsights and MediaInsights streams.
4.0.52025-05-1059798Update dependencies
4.0.42025-05-0359243Update dependencies
4.0.32025-04-2658773Update dependencies
4.0.22025-04-1958167Update dependencies
4.0.12025-04-1257704Update dependencies
4.0.02025-04-0755860Remove deprecated metrics from StoryInsights, UserInsights and MediaInsights streams.
3.2.52025-04-0557069Update dependencies
3.2.42025-03-2956666Update dependencies
3.2.32025-03-2256020Update dependencies
3.2.22025-03-1055685Disable cache for InstagramMediaChildrenTransformation
3.2.12025-03-0855463Update dependencies
3.2.02025-02-2854364Update to CDK v6
3.1.92025-03-0154789Update dependencies
3.1.82025-02-2254364Update dependencies
3.1.72025-02-1553846Update dependencies
3.1.62025-02-0853291Update dependencies
3.1.52025-02-0653171Fix missing OAuth fields
3.1.42025-02-0152260Update dependencies
3.1.32025-01-2052035Upgrade to API v21.0
3.1.22025-01-1144223Starting with this version, the Docker image is now rootless. Please note that this and future versions will not be compatible with Airbyte versions earlier than 0.64
3.1.12025-01-0951018Remove deprecated metrics from StoryInsights and MediaInsights streams.
3.1.02024-07-1341937New metrics added for StoryInsights and MediaInsights streams.
3.0.222024-07-2742721Update dependencies
3.0.212024-07-2042346Update dependencies
3.0.202024-07-1341784Update dependencies
3.0.192024-07-1041586Update dependencies
3.0.182024-07-0941109Update dependencies
3.0.172024-07-0841046Use latest CDK version possible
3.0.162024-07-0640903Update dependencies
3.0.152024-07-0240569Migrate MediaInsights and StoryInsights to low-code
3.0.142024-06-2640524Fix Api stream when the results contain not business accounts
3.0.132024-06-2540456Update dependencies
3.0.122024-06-2439504Migrate Media, Users, UserLifeTimeInsights and Stories to low-code
3.0.112024-06-2240127Update dependencies
3.0.102024-06-0639303[autopull] Upgrade base image to v1.2.2
3.0.92024-05-2138554Upgrade to API v19.0
3.0.82024-05-2038268Replace AirbyteLogger with logging.Logger
3.0.72024-04-1936643Updating to 0.80.0 CDK
3.0.62024-04-1236643Schema descriptions
3.0.52024-03-2036314Unpin CDK version
3.0.42024-03-0735875Remove total_interactions from the MediaInsights queries.
3.0.32024-02-1235177Manage dependencies with Poetry
3.0.22024-01-1534254Prepare for airbyte-lib
3.0.12024-01-0833989Remove metrics from video feed
3.0.02024-01-0533930Upgrade to API v18.0
2.0.12024-01-0333889Change requested metrics for stream media_insights
2.0.02023-11-1732500Add primary keys for UserLifetimeInsights and UserInsights; add airbyte_type to timestamp fields
1.0.162023-11-1732627Fix start_date type; fix docs
1.0.152023-11-1432494Marked start_date as optional; set max retry time to 10 minutes; add suggested streams
1.0.142023-11-1332423Capture media_product_type column in media and stories stream
1.0.132023-11-1032245Add skipping reading MediaInsights stream if an error code 10 is received
1.0.122023-11-0732200The backoff strategy has been updated to make some errors retriable
1.0.112023-08-0329031Reverted advancedAuth spec changes
1.0.102023-08-0128910Updated advancedAuth broken references
1.0.92023-07-0127908Fix bug when user_lifetime_insights stream returns Key Error (end_time), refactored state to use IncrementalMixin
1.0.82023-05-2626767Handle permission error for insights
1.0.72023-05-2626656Remove authSpecification from connector specification in favour of advancedAuth
1.0.62023-03-2826599Handle error for Media posted before business account conversion
1.0.52023-03-2824634Add user-friendly message for no instagram_business_accounts case
1.0.42023-03-1523671Add info about main permissions in spec and doc links in error message to navigate user
1.0.32023-03-1424043Do not emit incomplete records for user_insights stream
1.0.22023-03-1424042Test publish flow
1.0.12023-01-1921602Handle abnormally large state values
1.0.02022-09-2317110Remove custom read function and migrate to per-stream state
0.1.112022-09-0816428Fix requests metrics for Reels media product type
0.1.102022-09-0516340Update to latest version of the CDK (v0.1.81)
0.1.92021-09-306438Annotate Oauth2 flow initialization parameters in connector specification
0.1.82021-08-115354Added check for empty state and fixed tests
0.1.72021-07-194805Add support for previous STATE format
0.1.62021-07-074210Refactor connector to use CDK: - improve error handling - fix sync fail with HTTP status 400 - integrate SAT
Was this page helpful?