Instagram Story
  • 2 Minutes to read
  • Dark

Instagram Story

  • Dark


Available Endpoints

All available endpoints from the Instagram Story API are listed here.


  • Due to the API limitations, Dataddo can only access data while the story is active (24-hour window). You can create a source only when you have some story running, otherwise, there is no data to access.

  • We recommend setting up the source to hourly syncing frequency in order to prevent the source from breaking.

  • Allow empty - Option to push the data only even if the data is not there, when the story is posted or when there is no story, the source will not get broken because even "empty" ¬Ědata will be pushed - this feature can be enabled by contacting our support team.

    • Go to Sources, and click on the** three dots** next to the source. Click on Edit under Basic Info check the Allow Empty box.
      Instagram Story - allow empty
  • Timestamp - the data will show the same story with different times and increased numbers.

  • Reels are not supported from the Instagram API and therefore, Dataddo cannot extract them.

How to Create an Instagram Story Data Source

  1. Sign in to your Dataddo account and click on Sources at the top of the page.

  2. Click on Create Source in the top right corner.

  3. From the list of sources, choose Instagram Story. You can type the name of the connector into the search bar to find it faster.
    Data sources - choose connectors

  4. From the drop-down menu, choose your Account connected to Dataddo, and then select your Instagram Account. Click on Next to continue with the setup.
    Instagram Story - account

    1. Didn't find your account?
      If you want to connect a new account that is not on the list, click on Add new Account at the bottom of the drop-down. You will be redirected to the authorization/sign-in page to confirm the right account. Once you confirm, you will be redirected back to the Dataddo app.
      Instagram Business - step 4a

    2. Authorize Your Account
      If you have not authorized your Account with Dataddo, click on Add new Account and you will be redirected to the authorization/sign-in page.

    3. After you log in and give Dataddo the necessary permissions to access your data, you will be redirected back to the connector.

  5. Choose a name for your Data Source, select the Attributes, and the Maximum number of posts. To continue to the next page, click Next
    Instagram Story - metrics

  6. Configure your snapshotting preferences by choosing your Sync frequency. Under Advanced settings you can selec the exactTime, of synchronization. Confirm your setup by clicking on Next.
    If the Data range is available to select, you can load historical data. Read more in our guide.

  7. Before saving the source, you can see a preview of your data by clicking on the Preview button. you can adjust the date range to a more specific view.
    Also, you can see the full list of the metrics you selected by clicking on Show all Metrics and attributes, in the left navigation.
    Data source - create - preview

  8. Click on Save and your new Data Source is ready.

Congratulations, your new Data Source is ready!


Broken View / Error Message

If you cannot see a preview of your data, go back a few steps and check your setup. The most common causes are:

  • Date range - we recommend a smaller date range. If you need to load historical data, check our guide.
  • Invalid metrics, attributes or breakdowns, or their combination - you may not have any values for them.
    Data source -create- error

Need assistance?

Feel free to contact us and we will help you with the setup. To speed the process of resolving your issue, make sure you provide us with sufficient information.

Was this article helpful?

What's Next