Contents x
    Instagram Story
    • 4 Minutes to read
    • Dark
      Light
    Contents

    Instagram Story

    • 4 Minutes to read
    • Dark
      Light
    Article summary

    Instagram Stories is a feature on that allow users and businesses to create and share short-form videos, photos, and text that disappear after 24 hours. It offers a fun and interactive way for users and businesses to share their daily activities, showcase their products or services, and engage with their followers on the platform.

    Refer to Meta's official documentation to see all available endpoints from the Instagram Story API.

    If you have multiple Instagram accounts and would like to extract the same data from all of them, it's possible through multi-account extraction. Contact our Solutions team to enable this feature.

    Authorize Connection to Instagram Story

    To authorize this service, use OAuth 2.0 to share specific data with Dataddo while keeping usernames, passwords, and other information private.

    1. On the Authorizers page, click on Authorize New Service and select your service.
    2. Follow the on-screen prompts to grant Dataddo the necessary permissions to access and retrieve your data.
    3. [Optional] Once your authorizer is created, click on it to change the label for easier identification.

    Ensure that the account you're granting access to holds at least admin-level permissions. If necessary, assign a team member with the required permissions with the authorizer role to authenticate the service for you.

    Instagram APIs allows data extraction only if your Instagram account is connected to a Facebook account. This will also make it easier for you to use all of the features available for businesses across the Facebook family of apps.

    For more information, see our article on authorizers.

    How to Create an Instagram Story Data Source

    1. On the Sources page, click on the Create Source button and select the connector from the list.
    2. From the drop-down menu, choose your authorizer.
      Didn't find your authorizer?

      Click on Add new Account at the bottom of the drop-down and follow the on-screen prompts. You can also go to the Authorizers tab and click on Add New Service.

    3. Name your data source and select your metrics and attributes.
    4. [Optional] Configure your advanced settings. If you are unsure about how to proceed, we recommend skipping this step.
    5. Configure your sync frequency or set the exact synchronization time under Show advanced settings.
      DATADDO TIP

      If you need to load historical data, refer to the Data Backfilling article.

    6. Preview your data by clicking on the Test Data button in the top right corner. You can adjust the date range for a more specific time frame.
    7. Click on Save and congratulations, your new data source is ready!

    Limitations

    Facebook Account Required

    In order to extract data from the Instagram API, it is required to have your Instagram account connected to a Facebook account. For more information, please visit the official Instagram API documentation.

    Data Only While Story Is Active

    The Instagram Story API allows access to data only while a story is active (24-hour window). As a result, a data source can be created only while a story is active.

    To prevent the data source from breaking, we recommend

    • Setting the syncing frequency to hourly
    • Enabling Allow empty to allow data extraction even without any data availab;e.
      • Click on your source and scroll down the Basic Info tab.
      • Check the Allow Empty box.
        Instagram Story - allow empty
    • Adding timestamps to your data so that the story will have multiple entries, each with different numbers.

    Troubleshooting

    Data Preview Unavailable

    No data preview when you click on Test Data might be caused by an issue with your source configuration. The most common causes are:

    • Date range: Try a smaller date range. You can load the rest of your data afterward using manual data load.
    • Insufficient permissions: Please make sure your authorized account has at least admin-level permissions.
    • Invalid metrics, attributes, or breakdowns: You may not have any data for the selected metrics, attributes, or breakdowns.
    • Incompatible combination of metrics, attributes, or breakdowns: Your selected combination cannot be queried together. Please refer to the service's documentation to view a full list of metrics that can be included in the same data source.

    Related Articles

    Now that you have successfully created a data source, see how you can connect your data to a dashboarding app or a data storage.

    Sending Data to Dashboarding Apps

    Sending Data to Data Storages

    Other Resources

    Was this article helpful?
    What's Next