instagram

An instagram API wrapper.

Features

Based on yanatan16/golang-instagram. Modernized and updated to match changes to the Instagram API.

Changes from the original:

• Removed deprecated API endpoints (which are many)
• Added support for new media type "carousel"
• Added support for OAuth flow to retrieve access token
• Added go module
• Added support for non-default http.Client
• Added support for context.Context

Testing

For the API, there are fake tests and integration tests. The fake tests swap fixtures JSON responses via an httptest server to cover specific caess. The integration tests use provided credentials to exercise the API in general ways (not specific to the authorized user).

# Run unit and fake tests
make test

# Run unit, fake, and integration tests (requires authentication, see below).
make test-integration

Authenticating

Set the following environment variables to run the integration tests and command line tool.

export TEST_INSTAGRAM_CLIENT_ID=<client id>
export TEST_INSTAGRAM_CLIENT_SECRET=<client secret>
export TEST_INSTAGRAM_ACCESS_TOKEN=<access token>

Getting an access token

You can retrieve an access token by setting the client id and client secret environment variables, then using the command line tool:

go run cmd/accesstoken/main.go

You'll need to open a URL in your browser, and log into Instagram. Then paste the resulting redirect URL back to the tool and it'll give you an Access Token.

Adding a test fixture

The cmd package contains a simple command line tools to query endpoints. You can use it to return sample data, then save it as a new fixture. Here's the command used to add the 'video' fixture.

go run cmd/list/main.go -count 1 -maxid 1979319391662961209_11073382793 -raw | jq . > testdata/video.json

License

MIT. See LICENSE file.