Videos list

Read-only YouTube Data API v3 videos list endpoint.

1 credit per successful call Errors are never charged

Request

GET https://socialgraph.dev/api/v1/youtube/videos

Send your API key as Authorization: Bearer YOUR_API_KEY. Parameters go in the query string.

Parameters

Name	Type	Description
`part` required	string	Required. Comma-separated: id, snippet, contentDetails, statistics, status, player, topicDetails, recordingDetails, liveStreamingDetails, localizations or paidProductPlacementDetails. For example: snippet,contentDetails,statistics
`id` optional	string	Comma-separated video IDs, up to 50 (provide id or chart). For example: OYp5j2RihPE
`chart` optional	string	mostPopular: the most popular videos in a region (provide id or chart).
`regionCode` optional	string	Country for chart=mostPopular (ISO 3166-1 alpha-2). For example: US
`videoCategoryId` optional	string	Category for chart=mostPopular. For example: 28
`maxResults` optional	integer	Maximum results per page with chart (1–50). Default 5.
`pageToken` optional	string	Token from a previous response (nextPageToken or prevPageToken).
`hl` optional	string	Language for localized titles and descriptions. For example: es
`maxHeight` optional	integer	Maximum height of the embed player in player.embedHtml (72–8192).
`maxWidth` optional	integer	Maximum width of the embed player in player.embedHtml (72–8192).

Code examples

Example response

{
    "etag": "AOQ6EutPPDfMeLalBR8FG3K-YAY",
    "kind": "youtube#videoListResponse",
    "items": [
        {
            "id": "OYp5j2RihPE",
            "etag": "ZFZKkKIu1Ugsp8Rqi-LE7NGFhzI",
            "kind": "youtube#video",
            "snippet": {
                "tags": [
                    "Google",
                    "developers"
                ],
                "title": "Gemini 4 Argon and Google Antigravity: From 2D concept to 3D cathedral",
                "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
                "localized": {
                    "title": "Gemini 4 Argon and Google Antigravity: From 2D concept to 3D cathedral",
                    "description": "Watch how an autonomous AI agent takes a flat 2D concept image and reconstructs a photorealistic 3D cathedral in Blender from scratch. Tiago Aragona demonstrates how to connect Antigravity directly to Blender via the Model Context Protocol (MCP), leveraging Gemini 4 Argon across 45 iterative agentic loops to deduce complex architectural geometry, detail column fluting, and set up volumetric lighting.\n\n\n🔗Resources:\nGemini 4 Argon Blog → https://goo.gle/4zze7Rg\nAntigravity Website → https://goo.gle/4B3IxMW\n\n\n\nSubscribe to Google for Developers → https://goo.gle/developers    \n\n\n\nSpeakers: Tiago Aragona\nProducts Mentioned: Gemini 4 Argon, Antigravity, Blender, Model Context Protocol (MCP), Flow"
                },
                "categoryId": "28",
                "thumbnails": {
                    "fhd": {
                        "url": "https://i.ytimg.com/vi/OYp5j2RihPE/fhddefault.jpg",
                        "width": 1920,
                        "height": 1080
                    },
                    "high": {
                        "url": "https://i.ytimg.com/vi/OYp5j2RihPE/hqdefault.jpg",
                        "width": 480,
                        "height": 360
                    },
                    "maxres": {
                        "url": "https://i.ytimg.com/vi/OYp5j2RihPE/maxresdefault.jpg",
                        "width": 1280,
                        "height": 720
                    },
                    "medium": {
                        "url": "https://i.ytimg.com/vi/OYp5j2RihPE/mqdefault.jpg",
                        "width": 320,
                        "height": 180
                    },
                    "default": {
                        "url": "https://i.ytimg.com/vi/OYp5j2RihPE/default.jpg",
                        "width": 120,
                        "height": 90
                    },
                    "standard": {
                        "url": "https://i.ytimg.com/vi/OYp5j2RihPE/sddefault.jpg",
                        "width": 640,
                        "height": 480
                    }
                },
                "description": "Watch how an autonomous AI agent takes a flat 2D concept image and reconstructs a photorealistic 3D cathedral in Blender from scratch. Tiago Aragona demonstrates how to connect Antigravity directly to Blender via the Model Context Protocol (MCP), leveraging Gemini 4 Argon across 45 iterative agentic loops to deduce complex architectural geometry, detail column fluting, and set up volumetric lighting.\n\n\n🔗Resources:\nGemini 4 Argon Blog → https://goo.gle/4zze7Rg\nAntigravity Website → https://goo.gle/4B3IxMW\n\n\n\nSubscribe to Google for Developers → https://goo.gle/developers    \n\n\n\nSpeakers: Tiago Aragona\nProducts Mentioned: Gemini 4 Argon, Antigravity, Blender, Model Context Protocol (MCP), Flow",
                "publishedAt": "2026-10-13T19:00:11Z",
                "channelTitle": "Google for Developers",
                "defaultLanguage": "en",
                "defaultAudioLanguage": "en",
                "liveBroadcastContent": "none"
            },
            "statistics": {
                "likeCount": "855",
                "viewCount": "67202",
                "commentCount": "64",
                "favoriteCount": "0"
            },
            "contentDetails": {
                "caption": "true",
                "duration": "PT1M11S",
                "dimension": "2d",
                "definition": "hd",
                "projection": "rectangular",
                "contentRating": {},
                "licensedContent": false
            }
        }
    ],
    "pageInfo": {
        "totalResults": 1,
        "resultsPerPage": 1
    }
}

Errors

Status	Meaning	Charged?
401	Missing, invalid or revoked API key	No
402	Not enough credits (`insufficient_credits`)	No
404	The account or post doesn't exist	No
422	Missing or invalid parameters	No
502 / 503	The data source is temporarily unavailable	No

All error codes →

Try it live: Videos list GET

part

🔒 Preset demo input. Live demos use the Google for Developers channel, youtube.com/@GoogleDevelopers. Sign up free to use your own.

More YouTube endpoints

GET Activities list Read-only YouTube Data API v3 activities list endpoint. /api/v1/youtube/activities 1 credit / call GET Channel sections list Read-only YouTube Data API v3 channelSections list endpoint. /api/v1/youtube/channelSections 1 credit / call GET Channels list Read-only YouTube Data API v3 channels list endpoint. /api/v1/youtube/channels 1 credit / call GET Comment threads list Read-only YouTube Data API v3 commentThreads list endpoint. /api/v1/youtube/commentThreads 1 credit / call GET Comments list Read-only YouTube Data API v3 comments list endpoint. /api/v1/youtube/comments 1 credit / call GET Internationalization languages list Read-only YouTube Data API v3 i18nLanguages list endpoint. /api/v1/youtube/i18nLanguages 1 credit / call