Skip to content

instagram.md

Latest commit

 

History

History
65 lines (47 loc) · 3.02 KB

instagram.md

File metadata and controls

65 lines (47 loc) · 3.02 KB
Raw

Instagram

Mode: 🔐 Browser · Domain: instagram.com

Commands

Command Description
opencli instagram profile Get user profile info
opencli instagram search Search users
opencli instagram user Get recent posts from a user
opencli instagram explore Discover trending posts
opencli instagram followers List user's followers
opencli instagram following List user's following
opencli instagram saved Get your saved posts (or one collection)
opencli instagram collection-create Create a new saved-posts collection
opencli instagram collection-delete Delete a saved-posts collection by name or id

Usage Examples

# View a user's profile
opencli instagram profile nasa

# Search users
opencli instagram search nasa --limit 5

# View a user's recent posts
opencli instagram user nasa --limit 10

# Discover trending posts
opencli instagram explore --limit 20

# List followers/following
opencli instagram followers nasa --limit 20
opencli instagram following nasa --limit 20

# Get your saved posts (default "All posts" feed)
opencli instagram saved --limit 10

# Get posts from a specific collection (case-insensitive name match)
opencli instagram saved --collection inspiration --limit 10

# Create a new saved-posts collection
opencli instagram collection-create "design refs"

# Delete a collection by name (or by numeric id, e.g. 17853899493659567)
opencli instagram collection-delete "design refs"

# JSON output
opencli instagram profile nasa -f json

Notes on collections

  • instagram saved without --collection returns the unsegmented "All posts" bucket (same as the original behaviour).
  • With --collection <name> it resolves the name to an id via /api/v1/collections/list/, then fetches /api/v1/feed/collection/{id}/posts/. Match is case-insensitive after trimming. An unknown name throws an error that lists the available names.
  • instagram collection-create <name> calls POST /api/v1/collections/create/ with a multipart name field. Instagram silently accepts duplicate names — the API just returns a new collection_id each time, so dedupe client-side if you care.
  • instagram collection-delete <name-or-id> calls POST /api/v1/collections/{id}/delete/. Pass either a case-insensitive collection name or a numeric collection_id. If the name resolves to multiple collections (e.g. duplicates from collection-create), the adapter throws and lists the candidate ids so you can disambiguate by passing the id explicitly. Unknown names list the available collections in the error message.
  • Saving an existing post directly into a named collection in one shot is not exposed by the web app's documented endpoints (/api/v1/web/save/{pk}/save/ only writes to "All posts"). Use instagram save first, then move the post in the UI, or extend with the /api/v1/collections/{id}/edit/ mutation.

Prerequisites