Skip to content
Raw API
/
YouTube Raw Data

Overview

RAW API endpoints return real-time, unfiltered data data from public social media profiles on Instagram, TikTok, and YouTube. Use them to access profiles, content, comments, tags, and hashtag feeds — exactly as they appear on the platforms.

These endpoints are ideal for custom analytics, live monitoring, or building your own enrichment workflows.

⚠️ Data is returned as-is, without filtering. Handle rate limits and pagination as needed.

Read the Raw API Best Practices guide →

Download OpenAPI description
raw.json
raw.yaml
Overview
URL

https://www.modash.io

API Support

hello@modash.io

Terms of Service

Languages
Servers

https://api.modash.io/v1/

Instagram Raw Data

Instagram Raw Data API allows you to get public data anonymously from Instagram.

Access to this API is restricted. To get access to this API contact our support at hello@modash.io.

Our RAW API subscriptions come with a monthly limit for requests, every successful request consumes one from the limit. A 404 status code is treated as a successful request, indicating that the requested content could not be found.

Operations

TikTok Raw Data

TikTok Raw Data API allows you to get public data anonymously from Tiktok.

Access to this API is restricted. To get access to this API contact our support at hello@modash.io.

Our RAW API subscriptions come with a monthly limit for requests, every successful request consumes one from the limit. A 404 status code is treated as a successful request, indicating that the requested content could not be found.

Operations

YouTube Raw Data

YouTube Raw Data API allows you to get public data anonymously from YouTube.

Access to this API is restricted. To get access to this API contact our support at hello@modash.io.

Our RAW API subscriptions come with a monthly limit for requests, every successful request consumes one from the limit. A 404 status code is treated as a successful request, indicating that the requested content could not be found.

Operations

Channel Info

Request

Returns details about the YouTube channel.

Security
accessToken
Query
urlstringrequired

YouTube url to channel's page, i.e. https://www.youtube.com/@{channelName}

curl -i -X GET \
  'https://api.modash.io/v1/raw/youtube/channel-info?url=string' \
  -H 'Authorization: Bearer <YOUR_token_HERE>'

Responses

Bodyapplication/json
channel_infoobjectrequired
channel_info.​channel_idstringrequired
channel_info.​custom_urlstring
channel_info.​usernamestring
channel_info.​is_removedbooleanrequired
channel_info.​is_hiddenbooleanrequired
channel_info.​is_verifiedbooleanrequired
channel_info.​fullnamestringrequired
channel_info.​picturestring
channel_info.​descriptionstring
channel_info.​countrystring
channel_info.​followersnumber
channel_info.​joined_atstring
channel_info.​has_joinboolean
channel_info.​total_viewsnumber
channel_info.​linksArray of strings
channel_info.​handlestring
successbooleanrequired
Response
application/json
{
  "channel_info": {
    "channel_id": "string",
    "custom_url": "string",
    "username": "string",
    "is_removed": true,
    "is_hidden": true,
    "is_verified": true,
    "fullname": "string",
    "picture": "string",
    "description": "string",
    "country": "string",
    "followers": 0,
    "joined_at": "string",
    "has_join": true,
    "total_views": 0,
    "links": [ … ],
    "handle": "string"
  },
  "success": true
}

Uploaded Videos

Request

Returns a list of 30 uploaded YouTube videos to the channel with a limited list of details.

Security
accessToken
Query
urlstringrequired

YouTube url to channel's page, i.e. https://www.youtube.com/@{channelName}

sorted_bystring

Sorted by a passed parameter: "dd" by Date in descending order (default) or "p" by Popularity

afterstring

Use cursor from the last page to get the next page

curl -i -X GET \
  'https://api.modash.io/v1/raw/youtube/uploaded-videos?url=string&sorted_by=string&after=string' \
  -H 'Authorization: Bearer <YOUR_token_HERE>'

Responses

Bodyapplication/json
videos_listobjectrequired
videos_list.​totalnumberrequired
videos_list.​videosArray of objectsrequired
videos_list.​videos[].​video_idstringrequired
videos_list.​videos[].​thumbnailstringrequired
videos_list.​videos[].​titlestringrequired
videos_list.​videos[].​timestringrequired
videos_list.​videos[].​published_agostring
videos_list.​videos[].​viewsnumber
videos_list.​cursorstringrequired
successbooleanrequired
Response
application/json
{
  "videos_list": {
    "total": 0,
    "videos": [ … ],
    "cursor": "string"
  },
  "success": true
}

Uploaded Shorts

Request

Returns a list of 30 uploaded YouTube shorts to the channel with a limited list of details.

Security
accessToken
Query
urlstringrequired

YouTube url to channel's page, i.e. https://www.youtube.com/@{channelName}

sorted_bystring

Sorted by a passed parameter: "dd" by Date in descending order (default) or "p" by Popularity

