# instagram-nodejs

> Instagram CLient nodejs

Latest version **0.0.1** (published 2016-10-19) · ISC license · 0 weekly downloads

## Install

```sh
npm install instagram-nodejs
pnpm add instagram-nodejs
yarn add instagram-nodejs
bun add instagram-nodejs
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.0.1 |
| Published | 2016-10-19 |
| First published | 2016-10-19 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 1 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | agusfantasy |
| Maintainers | agusto |

## Links

- npm: https://www.npmjs.com/package/instagram-nodejs
- npm.io page: https://npm.io/package/instagram-nodejs

## Dependencies (1)

- [request-promise](https://npm.io/package/request-promise.md) ^1.0.0

## Recent versions

- 0.0.1 (latest) — 2016-10-19

## README

Instagram-nodejs
======
Nodejs client for the Instagram REST and Search APIs.
Please read documentation from officical instagram http://instagram.com/developers/

Installation
-----
npm install agusfantasy/instagram-nodejs.git

Authentication
-----

Instagram API uses the OAuth2 protocol for authentication, but not all functionality requires authentication.
See the docs for more information: http://instagram.com/developer/authentication/

### Authenticating a user

The provided sample app shows a simple OAuth flow for authenticating a user and getting an access token for them.

``` javascript
var auth = require('./auth.js');

auth.connect('YOUR_CLIENT_ID', 'REDIRECT_URI');
```

### Using an access token

Once you have an access token (whether via the script or from the user flow), you can  pass that token into the InstagramAPI constructor:

You can use single function to call endpoint:
``` javascript
var ins = instagram.init('YOUR_ACCESS_TOKEN');

ins.connect('ENDPOINT_PATH', 'HTTP_VERB', 'PARAM');
```

OR one by one method. Please see description below

Data Retrieval:
-----

See the endpoints docs for more on these methods: http://instagr.am/developer/endpoints/
    
``` javascript
var ins = instagram.init('YOUR_ACCESS_TOKEN');

ins.{method(param)}
	.then(function(response){
		//response;
	})
	.catch(function(err){
		//err;
	}))

//Method Name List	

//Media
ins.media(media_id)
ins.mediaShortcode();
ins.mediaSearch(q);
ins.mediaPopular();

//User
ins.user(user_id)
ins.usersSelfFeed();
ins.userLikedMedia();
ins.usersMediaRecent(user_id);
ins.userSearch(q);
ins.usersFollows(user_id);
ins.usersFollowedBy(user_id);
ins.usersSelfRequestedBy();
ins.usersGetRelationship(user_id);
ins.usersPostRelationship(user_id);

//Media Comment
ins.mediaGetComment(media_id);
ins.mediaPostComment(media_id, param);
ins.mediaDelComment(media_id);

//Media Likes
ins.mediaGetLikes(media_id);
ins.mediaPostLikes(media_id, data);
ins.mediaDelLikes(media_id);

//Tags
ins.tags(tag_name);
ins.tagsMediaRecent(tag_name);
ins.tagsSearch(q);

//Location
ins.location(location_id);
ins.locationMediaRecent(location_id);
ins.locationSearch(lat, lng);
```

---
_Source: https://npm.io/package/instagram-nodejs · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._