ginsta

Command line client written in Go that speaks to Instagram API.

Installation

All you need is install Go and run:

$ go get github.com/gedex/ginsta

Usage

Please note that some commands need Config.AccessToken. To retrieve that:

$ ginsta token_get
> open Instagram Authorize page

and to set retrieved access_token:

$ ginsta config access_token [ACCESS_TOKEN]

Basic

Help

ginsta help

Usage: ginsta [command] [options] [arguments]

Users Commands:
    user_info           Get basic information about a user
    user_feed           Get authenticated user's feed.
    user_recent_media   Get the most recent media published by a user.
    user_liked_media    Get the authenticated user's list of media they've liked.
    search_user         Search for a user by name

Relationships Commands:
    user_followings     Get the list of users this user follows.
    user_followers      Get the list of users this user is followed by.
    user_requested_by   Get the list of users who have requested this user's permission to follow
    relationship_with   Get information about a relationship to another user.
    follow_user         Follow a user specified with USER_ID
    unfollow_user       Unfollow a user specified with USER_ID
    block_user          Block a user specified with USER_ID
    unblock_user        Unblock a user specified with USER_ID
    approve_user        Approve request from user specified with USER_ID
    deny_user           Deny request from user specified with USER_ID

Media Commands:
    media_info          Get information about a media object.
    search_media        Search for media in a given area.
    popular_media       Get the list of what media is most popular at the moment.

Comments Commands:
    media_comments      Get the list of comments for this MEDIA_ID.
    add_comment         Add comment for MEDIA_ID.
    del_comment         Delete comment COMMENT_ID from MEDIA_ID.

Likes Commands:
    media_likes         Get the list of users who like this MEDIA_ID.
    add_like            Like this MEDIA_ID.
    del_like            Unlike this MEDIA_ID.

Tags Commands:
    tag_info            Get information about a tag [TAG_NAME].
    recent_media_by_tag  Get the list of media tagged with [TAG_NAME].
    search_tag          Search for tag.

Basic Commands:
    help                Show help
    version             Show version
    config              Get and set ginsta config
    token_get           Get access_token
    geocoding           Converting addresses into latitude and longitude representation.
    reverse_geocoding   Converting geographic coordinates into a human-readable address.

Version

$ ginsta version
ginsta version 0.1

Config

View all configs:

$ ginsta config

View particular config's key:

$ ginsta config access_token

Set particular config's key:

$ ginsta config access_token fb2e77d.47a0479900504cb3ab4a1f626d174d2d

Get access token

# with default client_id
$ ginsta token_get
> open Instagram Authorize page

# specify client_id
$ ginsta token_get -client-id [CLIENT_ID]
> open Instagram Authorize page

# specify scope
$ ginsta token_get -scope basic,comments
> open Instagram Authorize page

Users

user_info

$ ginsta user_info
User ID          : 174787104
Username         : akedabagus
Profile Pic URL  : http://images.ak.instagram.com/profiles/profile_47172384_75sq_1335356735.jpg
Total media      : 1
Total followings : 0
Total followers  : 6

$ ginsta user_info 3
User ID          : 3
Username         : kevin
Full name        : Kevin Systrom
Profile Pic URL  : http://images.ak.instagram.com/profiles/profile_3_75sq_1325536697.jpg
Bio              : CEO & Co-founder of Instagram
Total media      : 1313
Total followings : 507
Total followers  : 655735

user_feed

ginsta user_feed
Media ID             : 490313926454872962_312269417
Media type           : image
Filter               : Normal
Link                 : http://instagram.com/p/bN8esWxQuC/
Caption              : Aku sexy ya.. @vancaocean #kids #fashionkids #sachi
Caption by           : kikiwarnaen (312269417)
Number of comments   : 1
Number of likes      : 6
Created at           : 1372669996
Uploaded by          : kikiwarnaen (312269417)
...

$

Roadmap

• Users commands (In-progress)
• Relationships commands
• Likes commands
• Media commands
• Locations commands
• Geographies commands
• Tags commands
• Better usage doc

Credits

Some portion of the source code is taken from modified gh project, which is licensed under the MIT license.

License

ginsta is released under the BSD-style license found in the LICENSE.md file.