afterstring

Use cursor from the last page to get the next page

curl -i -X GET \
  'https://api.modash.io/v1/raw/youtube/uploaded-shorts?url=string&sorted_by=string&after=string' \
  -H 'Authorization: Bearer <YOUR_token_HERE>'

Responses

Bodyapplication/json
shorts_listobjectrequired
shorts_list.​shortsArray of objectsrequired
shorts_list.​shorts[].​short_idstringrequired
shorts_list.​shorts[].​thumbnailstringrequired
shorts_list.​shorts[].​titlestringrequired
shorts_list.​shorts[].​viewsnumber
shorts_list.​cursorstringrequired
successbooleanrequired
Response
application/json
{
  "shorts_list": {
    "shorts": [ … ],
    "cursor": "string"
  },
  "success": true
}

Uploaded Lives

Request

Returns a list of 30 uploaded YouTube lives to the channel with a limited list of details.

Security
accessToken
Query
urlstringrequired

YouTube url to channel's page, i.e. https://www.youtube.com/@{channelName}

sorted_bystring

Sorted by a passed parameter: "dd" by Date in descending order (default) or "p" by Popularity

afterstring

Use cursor from the last page to get the next page

curl -i -X GET \
  'https://api.modash.io/v1/raw/youtube/uploaded-lives?url=string&sorted_by=string&after=string' \
  -H 'Authorization: Bearer <YOUR_token_HERE>'

Responses

Bodyapplication/json
lives_listobjectrequired
lives_list.​livesArray of objectsrequired
lives_list.​lives[].​live_idstringrequired
lives_list.​lives[].​thumbnailstringrequired
lives_list.​lives[].​titlestringrequired
lives_list.​lives[].​timestringrequired
lives_list.​lives[].​published_agostring
lives_list.​lives[].​viewsnumber
lives_list.​cursorstringrequired
successbooleanrequired
Response
application/json
{
  "lives_list": {
    "lives": [ … ],
    "cursor": "string"
  },
  "success": true
}

Playlist Videos

Request

Returns a list of 100 videos from a YouTube playlist.

Security
accessToken
Query
urlstringrequired

YouTube url to playlist's page, i.e. https://www.youtube.com/playlist?list={playlistId}

afterstring

Use cursor from the last page to get the next page

curl -i -X GET \
  'https://api.modash.io/v1/raw/youtube/playlist-videos?url=string&after=string' \
  -H 'Authorization: Bearer <YOUR_token_HERE>'

Responses

Bodyapplication/json
videos_listobjectrequired
videos_list.​totalnumberrequired
videos_list.​videosArray of objectsrequired
videos_list.​videos[].​video_idstringrequired
videos_list.​videos[].​thumbnailstringrequired
videos_list.​videos[].​titlestringrequired
videos_list.​videos[].​timestringrequired
videos_list.​videos[].​published_agostring
videos_list.​videos[].​viewsnumber
videos_list.​cursorstringrequired
successbooleanrequired
Response
application/json
{
  "videos_list": {
    "total": 0,
    "videos": [ … ],
    "cursor": "string"
  },
  "success": true
}

Video Info

Request

Returns a YouTube video or live information.

Security
accessToken
Query
urlstringrequired

YouTube video page url i.e. https://www.youtube.com/watch?v={videoId}

curl -i -X GET \
  'https://api.modash.io/v1/raw/youtube/video-info?url=string' \
  -H 'Authorization: Bearer <YOUR_token_HERE>'

Responses

Bodyapplication/json
video_infoobjectrequired
video_info.​video_idstringrequired
video_info.​channel_idstringrequired
video_info.​titlestringrequired
video_info.​published_atstringrequired
video_info.​durationstring or numberrequired
Any of:
string
video_info.​viewsnumber
video_info.​likesnumber
video_info.​dislikesnumber
video_info.​commentsnumberrequired
video_info.​genrestringrequired
video_info.​thumbnailstringrequired
video_info.​descriptionstringrequired
video_info.​keywordsArray of stringsrequired
video_info.​subtitlesArray of objects
video_info.​comments_tabsArray of objects
video_info.​includes_paid_promotionboolean
successbooleanrequired
Response
application/json
{
  "video_info": {
    "video_id": "string",
    "channel_id": "string",
    "title": "string",
    "published_at": "string",
    "duration": "string",
    "views": 0,
    "likes": 0,
    "dislikes": 0,
    "comments": 0,
    "genre": "string",
    "thumbnail": "string",
    "description": "string",
    "keywords": [ … ],
    "subtitles": [ … ],
    "comments_tabs": [ … ],
    "includes_paid_promotion": true
  },
  "success": true
}

Video Subtitles

Request

Returns a YouTube video subtitles.

Security
accessToken
Query
urlstringrequired

YouTube video page url i.e. https://www.youtube.com/watch?v={videoId}

