Pull API \ Retrieve Clips Information

Resource/URI GET
Facebook · Retrieve a user's likes /pull/identities/<identity_token>/facebook/likes.json Retrieve Likes
Facebook · Retrieve a user's posts /pull/identities/<identity_token>/facebook/posts.json Retrieve Posts
Facebook · Retrieve a user's groups /pull/identities/<identity_token>/facebook/groups.json Retrieve Groups
Facebook · Retrieve a user's group posts /pull/identities/<identity_token>/facebook/group/<pageid>/posts.json Retrieve Group Posts
Facebook · Retrieve a user's pages /pull/identities/<identity_token>/facebook/pages.json Retrieve Pages
Facebook · Retrieve a user's page posts /pull/identities/<identity_token>/facebook/page/<pageid>/posts.json Retrieve Page Posts
Facebook · Retrieve a user's page post reactions /pull/identities/<identity_token>/facebook/page/<pageid>/posts.json Retrieve Page Post Reactions
LinkedIn · Retrieve a user's posts /pull/identities/<identity_token>/linkedin/user/posts.json Retrieve User Posts
LinkedIn · Retrieve a user's companies /pull/identities/<identity_token>/linkedin/companies.json Retrieve Companies
LinkedIn · Retrieve a user's company posts /pull/identities/<identity_token>/linkedin/company/<companyid>/posts.json Retrieve Company Posts
LinkedIn · Retrieve a post /pull/identities/<identity_token>/linkedin/post.json Retrieve Post
LinkedIn · Retrieve post comments /pull/identities/<identity_token>/linkedin/post/comments.json Retrieve Post Comments
Pinterest · Retrieve a user's boards /pull/identities/<identity_token>/pinterest/boards.json Retrieve Boards
Pinterest · Retrieve a user's board pins /pull/identities/<identity_token>/pinterest/board/<boardid>/pins.json Retrieve Board Pins
Steam · Retrieve a user's games /pull/identities/<identity_token>/steam/games.json Retrieve Games
TikTok · Retrieve videos information /pull/identities/<identity_token>/tiktok/videos.json Retrieve Videos
Twitch · Retrieve all broadcaster's subscriptions /pull/identities/<identity_token>/twitch/broadcaster/subscriptions.json Retrieve Broadcaster's subscriptions
Twitch · Retrieve channels information /pull/identities/<identity_token>/twitch/channels.json Retrieve Channels
Twitch · Retrieve clips information /pull/identities/<identity_token>/twitch/clips.json Retrieve Clips
Twitch · Retrieve games information /pull/identities/<identity_token>/twitch/games.json Retrieve Games
Twitch · Retrieve most viewed games /pull/identities/<identity_token>/twitch/games/top.json Retrieve Top Games
Twitch · Retrieve live streams /pull/identities/<identity_token>/twitch/streams.json Retrieve Streams
Twitch · Retrieve users information /pull/identities/<identity_token>/twitch/users.json Retrieve Users
Twitch · Retrieve follow relationships between two users /pull/identities/<identity_token>/twitch/users/follow.json Retrieve Users Follows
Twitch · Retrieve videos information /pull/identities/<identity_token>/twitch/videos.json Retrieve Videos
Twitter · Retrieve a user's followers /pull/identities/<identity_token>/twitter/followers.json Retrieve Followers
Twitter · Retrieve a user's followings /pull/identities/<identity_token>/twitter/followings.json Retrieve Followings
Twitter · Retrieve a user's tweets /pull/identities/<identity_token>/twitter/tweets.json Retrieve Tweets
Twitter · Retrieve a user /pull/identities/<identity_token>/twitter/user.json Retrieve User
YouTube · Retrieve a user's channels /pull/identities/<identity_token>/youtube/channels.json Retrieve Channels
YouTube · Retrieve a user's playlists /pull/identities/<identity_token>/youtube/playlists.json Retrieve Playlists
YouTube · Retrieve a user's playlist videos /pull/identities/<identity_token>/youtube/playlist/<playlistid>/videos.json Retrieve Playlist Videos
YouTube · Retrieve a user's channel sections /pull/identities/<identity_token>/youtube/channel/sections.json Retrieve Channel Sections

Workflow

Request: the code to send to the API

Send an API request to this endpoint in order to retrieve clips information:

GET /pull/identities/<identity_token>/twitch/clips.json

The <identity_token> is obtained whenever one of your users connects using Twitch. The following URL parameters can optionally be used with this endpoint:

URL Parameter Description
* broadcaster_id
string 		Broadcaster ID for whom clips are returned.
You need to specify a broadcaster_id OR a game_id OR a clip_id.
* clip_id
string 		Game ID for which clips are returned.
You need to specify a broadcaster_id OR a game_id OR a clip_id.
* game_id
string 		ID of the clip being queried
You need to specify a broadcaster_id OR a game_id OR a clip_id.
after_cursor
string 		Cursor for forward pagination: tells the server where to start fetching the next set of results
Example: abCdEfghijkLCJhIjoiIn0
before_cursor
string 		Cursor for backward pagination: tells the server where to start fetching the next set of results
Example: abCdEfghijkLCJhIjoiIn0
num_clips
string 		Indicates how many clips should be included in the resultset.
Default: 25

Result: the code returned by the API

Response Example

{
  "response": {
    "request": {
      "date": "Wed, 28 Sep 2020 15:55:13 +0100",
      "resource": "/pull/identities/95681432-e02d-4a0b-ac6a-5c59d0e1fdfd/twitch/clips.json?broadcaster_id=67955580&num_clips=1&page=1",
      "status": {
        "flag": "success",
        "code": 200,
        "info": "Your request has been processed successfully"
      }
    },
    "result": {
      "data": {
        "count": 1,
        "cursor": abCdEfghijkLCJhIjoiIn0,
        "entries": [
          {
            "id": "AwkwardHelplessSalamanderSwiftRage",
            "url": "https://clips.twitch.tv/AwkwardHelplessSalamanderSwiftRage",
            "embed_url": "https://clips.twitch.tv/embed?clip=AwkwardHelplessSalamanderSwiftRage",
            "broadcaster_id": "67955580",
            "broadcaster_name": "ChewieMelodies",
            "creator_id": "53834192",
            "creator_name": "BlackNova03",
            "video_id": "205586603",
            "game_id": "488191",
            "language": "en",
            "title": "babymetal",
            "view_count": 10,
            "created_at": "2017-11-30T22:34:18Z",
            "thumbnail_url": "https://clips-media-assets.twitch.tv/157589949-preview-480x272.jpg"
          }
    }        
    }
  }
}

User Contributed Notes