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.