https://github.com/gedex/ginsta

Command line client written in Go that speaks to Instagram API
https://github.com/gedex/ginsta

Last synced: about 1 year ago
JSON representation

Command line client written in Go that speaks to Instagram API

• Host: GitHub
• URL: https://github.com/gedex/ginsta
• Owner: gedex
• License: other
• Created: 2013-07-03T17:02:30.000Z (about 13 years ago)
• Default Branch: master
• Last Pushed: 2013-08-31T06:26:31.000Z (almost 13 years ago)
• Last Synced: 2025-04-05T22:32:33.477Z (over 1 year ago)
• Language: Go
• Size: 160 KB
• Stars: 25
• Watchers: 7
• Forks: 0
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

          
ginsta

======

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

## Installation

All you need is [install Go](http://golang.org/doc/install) and run:

~~~text

$ 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

~~~text

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

~~~text

$ ginsta version

ginsta version 0.1

~~~

#### Config

View all configs:

~~~text

$ ginsta config

~~~

View particular config's key:

~~~text

$ ginsta config access_token

~~~

Set particular config's key:

~~~text

$ ginsta config access_token fb2e77d.47a0479900504cb3ab4a1f626d174d2d

~~~

#### Get access token

~~~text

# 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

~~~text

$ 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

~~~text

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](https://github.com/jingweno/gh/) project,

which is licensed under the MIT license.

## License

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