{"id":43151025,"url":"https://github.com/voxmedia/tap-instagram","last_synced_at":"2026-02-01T00:17:23.273Z","repository":{"id":43147430,"uuid":"455665327","full_name":"voxmedia/tap-instagram","owner":"voxmedia","description":"Singer Tap for the Instagram Graph API","archived":false,"fork":false,"pushed_at":"2024-03-07T22:37:06.000Z","size":81,"stargazers_count":4,"open_issues_count":4,"forks_count":4,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-04-14T05:12:06.066Z","etag":null,"topics":["elt","instagram","meltano","singer","singer-tap"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/voxmedia.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2022-02-04T19:05:54.000Z","updated_at":"2024-01-14T12:46:50.000Z","dependencies_parsed_at":"2024-01-03T21:47:41.940Z","dependency_job_id":null,"html_url":"https://github.com/voxmedia/tap-instagram","commit_stats":null,"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"purl":"pkg:github/voxmedia/tap-instagram","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voxmedia%2Ftap-instagram","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voxmedia%2Ftap-instagram/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voxmedia%2Ftap-instagram/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voxmedia%2Ftap-instagram/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/voxmedia","download_url":"https://codeload.github.com/voxmedia/tap-instagram/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voxmedia%2Ftap-instagram/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28961606,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-31T23:03:11.038Z","status":"ssl_error","status_checked_at":"2026-01-31T22:56:44.691Z","response_time":128,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["elt","instagram","meltano","singer","singer-tap"],"created_at":"2026-02-01T00:17:22.782Z","updated_at":"2026-02-01T00:17:23.266Z","avatar_url":"https://github.com/voxmedia.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Singer Tap for Instagram\n\n[![test](https://github.com/prratek/tap-instagram/actions/workflows/ci_workflow.yml/badge.svg)](https://github.com/prratek/tap-instagram/actions/workflows/ci_workflow.yml)\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n[![PyPI Version](https://img.shields.io/pypi/v/tap-instagram?style=flat)](https://pypi.org/project/tap-instagram/)\n[![License](https://img.shields.io/pypi/l/tap-instagram)](LICENSE.md)\n[![Python](https://img.shields.io/pypi/pyversions/tap-instagram)](https://pypi.org/project/tap-instagram/)\n\n`tap-instagram` is a Singer tap for the [Instagram Graph API](https://developers.facebook.com/docs/instagram-api) built \nwith the [Meltano Tap SDK](https://sdk.meltano.com) for Singer Taps.\n\n## Installation\n\n- [ ] `Developer TODO:` Update the below as needed to correctly describe the install procedure. For instance, if you do not have a PyPi repo, or if you want users to directly install from your git repo, you can modify this step as appropriate.\n\n```bash\npipx install tap-instagram\n```\n\n## Supported Streams\n\nThe Instagram tap replicates the following data:\n* [Users](https://developers.facebook.com/docs/instagram-api/reference/ig-user)\n* [Media](https://developers.facebook.com/docs/instagram-api/reference/ig-user/media)\n* [Stories](https://developers.facebook.com/docs/instagram-api/reference/ig-user/stories)\n* [User Insights](https://developers.facebook.com/docs/instagram-api/reference/ig-user/insights)\n* [Media Insights](https://developers.facebook.com/docs/instagram-api/reference/ig-media/insights)\n* [Story Insights](https://developers.facebook.com/docs/instagram-api/reference/ig-media/insights)\n\nThose sources are spread across a few additional streams since they support varying query parameters, time periods, \namounts of historical data, etc. The following section outlines some important information, but defer to the API docs \nlinked above for more detail.\n\n* **Users:** IG User objects representing the Instagram Business or Creator Accounts from the `ig_user_ids` config \nparameter.\n  * **Replication Method:** Full Table\n* **Media:** IG Media objects representing media published by a given IG User.\n  * **Replication Method:** Full Table\n  * **Parent Stream:** Users\n  * **Limitations:** Return a max of 10k of the most recently created media objects for that user. Does not include\n  stories, which are in the \"stories\" stream.\n* **Stories:** IG Media objects representing stories published by a given IG User in the last 24 hours.\n  * **Replication Method:** Full Table\n  * **Parent Stream:** Users\n  * **Limitations:** Stories are only available for 24hrs, do not include Live Video stories or reshared stories.\n* **Media Children:** IG Media objects corresponding to images or videos in an album.\n  * **Replication Method:** Full Table\n  * **Parent Stream:** Media\n* **User Insights 28 Day:** User Insights stream containing impressions and reach for a 28 day period.\n  * **Replication Method:** Full Table\n  * **Parent Stream:** Users\n* **User Insights Audience:** User Insights stream containing audience metrics audience_city, audience_country, \naudience_gender_age, audience_locale for a lifetime period.\n  * **Replication Method:** Full Table\n  * **Parent Stream:** Users\n* **User Insights Daily:** User Insights stream containing all daily metrics except follower_count, which has less \nhistorical data - email_contacts, get_directions_clicks, impressions, phone_call_clicks, profile_views, reach, \ntext_message_clicks, website_clicks.\n  * **Replication Method:** Full Table\n  * **Parent Stream:** Users\n* **User Insights Followers:** User Insights stream containing follower_count on a daily time period.\n  * **Replication Method:** Full Table\n  * **Parent Stream:** Users\n  * **Limitations:** Only returns data for the last 30 days.\n* **User Insights Online Followers:** User Insights stream containing online_followers on a lifetime time period.\n  * **Replication Method:** Full Table\n  * **Parent Stream:** Users\n  * **Limitations:** Only returns data for the last 30 days.\n* **User Insights Weekly:** User Insights stream containing impressions and reach for a weekly period.\n  * **Replication Method:** Full Table\n  * **Parent Stream:** Users\n* **Media Insights:** Media Insights stream returning the supported metrics for photo, video, and album Media objects.\n  * **Replication Method:** Full Table\n  * **Parent Stream:** Media\n  * **Limitation:** Does not return insights for media published before account was changed from personal to business.\n* **Story Insights:** Media Insights stream returning the supported metrics for story Media objects.\n  * **Replication Method:** Full Table\n  * **Parent Stream:** Stories\n  * **Limitation:** Does not return insights for stories published before account was changed from personal to business.\n\n## Configuration\n\n**The tap accepts the following config options:**\n\n- **`ig_user_ids: List[str]` (required)**: List of user IDs of Instagram Business Accounts or Instagram Creator Accounts. One way to \nfind the user ID is by navigating to\n\u003e [Facebook Business Manager Settings](https://business.facebook.com/settings) \u003e Accounts \u003e Instagram accounts \u003e [Your Account]\n\nand you will see the user ID in the URL - https://business.facebook.com/instagram-account-v2s/{user_id}?business_id={business_id}\n\n- **`access_token: str` (required)**: A long-lived **user access token**, which can be obtained by following \n[these instructions](https://developers.facebook.com/docs/pages/access-tokens). Ensure the access token has the \nfollowing permissions:\n  - `instagram_basic`\n  - `instagram_manage_insights`\n  - `pages_show_list`\n  - `pages_read_engagement`\n\n  **NOTE: You will need to create a Facebook App if you do not have one already to be able to generate an access token**\n\nA full list of supported settings and capabilities for this\ntap is available by running:\n\n```bash\ntap-instagram --about\n```\n\n\n## Usage\n\nYou can easily run `tap-instagram` by itself or in a pipeline using [Meltano](https://meltano.com/).\n\n### Executing the Tap Directly\n\n```bash\ntap-instagram --version\ntap-instagram --help\ntap-instagram --config CONFIG --discover \u003e ./catalog.json\n```\n\n## Developer Resources\n\n- [ ] `Developer TODO:` As a first step, scan the entire project for the text \"`TODO:`\" and complete any recommended steps, deleting the \"TODO\" references once completed.\n\n### Initialize your Development Environment\n\n```bash\npipx install poetry\npoetry install\n```\n\n### Create and Run Tests\n\nCreate tests within the `tap_instagram/tests` subfolder and\n  then run:\n\n```bash\npoetry run pytest\n```\n\nYou can also test the `tap-instagram` CLI interface directly using `poetry run`:\n\n```bash\npoetry run tap-instagram --help\n```\n\n### Testing with [Meltano](https://www.meltano.com)\n\n_**Note:** This tap will work in any Singer environment and does not require Meltano.\nExamples here are for convenience and to streamline end-to-end orchestration scenarios._\n\nYour project comes with a custom `meltano.yml` project file already created. Open the `meltano.yml` and follow any _\"TODO\"_ items listed in\nthe file.\n\nNext, install Meltano (if you haven't already) and any needed plugins:\n\n```bash\n# Install meltano\npipx install meltano\n# Initialize meltano within this directory\ncd tap-instagram\nmeltano install\n```\n\nNow you can test and orchestrate using Meltano:\n\n```bash\n# Test invocation:\nmeltano invoke tap-instagram --version\n# OR run a test `elt` pipeline:\nmeltano elt tap-instagram target-jsonl\n```\n\n### SDK Dev Guide\n\nSee the [dev guide](https://sdk.meltano.com/en/latest/dev_guide.html) for more instructions on how to use the SDK to \ndevelop your own taps and targets.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvoxmedia%2Ftap-instagram","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvoxmedia%2Ftap-instagram","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvoxmedia%2Ftap-instagram/lists"}