Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including gfycat-sdk with all npm packages installed. Try it out:

var gfycatSdk = require("gfycat-sdk")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

gfycat-sdk v1.4.10

Javascript module for gfycat.com API supporting promises and callbacks

gfycat-sdk

NPM

Build Status

Javascript API wrapper for Gfycat.com API that supports callbacks and promises.

Installation

npm install gfycat-sdk --save

Usage

Obtain a client_id and client_secret for your integration from the Gfycat developers portal.

const Gfycat = require('gfycat-sdk');

var gfycat = new Gfycat({clientId: YOUR_CLIENT_ID, clientSecret: YOUR_CLIENT_SECRET});

For security reasons, we suggest storing the client id and secret in a secure location.

Methods

Authenticate

Returns a callback, or promise that resolves to the api authentication token that is valid for 1 hour

Callback

gfycat.authenticate((err, data) => {
  //Your app is now authenticated
  assert.equal(data.access_token, gfycat.token);
  console.log('token', gfycat.token);
})

Promise

gfycat.authenticate().then(res => {
  //Your app is now authenticated
  assert.equal(res.access_token, gfycat.token);
  console.log('token', gfycat.token);
});

Search

Returns a promise that resolves to a gfycats object. API supports pagination using cursors and count/first. The optional random attribute will randomize the result returned by the API - do not supply pagination attributes with this.

let options = {
  search_text: 'hello',
  count: 20,
  first: 30
};

gfycat.search(options).then(data => {
  console.log('gfycats', data);
});

Get User Details

Returns user account information by username

let options = {
  userId: 'myUsername'
};

gfycat.getUserDetails(options).then(data => {
  console.log(data);
});

Get Gfycat Details

Return Gfycat json by gfycat name

let options = {
  gfyId: 'richpepperyferret'
};

gfycat.getGifDetails(options).then(data => console.log(data))

Get User Feed

Return the gfycats uploaded and shared by a given username.

let options = {
  userId: 'myUsername'
};

gfycat.userFeed(options).then(data => console.log(data))

Get Trending GIFs

Return JSON of currently trending gifs

let options = {
  count: 10,
  cursor: ''
}

gfycat.trendingGifs(options).then(data => console.log(data))

Get Trending Tags

Return JSON of currently trending tags

let options = {
  count: 10,
  populated: false
}

gfycat.trendingTags(options).then(data => console.log(data))
RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free