Usage Guide

This section provides detailed descriptions of all the ways aiograpi can be used. If you are new to aiograpi, the Getting Started page provides a gradual introduction of the basic functionality with examples.

Public vs Private Requests

• Public web methods have a suffix _gql (Instagram GraphQL). Legacy ?__a=1 helpers were removed because that public web response is no longer reliable.
• Private (authorized request via mobile api) methods have _v1 suffix

The first request to fetch media/user is public (anonymous), if instagram raise exception, then use private (authorized).

Detailed Sections

• Index
• Getting Started
• Interactions
• Media - Publication (also called post): Photo, Video, Album, IGTV and Reels
• Resource - Part of Media (for albums)
• MediaOembed - Short version of Media
• Account - Full private info for your account (e.g. email, phone_number)
• User - Full public user data
• UserShort - Short public user data (used in Usertag, Comment, Media, Direct Message)
• Usertag - Tag user in Media (coordinates + UserShort)
• Location - GEO location (GEO coordinates, name, address)
• Hashtag - Hashtag object (id, name, picture)
• Collection - Collection of medias (name, picture and list of medias)
• Comment - Comments to Media
• Highlight - Highlights
• Story - Story
• StoryLink - Link (Swipe up)
• StoryLocation - Tag Location in Story (as sticker)
• StoryMention - Mention users in Story (user, coordinates and dimensions)
• StoryHashtag - Hashtag for story (as sticker)
• StorySticker - Tag sticker to story (for example from giphy)
• StoryBuild - StoryBuilder return path to photo/video and mention co-ordinates
• DirectThread - Thread (topic) with messages in Direct Message
• DirectMessage - Message in Direct Message
• Insight - Insights for a post
• Track - Music track (for Reels/Clips)
• Best Practices
• Development Guide
• Handle Exceptions
• Exceptions