gfycat v3.0.0
gfycat
Unofficial Node JavaScript API wrapper written in TypeScript for Gfycat.com API. Why an unofficial SDK? The official Gfycat JavaScript client is incomplete and lacks TypeScript support.
Table of Contents
Install
This package requires Node version 14 or higher.
Install with npm
npm i gfycat
or yarn
yarn add gfycat
Usage
See examples in the examples
directory.
You will need a Gfycat API client id and client secret. Follow the steps in the Gfycat API documentation to obtain a client id and client secret.
You can enable logging by setting the DEBUG
environment variable to gfycat
, i.e. DEBUG=gfycat
or DEBUG=*
.
Features
This is a work-in-progress SDK. Not all APIs are implemented. The list of documented Gfycat API endpoints can be found in the Gfycat API documentation.
Authentication
- Client Credentials Grant (currently, the GfycatClient only uses password grant authentication)
- Password Grant Authentication
- Refreshing access token
- Checking if username is available / exists / is valid
- Checking if your user's email is verified or not
- Send verification email
- Send a password reset email
Users
- Getting a user's public details
- Getting authenticated user's details
- Updating a user's details
- Uploading user's profile image
- Creating a new user account
- Following another user
- Unfollowing a user
- Checking if you follow a user
- List all users you follow
- List all users following you
- Get all of your likes
User Feeds
- Listing the the feed of published gfycats for a user
- Listing the the private feed of all gfycats for a user
- Listing the timeline feed of all users you follow
Collections
The collections APIs are undocumented.
- Create a collection
- Add to a collection
- Remove from a collection
- Delete a collection
- Get a user's collections
- Get gfycats in a collection
Gfycat
- Getting info for a single gfycat
- Get number of likes
- Get your Gfycats
- Get a user's Gfycats
- Creating Gfycats
- Updating Gfycats
- Update gfycat title
- Delete gfycat title
- Update gfycat description
- Delete gfycat description
- Get my gfycat like status
- Like my gfycat
- Update/replace gfycat tags
- Get gfycat domain whitelist
- Update/replace gfycat domain whitelist
- Get gfycat geo whitelist
- Update/replace geo whitelist
- Delete gfycat whitelist
- Update gfycat visibility
- Update/replace gfycat nsfw flag
- Delete a gfycat
Trending Feeds
Search
Contributing
This project uses commitizen and semantic-release. When committing, please use npm run commit
to let commitizen create your commit.