instagram-edits-sdk 0.2.1__tar.gz

instagram_edits_sdk-0.2.1/.github/workflows/publish.yml

@@ -0,0 +1,59 @@
+name: Publish to PyPI
+on:
+  push:
+    tags:
+      - 'v*'
+permissions:
+  contents: read
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: '3.14'
+      - name: Check version matches the release tag
+        env:
+          RELEASE_TAG: ${{ github.ref_name }}
+        run: |
+          python - <<'PY'
+          import os, tomllib
+          project = tomllib.load(open('pyproject.toml', 'rb'))['project']
+          assert project['name'] == 'instagram-edits-sdk'
+          assert os.environ['RELEASE_TAG'] == 'v' + project['version']
+          PY
+      - run: python -m pip install . build twine
+      - run: python -m unittest discover -s tests -v
+      - run: python examples/offline_demo.py
+      - run: python tools/generate_docs.py --check
+      - run: python tools/generate_openapi.py --check
+      - run: python tools/check_release.py
+      - run: python -m build
+      - run: python -m twine check --strict dist/*
+      - name: Test the actual wheel without runtime dependencies
+        run: |
+          python -m venv /tmp/edits-wheel-check
+          /tmp/edits-wheel-check/bin/python -m pip install --no-deps dist/*.whl
+          /tmp/edits-wheel-check/bin/python -m unittest discover -s tests -v
+          /tmp/edits-wheel-check/bin/python examples/offline_demo.py
+      - uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
+        with:
+          name: python-distributions
+          path: dist/*
+          if-no-files-found: error
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/instagram-edits-sdk
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
+        with:
+          name: python-distributions
+          path: dist/
+      - name: Publish the verified distributions
+        uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # v1.14.2

instagram_edits_sdk-0.2.1/.github/workflows/tests.yml

@@ -0,0 +1,21 @@
+name: Python checks
+on: [push, pull_request]
+permissions:
+  contents: read
+jobs:
+  tests:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python: ["3.10", "3.12", "3.14"]
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: ${{ matrix.python }}
+      - run: python -m pip install .
+      - run: python -m unittest discover -s tests -v
+      - run: python examples/offline_demo.py
+      - run: python tools/generate_docs.py --check
+      - run: python tools/generate_openapi.py --check
+      - run: python tools/check_release.py

instagram_edits_sdk-0.2.1/CHANGELOG.md

@@ -0,0 +1,29 @@
+# Changelog
+
+## 0.2.1 — 2026-10-18
+
+- Rename the distribution to `instagram-edits-sdk` for PyPI; the `edits_api` import and `edits-api` CLI stay unchanged.
+- Add an English PyPI description, project links and bundled license metadata.
+- Add a tag-triggered build and publish workflow using PyPI Trusted Publishing.
+- Runtime API and observed live-query evidence remain unchanged from 0.2.0.
+
+## 0.2.0 — 2026-10-18
+
+- Preserve Reel statistics when retention is missing, null, empty, or all-null.
+- Add `insights` CLI, canonical path resolution, and typed cursor pages.
+- Exercise nine read operations plus a second Reel page against the live API.
+- Distinguish populated responses from null comment analysis and empty Kits.
+- Recover period and comment-sort enums; add all-method examples and local Swagger.
+- Keep live evidence sanitized and private responses outside the repository.
+
+## 0.1.0 — 2026-10-18
+
+- Package the original live-verified retention transport as an importable client.
+- Parse standard and observed canonical field names; preserve null and zero.
+- Add ownership checks, explicit JSON/CSV/SVG exports and a CLI.
+- Document HTTP/authentication, seven analytics wrappers and 15 detailed contracts.
+- Include a versioned 88-operation Edits index and 1663-entry shared registry.
+- Add synthetic tests, offline demo, release checks and GitHub Actions.
+
+Only the original BaselReelDetailsQuery exchange is server-verified. Other
+operations remain static findings. No private responses or credentials are shipped.

instagram_edits_sdk-0.2.1/CONTRIBUTING.md

@@ -0,0 +1,22 @@
+# Contributing
+
+Keep evidence levels explicit. A registry entry or a passing mock test must not
+be labelled as a live-verified server contract. Record APK version, operation ID,
+request variables, response schema, date and limits for a new finding.
+
+Do not submit cookies, Authorization headers, passwords, HAR captures, real
+personal response dumps, APK binaries, decompiled Meta source, or copied media.
+Fixtures must be clearly synthetic. Keep request examples read-only by default.
+
+Before submitting:
+
+```sh
+python -m pip install -e .
+python -m unittest discover -s tests -v
+python examples/offline_demo.py
+python tools/generate_docs.py --check
+python tools/check_release.py
+```
+
+CI must never call Instagram. Real verification needs an explicitly authorized
+account, and should publish only a sanitized evidence record.

instagram_edits_sdk-0.2.1/LICENSE

@@ -0,0 +1,26 @@
+MIT License
+
+Copyright (c) 2026 Instagram Edits API Research contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+This license applies to original code and documentation in this repository.
+Instagram, Edits, Meta, and their trademarks are owned by their respective owners.
+No Meta APKs, decompiled sources, media, credentials, or private response dumps
+are distributed with this repository.

instagram_edits_sdk-0.2.1/MANIFEST.in

@@ -0,0 +1,7 @@
+include README.md README.en.md PYPI_README.md LICENSE CONTRIBUTING.md SECURITY.md CHANGELOG.md REPOSITORY.md
+recursive-include docs *.md *.json *.html *.css *.js *.txt LICENSE NOTICE
+recursive-include examples *.py
+recursive-include tests *.py *.json
+recursive-include tools *.py
+recursive-include .github *.yml
+global-exclude __pycache__ *.py[cod]

instagram_edits_sdk-0.2.1/PKG-INFO

@@ -0,0 +1,108 @@
+Metadata-Version: 2.4
+Name: instagram-edits-sdk
+Version: 0.2.1
+Summary: Unofficial, evidence-based Instagram Edits API research client
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/lupikovoleg/instagram-edits-sdk
+Project-URL: Documentation, https://github.com/lupikovoleg/instagram-edits-sdk#readme
+Project-URL: Repository, https://github.com/lupikovoleg/instagram-edits-sdk
+Project-URL: Issues, https://github.com/lupikovoleg/instagram-edits-sdk/issues
+Keywords: instagram,edits,reels,analytics,retention,sdk
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: docs/swagger/vendor/LICENSE
+License-File: docs/swagger/vendor/NOTICE
+License-File: docs/swagger/vendor/swagger-ui-bundle.js.LICENSE.txt
+Dynamic: license-file
+
+# Instagram Edits SDK
+
+Unofficial Python SDK for Instagram Edits: Reel statistics, audience analytics,
+retention curves, and documented internal GraphQL operations. Not affiliated with Meta.
+
+## Install
+
+```bash
+python -m pip install instagram-edits-sdk
+```
+
+Python 3.10 or newer. No runtime dependencies. The Python import is `edits_api`;
+the command-line entry point is `edits-api`.
+
+If you installed the earlier local distribution `instagram-edits-research`,
+uninstall it before installing this package: both provide the same import module.
+
+## Quickstart
+
+Supply `IG_SESSIONID` through your backend's environment or secret manager.
+Use the Instagram session of the Reel owner. Do not embed it in frontend code.
+The SDK uses an existing session; it does not log in or obtain browser cookies.
+
+```python
+from edits_api import EditsClient
+
+client = EditsClient.from_env()
+reel = client.reel_insights("https://www.instagram.com/reel/YOUR_SHORTCODE/")
+
+plays = reel.metrics.get("play_count")
+likes = reel.metrics.get("like_count")
+
+if reel.retention_available:
+    points = [{"index": p.index, "percent": p.percent} for p in reel.retention]
+else:
+    points = None
+
+# Optional: export to a new directory. JSON always; CSV/SVG with available retention.
+reel.export("results/my-reel")
+```
+
+Missing, null, empty, or all-null retention does not discard other Reel metrics.
+`client.retention()` is strict and raises `EditsError` when no curve is available.
+Zero and null are preserved as different values.
+
+## Other read methods
+
+```python
+page = client.reels_page(first=3)
+if page.has_next_page:
+    next_page = client.reels_page(first=3, after=page.next_cursor)
+
+account = client.account_insights(period="LAST_30_DAYS", include_time_series=True)
+views = account.get_data("xig_user_by_igid_v2", "basel_insights", "reels_views", "value")
+
+audience = client.audience_insights(period="LAST_30_DAYS", client_timezone="UTC")
+public_metrics = client.public_insights("YOUR_NUMERIC_MEDIA_ID")
+```
+
+Also available: `account_reels`, `reels_delta`, `comment_insights`, `kits`,
+`extended_reel_insights`, and an explicit `execute` interface. `QueryResult.get_data`
+resolves observed canonical field names; `payload` keeps the original response.
+
+## Documentation and evidence
+
+- [Authentication and passing session credentials](https://github.com/lupikovoleg/instagram-edits-sdk/blob/main/docs/authentication.md)
+- [Data fields and examples for all documented read methods](https://github.com/lupikovoleg/instagram-edits-sdk/blob/main/docs/data-reference.md)
+- [Retention example](https://github.com/lupikovoleg/instagram-edits-sdk/blob/main/examples/retention.py)
+- [HTTP contract and response handling](https://github.com/lupikovoleg/instagram-edits-sdk/blob/main/docs/http-api.md)
+- [Operation catalog](https://github.com/lupikovoleg/instagram-edits-sdk/blob/main/docs/methods.md)
+- [OpenAPI and local Swagger viewer](https://github.com/lupikovoleg/instagram-edits-sdk/blob/main/docs/swagger.md)
+- [Verification scope](https://github.com/lupikovoleg/instagram-edits-sdk/blob/main/docs/verification.md)
+
+Nine read operations were exercised on one consenting account on 2026-10-18,
+plus a second page of Reels. Seven returned data; comment analysis was null and
+Kits was empty. Other accounts, every parameter combination, and populated
+comment/Kits results are not verified. The source includes 15 detailed contracts
+and a broader static operation registry, not a claim that all entries work.
+
+These are internal, versioned endpoints and can change. No automatic login,
+challenge bypass, session refresh, retries, or unbounded pagination. Mutations
+are untested and require explicit opt-in. Keep credentials private and use only
+accounts and data you are authorized to access.
+
+Original SDK and documentation: MIT. The source distribution includes a local
+Swagger UI with its Apache-2.0 license and dependency notices. No APK, decompiled
+Meta source, real session credentials, or private response dumps are included.

instagram_edits_sdk-0.2.1/PYPI_README.md

@@ -0,0 +1,87 @@
+# Instagram Edits SDK
+
+Unofficial Python SDK for Instagram Edits: Reel statistics, audience analytics,
+retention curves, and documented internal GraphQL operations. Not affiliated with Meta.
+
+## Install
+
+```bash
+python -m pip install instagram-edits-sdk
+```
+
+Python 3.10 or newer. No runtime dependencies. The Python import is `edits_api`;
+the command-line entry point is `edits-api`.
+
+If you installed the earlier local distribution `instagram-edits-research`,
+uninstall it before installing this package: both provide the same import module.
+
+## Quickstart
+
+Supply `IG_SESSIONID` through your backend's environment or secret manager.
+Use the Instagram session of the Reel owner. Do not embed it in frontend code.
+The SDK uses an existing session; it does not log in or obtain browser cookies.
+
+```python
+from edits_api import EditsClient
+
+client = EditsClient.from_env()
+reel = client.reel_insights("https://www.instagram.com/reel/YOUR_SHORTCODE/")
+
+plays = reel.metrics.get("play_count")
+likes = reel.metrics.get("like_count")
+
+if reel.retention_available:
+    points = [{"index": p.index, "percent": p.percent} for p in reel.retention]
+else:
+    points = None
+
+# Optional: export to a new directory. JSON always; CSV/SVG with available retention.
+reel.export("results/my-reel")
+```
+
+Missing, null, empty, or all-null retention does not discard other Reel metrics.
+`client.retention()` is strict and raises `EditsError` when no curve is available.
+Zero and null are preserved as different values.
+
+## Other read methods
+
+```python
+page = client.reels_page(first=3)
+if page.has_next_page:
+    next_page = client.reels_page(first=3, after=page.next_cursor)
+
+account = client.account_insights(period="LAST_30_DAYS", include_time_series=True)
+views = account.get_data("xig_user_by_igid_v2", "basel_insights", "reels_views", "value")
+
+audience = client.audience_insights(period="LAST_30_DAYS", client_timezone="UTC")
+public_metrics = client.public_insights("YOUR_NUMERIC_MEDIA_ID")
+```
+
+Also available: `account_reels`, `reels_delta`, `comment_insights`, `kits`,
+`extended_reel_insights`, and an explicit `execute` interface. `QueryResult.get_data`
+resolves observed canonical field names; `payload` keeps the original response.
+
+## Documentation and evidence
+
+- [Authentication and passing session credentials](https://github.com/lupikovoleg/instagram-edits-sdk/blob/main/docs/authentication.md)
+- [Data fields and examples for all documented read methods](https://github.com/lupikovoleg/instagram-edits-sdk/blob/main/docs/data-reference.md)
+- [Retention example](https://github.com/lupikovoleg/instagram-edits-sdk/blob/main/examples/retention.py)
+- [HTTP contract and response handling](https://github.com/lupikovoleg/instagram-edits-sdk/blob/main/docs/http-api.md)
+- [Operation catalog](https://github.com/lupikovoleg/instagram-edits-sdk/blob/main/docs/methods.md)
+- [OpenAPI and local Swagger viewer](https://github.com/lupikovoleg/instagram-edits-sdk/blob/main/docs/swagger.md)
+- [Verification scope](https://github.com/lupikovoleg/instagram-edits-sdk/blob/main/docs/verification.md)
+
+Nine read operations were exercised on one consenting account on 2026-10-18,
+plus a second page of Reels. Seven returned data; comment analysis was null and
+Kits was empty. Other accounts, every parameter combination, and populated
+comment/Kits results are not verified. The source includes 15 detailed contracts
+and a broader static operation registry, not a claim that all entries work.
+
+These are internal, versioned endpoints and can change. No automatic login,
+challenge bypass, session refresh, retries, or unbounded pagination. Mutations
+are untested and require explicit opt-in. Keep credentials private and use only
+accounts and data you are authorized to access.
+
+Original SDK and documentation: MIT. The source distribution includes a local
+Swagger UI with its Apache-2.0 license and dependency notices. No APK, decompiled
+Meta source, real session credentials, or private response dumps are included.

instagram_edits_sdk-0.2.1/README.en.md

@@ -0,0 +1,80 @@
+# Instagram Edits SDK
+
+Unofficial Python SDK and developer documentation for Instagram Edits analytics,
+Reel insights, audience statistics, and retention curves. Python 3.10+, no runtime
+dependencies. This is not an official Meta SDK or a hosted service.
+
+## Install and use
+
+The PyPI release is prepared for installation with:
+
+```sh
+python -m pip install instagram-edits-sdk
+```
+
+Until the first upload completes, install from source:
+
+```sh
+git clone https://github.com/lupikovoleg/instagram-edits-sdk.git
+cd instagram-edits-sdk
+python -m pip install .
+```
+
+Distribution: `instagram-edits-sdk` 0.2.1. Import: `edits_api`. CLI: `edits-api`.
+If migrating from the earlier local `instagram-edits-research` distribution,
+uninstall it first: both distributions provide the same `edits_api` module.
+Inject your own Instagram owner's session into `IG_SESSIONID` using a secret manager.
+The library does not log in or read browser cookies.
+
+```python
+from edits_api import EditsClient
+
+client = EditsClient.from_env()
+reel = client.reel_insights("https://www.instagram.com/reel/YOUR_SHORTCODE/")
+plays = reel.metrics.get("play_count")
+retention = [{"index": p.index, "percent": p.percent} for p in reel.retention] \
+    if reel.retention_available else None
+snapshot = reel.to_dict()
+
+page = client.reels_page(first=3)
+if page.has_next_page:
+    second_page = client.reels_page(first=3, after=page.next_cursor)
+
+account = client.account_insights(include_time_series=True)
+account_metrics = account.get_data("xig_user_by_igid_v2", "basel_insights")
+```
+
+Missing/null/empty/all-null retention does not discard other Reel statistics.
+`retention()` remains strict. Exports include JSON; CSV and SVG require available
+retention. Null values are not replaced by zeros. Response aliases are resolved by
+`QueryResult.get_data()`; the original payload remains available.
+
+## Available methods and evidence
+
+On 2026-10-18, the SDK made nine successful read-operation requests on one consenting
+account and an additional pagination request. Seven operations returned data.
+`comment_insights()` returned a null analysis block; `kits()` returned an empty list.
+These two results do not verify populated feature responses. Account availability,
+other enum combinations, batch limits, and future server compatibility are not guaranteed.
+
+Methods: `reel_insights`, `retention`, `public_insights`, `reels_page`, `account_reels`,
+`account_insights`, `audience_insights`, `reels_delta`, `comment_insights`, `kits`,
+`extended_reel_insights`, and the explicit `execute` interface.
+
+The source includes 15 detailed operation contracts, an 88-entry Basel/Eddy index,
+and the full 1663-operation APK registry. Mutations are untested and require explicit
+opt-in. No automatic retries, token refresh, challenge bypass, or unbounded pagination.
+
+[Russian quickstart](README.md) · [Data reference and all-method examples](docs/data-reference.md)
+· [Authentication](docs/authentication.md) · [HTTP](docs/http-api.md)
+· [Swagger / OpenAPI](docs/swagger.md) · [Verification scope](docs/verification.md)
+
+```sh
+python -m unittest discover -s tests -v
+python examples/offline_demo.py
+python tools/check_release.py
+```
+
+Tests use synthetic data without network access. Sanitized live evidence is separate.
+No APK, decompiled Meta sources, credentials, or personal response dumps are shipped.
+Original project code/docs: MIT. Bundled Swagger UI: Apache-2.0.

instagram_edits_sdk-0.2.1/README.md

@@ -0,0 +1,140 @@
+# Instagram Edits SDK
+
+Неофициальный Python SDK и документация внутренних методов Instagram Edits:
+статистика Reels, удержание, аналитика аккаунта и аудитории. Для интеграции в свой
+backend или аналитический сервис. Python 3.10+, без зависимостей во время работы.
+
+**Проверено 18 октября 2026:** девять методов чтения через реальные запросы SDK
+на одном аккаунте, плюс следующая страница Reels. Семь методов вернули данные;
+анализ комментариев вернул `null`, Kits — пустой список. Это не официальный SDK
+Meta и не гарантия доступности данных у любого аккаунта.
+
+[English](README.en.md) · [Какие данные доступны](docs/data-reference.md)
+· [Методы](docs/methods.md) · [Авторизация](docs/authentication.md)
+· [Интеграция](docs/integration.md) · [HTTP](docs/http-api.md)
+· [Swagger / OpenAPI](docs/swagger.md) · [Проверки](docs/verification.md) · [Выпуск в PyPI](docs/releasing.md)
+
+## Установка
+
+Для релиза в PyPI подготовлена команда:
+
+```sh
+python -m pip install instagram-edits-sdk
+```
+
+До завершения первой публикации можно установить из исходников:
+
+```sh
+git clone https://github.com/lupikovoleg/instagram-edits-sdk.git
+cd instagram-edits-sdk
+python -m pip install .
+```
+
+Имя дистрибутива — `instagram-edits-sdk`, импорт — `edits_api`, команда —
+`edits-api`. Версия 0.2.1. При переходе с локального `instagram-edits-research`
+удалите старый дистрибутив: оба используют один Python-модуль `edits_api`.
+
+```sh
+python -m pip uninstall instagram-edits-research
+```
+
+## Статистика Reel, даже без удержания
+
+Передайте процессу `IG_SESSIONID` из своего менеджера секретов. Нужна сессия
+Instagram владельца ролика. Пароль и токен публичного Graph API её не заменяют.
+SDK не извлекает cookie из браузера и не выполняет вход.
+
+```python
+from edits_api import EditsClient
+
+client = EditsClient.from_env()
+reel = client.reel_insights("https://www.instagram.com/reel/YOUR_SHORTCODE/")
+
+print(reel.metrics.get("play_count"))
+print(reel.metrics.get("like_count"))
+print(reel.metrics.get("skip_rate"))  # Объект с value/delta или None.
+
+if reel.retention_available:
+    points = [{"index": p.index, "percent": p.percent} for p in reel.retention]
+else:
+    points = None  # Нет данных, а не нулевое удержание.
+
+snapshot = reel.to_dict()  # Можно сохранить в своей БД.
+reel.export("results/my-reel")  # Новый каталог: JSON; CSV/SVG только с удержанием.
+```
+
+Отсутствующее, `null`, пустое или полностью `null`-удержание не мешает получить
+остальные метрики. Некорректная структура ответа, отказ сервера или другой владелец
+вызывают `EditsError`. `client.retention()` — строгий вариант: без графика выдаёт ошибку.
+[Пример статистики](examples/reel_statistics.py), [подробно об удержании](docs/retention.md).
+
+## Методы SDK
+
+| Метод | Данные | Результат живой проверки |
+|---|---|---|
+| `reel_insights()` / `retention()` | Метрики Reel, кривая удержания | Данные, 62 точки |
+| `public_insights()` | Счётчики и коэффициенты Reel | Данные; проверен свой Reel |
+| `reels_page()` / `account_reels()` | Список Reels, метрики, cursor | Две страницы по 3 ролика |
+| `account_insights()` | Агрегаты и временные ряды | Данные за `LAST_30_DAYS` |
+| `audience_insights()` | Демография, рост, активность подписчиков | Данные за `LAST_30_DAYS` |
+| `reels_delta()` | Обновление метрик списка ID | Данные для одного ID |
+| `comment_insights()` | Блок AI-анализа комментариев | Запрос принят, блок `null` |
+| `kits()` | Наборы элементов Edits | Запрос принят, список пуст |
+| `extended_reel_insights()` | Альтернативная ветка Instagram insights | Кривая удержания и демография |
+
+```python
+page = client.reels_page(first=3)
+for item in page.items:
+    print(item["id"], item.get("permalink"))
+if page.has_next_page:
+    next_page = client.reels_page(first=3, after=page.next_cursor)
+
+account = client.account_insights(include_time_series=True)
+metrics = account.get_data("xig_user_by_igid_v2", "basel_insights")
+```
+
+`QueryResult.payload` хранит исходный ответ. `get_data()` разрешает фактические
+canonical-имена (`1$xig_user_by_igid_v2(id:$user_id)` и подобные) по логическим
+именам. Он не нормализует единицы метрик. [Работа со всеми девятью методами](docs/data-reference.md).
+
+## Консоль и примеры
+
+```sh
+edits-api insights "https://www.instagram.com/reel/YOUR_SHORTCODE/" --output results/reel
+edits-api retention "https://www.instagram.com/reel/YOUR_SHORTCODE/" --output results/curve
+edits-api catalog
+python examples/list_reels.py --first 3 --output results/page.json
+python examples/account_statistics.py --period LAST_30_DAYS --output results/account.json
+python examples/account_statistics.py --audience --output results/audience.json
+```
+
+Каталоги/файлы вывода должны быть новыми. Сессия берётся из окружения, `--session
+settings.json` либо `--session -` (JSON из stdin). Секреты не передаются аргументами.
+
+## Документация, проверка, границы
+
+В репозитории 15 подробно разобранных контрактов, индекс 88 операций с именами
+Basel/Eddy и общий реестр 1663 операций APK 448.0.0.53.84. Наличие записи в APK
+само по себе не доказывает работоспособность. У каждой записи свой уровень доказательств.
+
+Swagger содержит реальный `POST /graphql_www` и девять примеров формы запроса,
+а не выдуманные REST-endpoints. Просмотр работает локально без CDN; отправка запросов
+в UI отключена. [Как открыть](docs/swagger.md).
+
+```sh
+python -m unittest discover -s tests -v
+python examples/offline_demo.py
+python tools/generate_docs.py --check
+python tools/check_release.py
+```
+
+Тесты синтетические и не обращаются к Instagram. [Обезличенные свидетельства живых
+запросов](docs/evidence/method-verification.json) отдельно фиксируют реальную проверку.
+
+Автоматических retries, входа, обновления сессии и обхода challenge нет. Пределы
+запросов и пакетов не установлены. Mutations требуют `allow_mutation=True`, не
+входят в проверенную часть SDK и в исследовании на сервере не запускались.
+
+В репозитории нет APK, исходников Meta, cookies, личной аналитики и медиа.
+MIT относится к оригинальному коду и документации проекта; Swagger UI имеет свою
+[лицензию Apache-2.0](docs/swagger/vendor/LICENSE).

instagram_edits_sdk-0.2.1/REPOSITORY.md

@@ -0,0 +1,30 @@
+# GitHub repository metadata
+
+**Repository name:** `instagram-edits-sdk`
+
+**Description:**
+
+> Unofficial Python SDK for Instagram Edits: Reel insights, retention curves, audience analytics, and reverse-engineered API documentation.
+
+**Topics:**
+
+`instagram` `instagram-edits` `python` `sdk` `reels` `analytics` `retention` `reverse-engineering` `openapi`
+
+**Suggested About website:** leave blank until documentation is hosted.
+
+**Initial release title:** `v0.2.1 — Reel analytics SDK and verified read methods`
+
+**Release summary:**
+
+> Installable Python SDK with Reel statistics that remain available when retention is missing, cursor-based pagination, account and audience analytics, examples, and local Swagger documentation. Nine read operations were exercised on one consenting account; comment analysis returned null and Kits returned an empty list. No mutations were tested. Not affiliated with Meta.
+
+The repository, package distribution, and Python import have different names:
+
+| Purpose | Name |
+|---|---|
+| GitHub repository | `instagram-edits-sdk` |
+| Python distribution | `instagram-edits-sdk` |
+| Python import | `edits_api` |
+| CLI | `edits-api` |
+
+The GitHub repository contains the SDK source, examples and documentation. Installation instructions are in README.md. The first PyPI release is being prepared. No hosted API is provided.

instagram_edits_sdk-0.2.1/SECURITY.md

@@ -0,0 +1,13 @@
+# Credentials and private data
+
+Report credential exposure privately to the repository maintainer; do not paste
+tokens into an issue. This repository does not operate an authentication service.
+
+Session credentials belong in your secret manager or a local ignored file.
+Exports can contain personal analytics and signed media URLs. Do not commit them.
+If a credential was exposed, end the relevant Instagram session using Instagram's
+account controls and replace the credential in your service.
+
+The client verifies TLS, does not follow redirects with credentials, bounds
+response sizes and timeouts, and does not log request headers. It does not bypass
+Instagram account challenges or implement arbitrary-target HTTP requests.