curl -i -X GET \
  'https://api.modash.io/v1/raw/youtube/video-subtitles?url=string' \
  -H 'Authorization: Bearer <YOUR_token_HERE>'

Responses

Bodyapplication/jsonArray [
vss_idstringrequired
language_codestringrequired
namestringrequired
fetch_urlstringrequired
]
Response
application/json
[
  {
    "vss_id": "string",
    "language_code": "string",
    "name": "string",
    "fetch_url": "string"
  }
]

Short Info

Request

Returns a YouTube short information.

Security
accessToken
Query
urlstringrequired

YouTube short page url i.e. https://www.youtube.com/shorts/{shortId}

curl -i -X GET \
  'https://api.modash.io/v1/raw/youtube/short-info?url=string' \
  -H 'Authorization: Bearer <YOUR_token_HERE>'

Responses

Bodyapplication/json
short_infoobjectrequired
short_info.​short_idstringrequired
short_info.​channel_idstringrequired
short_info.​titlestringrequired
short_info.​published_atstringrequired
short_info.​durationstring or numberrequired
Any of:
string
short_info.​viewsnumber
short_info.​likesnumber
short_info.​dislikesnumber
short_info.​commentsnumberrequired
short_info.​genrestringrequired
short_info.​thumbnailstringrequired
short_info.​descriptionstringrequired
short_info.​subtitlesArray of objects
short_info.​keywordsArray of stringsrequired
short_info.​includes_paid_promotionbooleanrequired
successbooleanrequired
Response
application/json
{
  "short_info": {
    "short_id": "string",
    "channel_id": "string",
    "title": "string",
    "published_at": "string",
    "duration": "string",
    "views": 0,
    "likes": 0,
    "dislikes": 0,
    "comments": 0,
    "genre": "string",
    "thumbnail": "string",
    "description": "string",
    "subtitles": [ … ],
    "keywords": [ … ],
    "includes_paid_promotion": true
  },
  "success": true
}

Video Comments

Request

Returns a list of 20 YouTube video or live comments. To obtain the first comments page use cursor from Video Info endpoint.

Security
accessToken
Query
urlstringrequired

YouTube video page url i.e. https://www.youtube.com/watch?v={videoId}

afterstringrequired

Use cursor from the last page to get the next page

curl -i -X GET \
  'https://api.modash.io/v1/raw/youtube/video-comments?url=string&after=string' \
  -H 'Authorization: Bearer <YOUR_token_HERE>'

Responses

Bodyapplication/json
comments_listobjectrequired
comments_list.​commentsArray of objectsrequired
comments_list.​comments[].​comment_idstringrequired
comments_list.​comments[].​author_channel_idstringrequired
comments_list.​comments[].​author_namestringrequired
comments_list.​comments[].​author_picturestringrequired
comments_list.​comments[].​published_atstringrequired
comments_list.​comments[].​author_is_channel_ownerbooleanrequired
comments_list.​comments[].​likesnumberrequired
comments_list.​comments[].​liked_by_creatorboolean
comments_list.​comments[].​textstringrequired
comments_list.​comments[].​reply_countnumber
comments_list.​comments[].​replies_cursorstring
comments_list.​cursorstringrequired
successbooleanrequired
Response
application/json
{
  "comments_list": {
    "comments": [ … ],
    "cursor": "string"
  },
  "success": true
}

Video Comment Replies

Request

Returns a list of 20 YouTube video or live comment replies. To obtain the first replies page use replies_cursor from Video Comments endpoint.

Security
accessToken
Query
urlstringrequired

YouTube video page url i.e. https://www.youtube.com/watch?v={videoId}

afterstringrequired

Use cursor from the last page to get the next page

curl -i -X GET \
  'https://api.modash.io/v1/raw/youtube/video-comment-replies?url=string&after=string' \
  -H 'Authorization: Bearer <YOUR_token_HERE>'

Responses

Bodyapplication/json
replies_listobjectrequired
replies_list.​commentsArray of objectsrequired
replies_list.​comments[].​comment_idstringrequired
replies_list.​comments[].​author_channel_idstringrequired
replies_list.​comments[].​author_namestringrequired
replies_list.​comments[].​author_picturestringrequired
replies_list.​comments[].​published_atstringrequired
replies_list.​comments[].​author_is_channel_ownerbooleanrequired
replies_list.​comments[].​likesnumberrequired
replies_list.​comments[].​liked_by_creatorboolean
replies_list.​comments[].​textstringrequired
replies_list.​comments[].​reply_countnumber
replies_list.​comments[].​replies_cursorstring
replies_list.​cursorstringrequired
successbooleanrequired
Response
application/json
{
  "replies_list": {
    "comments": [ … ],
    "cursor": "string"
  },
  "success": true
}

User Account

API for Modash user account management

Operations