Command line client written in Go that speaks to Instagram API
Go
Latest commit 48e6130 Aug 14, 2013 @gedex Bump version to 0.2.
Permalink
Failed to load latest commit information.
clients Bump version to 0.2. Aug 14, 2013
commands Removed unused line. Aug 14, 2013
utils Added printer for LocationsCommands. Aug 14, 2013
.gitignore Init. Jul 3, 2013
AUTHORS.md Init. Jul 3, 2013
LICENSE.md Init. Jul 3, 2013
README.md Updated 'ginsta help' after TagsCommands addition. Aug 13, 2013
gh-LICENSE.md Init. Jul 3, 2013
main.go Init. Jul 3, 2013

README.md

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.