YouTube Posts

Get a channel's community Posts tab - post text, polls, multi-image posts, like counts, published dates, and the author's verified badge. Deep-paginates over a days window. Accepts @handle or UC... channel ID.

Execution model

Live request

Runtime depends on endpoint, target, pagination, rendering mode, and active plan limits.

Credit weight

Live catalog

Current weights are managed from the Data API Weights admin table and shown on pricing before use.

Parameters

Name	Type	Requirement	Description
identifier	string	Required	Channel ID (UC...), @handle, or username. 1-100 characters.
limit	number	Optional	Maximum posts to return (1-1000).
days	number	Optional	Optional deep date window (1-365 days); follows continuation tokens back this far.
cursor	string	Optional	Opaque cursor from the previous response.
max_pages	number	Optional	Maximum provider pages to scan (1-50).
country	string	Optional	YouTube country/region code (maps to gl).
language	string	Optional	YouTube result language.

Request and response

curl -X POST "https://api.datablue.dev/v1/data/youtube/posts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "identifier": "@mkbhd",
  "limit": 5,
  "days": 90,
  "country": "us",
  "language": "en"
}'

Example response

{
  "success": true,
  "time_taken": 2.64,
  "channel": "MKBHD",
  "channel_id": "UCBJycsmduvYEL83R_U4JriQ",
  "days": 90,
  "reached_days_ago": 21,
  "count": 3,
  "complete": false,
  "stop_reason": "limit_reached",
  "pages_fetched": 1,
  "next_cursor": "dbyt1.eyJraW5kIjoicG9zdHMifQ.signature",
  "scanned_count": 3,
  "matched_count": 3,
  "duplicate_count": 0,
  "posts": [
    {
      "post_id": "UgkxB7POmB4C7U0I3kIEWRZpYfE2t-ieP9CA",
      "url": "https://www.youtube.com/post/UgkxB7POmB4C7U0I3kIEWRZpYfE2t-ieP9CA",
      "author": "MKBHD",
      "author_verified": true,
      "text": "Some behind-the-scenes photos from the studio this week.",
      "published": "3 days ago",
      "published_days_ago": 3,
      "like_count": 84000,
      "like_count_text": "84K",
      "like_count_status": "rounded",
      "comment_count": null,
      "comment_count_status": "not_exposed",
      "post_type": "multi_image",
      "images": [
        "https://yt3.ggpht.com/post-image-a=s1024",
        "https://yt3.ggpht.com/post-image-b=s1024"
      ]
    },
    {
      "post_id": "Ugkx0pollExamplePostId1234567890",
      "url": "https://www.youtube.com/post/Ugkx0pollExamplePostId1234567890",
      "author": "MKBHD",
      "author_verified": true,
      "text": "Which one should I review next?",
      "published": "1 week ago",
      "published_days_ago": 7,
      "like_count": 32000,
      "like_count_text": "32K",
      "like_count_status": "rounded",
      "comment_count": null,
      "comment_count_status": "not_exposed",
      "post_type": "poll",
      "images": [],
      "poll": {
        "options": [
          "Phone A",
          "Phone B",
          "Phone C"
        ]
      }
    },
    {
      "post_id": "UgkxTextOnlyExamplePostId0987654321",
      "url": "https://www.youtube.com/post/UgkxTextOnlyExamplePostId0987654321",
      "author": "MKBHD",
      "author_verified": true,
      "text": "Thanks for 20M subscribers!",
      "published": "3 weeks ago",
      "published_days_ago": 21,
      "like_count": 210000,
      "like_count_text": "210K",
      "like_count_status": "rounded",
      "comment_count": null,
      "comment_count_status": "not_exposed",
      "post_type": "text",
      "images": []
    }
  ]
}