Developer documentation · API v1
Accounts and your tracking list
Look up stored profile totals or get your tracked accounts in one request.
Your tracking list
GET /open-api/v1/tracking?limit=50
Authorization: Bearer YOUR_API_KEYBy default, the response includes active and paused accounts. Add includeArchived=true for readable removed items. Use limit (1–100, default 50) and nextCursor to page through the list.
Each item includes id, username, fullName, avatarUrl, status, trackedLists, followerCount, followingCount, profileAsOf and listSnapshots. listSnapshots has separate followers and following timestamps. No per-account source calls are needed.
The top-level meta.asOf is null because the accounts were observed at different times. Read each item's timestamps. The status values are active, paused and archived.
Profile and totals
GET /open-api/v1/accounts/alice
Authorization: Bearer YOUR_API_KEYThe profile includes a string id, username, fullName, isPrivate, isVerified, followerCount, followingCount, avatarUrl and trackedLists. Unknown totals are null. trackedLists contains only your readable list types; an untracked account has an empty array.
Data comes from a stored profile or reusable public query data. This GET does not call Instagram data sources to fill missing fields. meta.asOf is the profile's observation time, which may differ from the follower snapshot time.
Account names can change
Use username for the initial request; preserve the stable string id in your own records. Pagination stays tied to that ID. If a name change or reused username creates an identity conflict, account_changed asks you to check the account again.
Total counts are not list lengths
An account can have followerCount=1200 while its available follower snapshot contains 850 observed members. Neither number is the current page length. See followers and following for the list response.