Social Parse
PricingDashboard
YouTube

Hashtag shorts

A hashtag's shorts, 36 a page.

GET/v1/youtube/hashtags/shorts1 credit

Headers

Get your API key
x-api-key*stringrequiredheader

Your API key, made in the dashboard.

Parameters

2
tag*stringrequiredquery

A hashtag, with or without the #.

example: funny

cursorstringoptionalquery

For the next page: page.next_cursor from the page before. Send the other parameters again with it.

max 8192 chars

Response fields

25
dataarray

The result: one object, or a list for the endpoints that return several.

data[].idstring

The video's id: 11 characters.

data[].urlstring

The video's link.

data[].titlestringnullable

Its title.

data[].is_shortbooleannullable

Whether it is a short. Search, which mixes both, and the video endpoint set it; elsewhere it is null.

data[].thumbnailstringnullable

Its thumbnail's link.

data[].duration_secondsintegernullable

Its length, in seconds.

data[].viewsintegernullable

Views: exact where YouTube shows the exact number, else YouTube's rounding (12M is 12000000).

data[].publishedstringnullable

How long ago it was published, as YouTube words it: "4h ago" in some lists, "14 years ago" in others.

data[].channel_idstringnullable

Its channel's id.

data[].channel_namestringnullable

Its channel's name.

data[].channel_handlestringnullable

Its channel's handle, without the @.

data[].badgesstring[]nullable

YouTube's labels on it, such as "New", "4K" or "CC".

data[].descriptionstringnullable

Its description: the start of it in search results, all of it from the video endpoint.

pageobjectnullable

Paging, for the endpoints that page; null for the others.

page.next_cursorstringnullable

Send it as the cursor parameter, with the same other parameters, for the next page. Null on the last page.

page.has_morebooleanoptional

Whether another page follows.

default: false

metaobject

About this call.

meta.platformstring

The platform: reddit, threads, tiktok or youtube.

meta.endpointstring

The endpoint's name, such as channel_videos.

meta.paramsobject

The call's parameters, defaults included. Parameters without a value, and the cursor, are left out.

meta.request_idstring

This call's id. Quote it when you report a problem.

meta.api_versionstring

The API version that answered.

meta.fetched_atstring

When the data was fetched from the platform (UTC).

format: date-time

meta.cachedbooleanoptional

Whether it came from our cache; fetched_at says how old it is.

default: false

Code example

curl -X GET 'https://api.socialparse.dev/v1/youtube/hashtags/shorts?tag=funny' \  -H 'x-api-key: YOUR_API_KEY'

Responses

Successful Response

{  "data": [    {      "id": "string",      "url": "string",      "title": "string",      "is_short": true,      "thumbnail": "string",      "duration_seconds": 0,      "views": 0,      "published": "string",      "channel_id": "string",      "channel_name": "string",      "channel_handle": "string",      "badges": [        "string"      ],      "description": "string"    }  ],  "page": {    "next_cursor": "string",    "has_more": false  },  "meta": {    "platform": "string",    "endpoint": "string",    "params": {      "property1": "string",      "property2": "string"    },    "request_id": "string",    "api_version": "string",    "fetched_at": "2019-08-24T14:15:22Z",    "cached": false  }}

Hashtag videos

A hashtag's videos: the first ones its page shows, up to about 20. There is no next page.