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, search, friendship, follow request, highlight, and about endpoints.
  • Paginated media, user, hashtag, location, story viewer/archive, and Direct inbox list endpoints.
  • Media comments, likes, saves, pins, archive, photo, video, Reel, carousel album, story, highlight, 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 and whether it is reachable through a REST route.