Skip to content

aiograpi-rest

aiograpi-rest is a RESTful HTTP service for aiograpi, the async Python wrapper for Instagram's private mobile API.

Use it when your application is not written in Python, but you still want to run the maintained aiograpi client behind a simple OpenAPI-compatible HTTP boundary.

What It Provides

  • Login, relogin, session import, settings export/import, and runtime proxy, locale, and timezone updates.
  • Account profile, privacy, profile picture, and authenticated account info.
  • User profile, follower, following, follow, mute, block, friendship, pinned posts, guides, follow request, highlight, and about endpoints.
  • Search and discovery endpoints for users, accounts, followers/following, hashtags, hashtag Reels, locations, location guides, music, places, top results, Reels, recent searches, and typeahead suggestions.
  • Paginated media, user, hashtag, location, story viewer/archive, and Direct inbox/request/channel endpoints.
  • Media paginated comments, likes, saves, pins, archive, photo, video, Reel, carousel album, story, highlight, note, media note, notification, IGTV, and insights routes.
  • OpenAPI documentation at /docs and raw schema at /openapi.json.
  • Typed client generation guide for Swift, Go, TypeScript, Python, PHP, Rust, Kotlin, Scala, C#, C++, and other OpenAPI Generator targets.
  • Service health endpoints: /health, /ready, /metrics, /build, and /deps.
  • Python package layout under aiograpi_rest/, with Docker and local uvicorn entrypoints using aiograpi_rest.main:app.

What It Does Not Hide

Self-hosting means you still operate the Instagram accounts, proxies, session storage, retries, and challenge handling. If you want a managed API instead, see HikerAPI.

Method Coverage

The service intentionally exposes a focused subset of aiograpi.Client. The generated aiograpi coverage report lists every public client method, whether it is reachable through a REST route, and whether an uncovered method is a duplicate implementation variant or an internal helper.

Current stable release: v6.0.0, wrapping aiograpi==1.0.9. See the changelog for release notes and verification evidence.