YouTube community post API
YouTube community post: GET /v1/youtube/community-post. 1 credit per request.
GET /v1/youtube/community-post
GET /v1/youtube/community-post
YouTube community post.
- Cost: 1 credit
- Cache: Results are kept up to 30 days; send
max_age_daysto reuse them for free. - Timeout: A request still running after about 25 seconds answers
202with a job to poll (Batch and jobs).
Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
url | URL | yes | Community post URL (/post/Ug... or /channel/.../community?lb=...). Accepted hosts: youtube.com, youtu.be. |
Every request also accepts:
trim:truefor a smaller response withoutnullfields andextra.raw:trueto also get the platform's original object asraw.max_age_days: accept a cached result up to this many days old, for 0 credits (Caching).
Example request#
Set your key in the environment first (see Authentication).
1curl -G "https://api.socialscrape.dev/v1/youtube/community-post" \2 -H "x-api-key: $SOCIALSCRAPE_API_KEY" \3 --data-urlencode "url=https://www.youtube.com/post/Ugkx-7xgRw-Uc9lRS3_2RvS2zASPTZOFtIlw"1import os2import requests34params = {5 "url": "https://www.youtube.com/post/Ugkx-7xgRw-Uc9lRS3_2RvS2zASPTZOFtIlw",6}7res = requests.get(8 "https://api.socialscrape.dev/v1/youtube/community-post",9 headers={"x-api-key": os.environ["SOCIALSCRAPE_API_KEY"]},10 params=params,11)12body = res.json()1314if body["ok"]:15 print(body["data"])16else:17 print(body["error"]["code"], body["error"]["message"])1const url = new URL("https://api.socialscrape.dev/v1/youtube/community-post");2url.search = new URLSearchParams({3 "url": "https://www.youtube.com/post/Ugkx-7xgRw-Uc9lRS3_2RvS2zASPTZOFtIlw"4}).toString();5const res = await fetch(url, {6 headers: { "x-api-key": process.env.SOCIALSCRAPE_API_KEY! },7});8const body = await res.json();910if (body.ok) {11 console.log(body.data);12} else {13 console.error(body.error.code, body.error.message);14}1{2 "nodes": [3 {4 "name": "SocialScrape YouTube community post",5 "type": "n8n-nodes-base.httpRequest",6 "typeVersion": 4.2,7 "position": [8 0,9 010 ],11 "parameters": {12 "method": "GET",13 "url": "https://api.socialscrape.dev/v1/youtube/community-post",14 "sendQuery": true,15 "queryParameters": {16 "parameters": [17 {18 "name": "url",19 "value": "https://www.youtube.com/post/Ugkx-7xgRw-Uc9lRS3_2RvS2zASPTZOFtIlw"20 }21 ]22 },23 "sendHeaders": true,24 "headerParameters": {25 "parameters": [26 {27 "name": "x-api-key",28 "value": "={{ $env.SOCIALSCRAPE_API_KEY }}"29 }30 ]31 }32 }33 }34 ],35 "connections": {}36}Example response#
This is a sample from a recorded response, dash characters in the text are replaced with hyphens. Status 200.
200 OKSample response
1{2 "ok": true,3 "credits_charged": 1,4 "credits_remaining": 4999,5 "cached": false,6 "cached_at": null,7 "request_id": "req_99f96bbbb225f323b8656476",8 "data": {9 "object": "post",10 "platform": "youtube",11 "id": "Ugkx-7xgRw-Uc9lRS3_2RvS2zASPTZOFtIlw",12 "url": "https://www.youtube.com/post/Ugkx-7xgRw-Uc9lRS3_2RvS2zASPTZOFtIlw",13 "type": "community_post",14 "author": {15 "id": "UCLA_DiR1FfKNvjuUpBHmylQ",16 "handle": "NASA",17 "name": "NASA",18 "url": "https://www.youtube.com/@NASA",19 "avatar_url": "https://yt3.googleusercontent.com/eIf5fNPcIcj9ig-wZBeq4stFy1lgjWTW1nLT5dYlFkHZprZ03QBiMcbpwNMB6XSBjrSFGtAGQg=s76-c-k-c0x00ffffff-no-rj-mo",20 "verified": null21 },22 "title": null,23 "text": "Have you heard about MAX POWER? It's our new aerospace festival, and it's landing at NASA's Kennedy Space Center in Florida, Nov. 7-8.\n\nLearn how to join us: https://www.nasa.gov/maxpower\n\nhttps://www.youtube.com/watch?v=wJhhS...",24 "published_at": "2026-09-30T00:00:00Z",25 "duration_seconds": null,26 "language": null,27 "hashtags": null,28 "mentions": null,29 "stats": {30 "views": null,31 "likes": 340,32 "comments": null,33 "shares": null,34 "saves": null,35 "dislikes": null36 },37 "media": {38 "thumbnail_url": "https://i.ytimg.com/vi/wJhhSlplzuE/mqdefault.jpg",39 "video_url": null,40 "audio_url": null,41 "image_urls": null,42 "width": null,43 "height": null44 },45 "song": null,46 "location": null,47 "is_pinned": null,48 "is_sponsored": null,49 "extra": {50 "attachment": {51 "type": "video",52 "video_id": "wJhhSlplzuE",53 "video_title": "MAX POWER 2026 - Official Announcement",54 "video_url": "https://www.youtube.com/watch?v=wJhhSlplzuE"55 },56 "likes_text": "340",57 "links": [58 {59 "text": "https://www.nasa.gov/maxpower",60 "url": "https://www.nasa.gov/maxpower"61 },62 {63 "text": "https://www.youtube.com/watch?v=wJhhS...",64 "url": "https://www.youtube.com/watch?v=wJhhSlplzuE"65 }66 ],67 "published_at_approximate": true,68 "published_text": "1 month ago"69 }70 },71 "cursor": null,72 "has_more": null73}Response#
A Post object in data.
See Data models for every field. The envelope around data is described in Responses.
Errors#
Failures are free: credits_charged is 0. Branch on error.code, never on the message.
| Code | HTTP | Retry | Meaning |
|---|---|---|---|
invalid_params | 400 | no | A parameter is missing, unknown or has the wrong type. |
unsupported_url | 400 | no | The URL is not one this endpoint accepts (wrong platform or form). |
not_found | 404 | no | The platform says this profile, post or item does not exist. |
Every request can also fail with the account and platform errors listed on the Errors page.
Example error:
1{2 "ok": false,3 "error": {4 "code": "not_found",5 "message": "The platform says this profile, post or item does not exist.",6 "retryable": false7 },8 "credits_charged": 0,9 "request_id": "req_4b9178d8d46bc22db70ff740"10}Related endpoints#
- YouTube channel details (
GET /v1/youtube/channel) - YouTube channel videos (
GET /v1/youtube/channel/videos) - Search inside a YouTube channel (
GET /v1/youtube/channel/search) - YouTube channel playlists (
GET /v1/youtube/channel/playlists) - YouTube channel Shorts (
GET /v1/youtube/channel/shorts) - YouTube channel live streams (
GET /v1/youtube/channel/lives) - YouTube channel community posts (
GET /v1/youtube/channel/community-posts) - YouTube video or Short details (
GET /v1/youtube/video)