Complete profile

A channel, its recent uploads, and the comments and replies under each of them, assembled into one document. Use `limit` for how many videos.

POST /api/public/v1/scrape/youtube/complete_profile

Returns complete_profile

Parameters#

handle string required

Channel handle, with or without the @.

Example: NASA

limit integer optional

How many results you want. The run is sized from it, and you are billed for exactly that many.

This endpoint errs towards returning more rather than less, so expect a few extra rows alongside what you asked for. Everything still comes back typed and parsed the same way.

curl -X POST https://socialholmes.com/api/public/v1/scrape/youtube/complete_profile \
  -H "Authorization: Bearer $SOCIALHOLMES_KEY" \
  -H "Content-Type: application/json" \
  -d '{"parameters": {"handle": "NASA"}, "limit": 25}'

import os
import requests

run = requests.post(
    "https://socialholmes.com/api/public/v1/scrape/youtube/complete_profile",
    headers={"Authorization": f"Bearer {os.environ['SOCIALHOLMES_KEY']}"},
    json={"parameters": {"handle": "NASA"}, "limit": 25},
).json()

print(run["id"], run["status"])

const response = await fetch("https://socialholmes.com/api/public/v1/scrape/youtube/complete_profile", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SOCIALHOLMES_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ parameters: { handle: "NASA" }, limit: 25 }),
})

const run = await response.json()
console.log(run.id, run.status)

require "net/http"
require "json"

response = Net::HTTP.post(
  URI("https://socialholmes.com/api/public/v1/scrape/youtube/complete_profile"),
  { parameters: { handle: "NASA" }, limit: 25 }.to_json,
  "Authorization" => "Bearer #{ENV.fetch('SOCIALHOLMES_KEY')}",
  "Content-Type" => "application/json"
)

run = JSON.parse(response.body)
puts run["id"], run["status"]

<?php

$ch = curl_init("https://socialholmes.com/api/public/v1/scrape/youtube/complete_profile");

curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer " . getenv("SOCIALHOLMES_KEY"),
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => json_encode(["parameters" => ["handle" => "NASA"], "limit" => 25]),
]);

$run = json_decode(curl_exec($ch), true);

echo $run["id"], " ", $run["status"];

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"net/http"
	"os"
)

func main() {
	body, _ := json.Marshal(map[string]any{
		"parameters": map[string]string{"handle": "NASA"},
		"limit":      25,
	})

	req, _ := http.NewRequest("POST", "https://socialholmes.com/api/public/v1/scrape/youtube/complete_profile", bytes.NewReader(body))
	req.Header.Set("Authorization", "Bearer "+os.Getenv("SOCIALHOLMES_KEY"))
	req.Header.Set("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()

	var run map[string]any
	json.NewDecoder(res.Body).Decode(&run)

	fmt.Println(run["id"], run["status"])
}

202 Accepted

{
  "id": "8f14e45f-ceea-467a-9c2e-1b0f5a4c7d21",
  "status": "queued",
  "platform": "youtube",
  "endpoint": "complete_profile",
  "target": "NASA",
  "url": "https://www.youtube.com/@NASA",
  "result_count": 0,
  "created_at": "2026-08-28T16:20:48Z"
}

example

{
  "run": {
    "id": "8f14e45f-ceea-467a-9c2e-1b0f5a4c7d21",
    "status": "succeeded",
    "platform": "youtube",
    "endpoint": "complete_profile",
    "target": "NASA",
    "url": "https://www.youtube.com/@NASA",
    "result_count": 7,
    "requested": 2,
    "estimated_cost": 3015,
    "captures": 0,
    "created_at": "2026-08-22T07:44:03Z",
    "started_at": "2026-08-22T07:45:03Z",
    "finished_at": "2026-08-22T09:14:03Z"
  },
  "unit": "result",
  "profile": {
    "id": "UCLA_DiR1FfKNvjuUpBHmylQ",
    "username": "@NASA",
    "url": "https://www.youtube.com/channel/UCLA_DiR1FfKNvjuUpBHmylQ",
    "full_name": "NASA",
    "biography": "NASA's mission is to explore the unknown in air and space.",
    "keywords": "nasa space science",
    "avatar_url": "https://youtube.example/img/nasa_900.jpg"
  },
  "posts": [
    {
      "id": "dQw4w9WgXcQ",
      "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
      "title": "Artemis II Crew Rollout — Full Replay",
      "description_snippet": "Watch the Artemis II stack roll out to Launch Complex 39B.",
      "duration": "1:42:07",
      "duration_seconds": 6127,
      "published_text": "5 days ago",
      "view_count_text": "1.2M views",
      "view_count": 1204118,
      "thumbnail_url": "https://youtube.example/vi/dQw4w9WgXcQ/hq720.jpg",
      "author": {
        "id": "UCLA_DiR1FfKNvjuUpBHmylQ",
        "name": "NASA",
        "url": "https://www.youtube.com/channel/UCLA_DiR1FfKNvjuUpBHmylQ",
        "is_verified": true
      },
      "comments": [
        {
          "id": "UgxKREWxIgDrw8w2e94AaABAg",
          "text": "The scale of the crawler-transporter never lands until you see a person next to it.",
          "published_text": "4 days ago",
          "is_reply": false,
          "like_count_text": "8.8K",
          "reply_count_text": "46",
          "author": {
            "name": "@orbitalmech",
            "channel_id": "UC9x8y7z6w5v4u3t2s1r0q",
            "is_verified": false,
            "avatar_url": "https://youtube.example/img/orbitalmech.jpg"
          },
          "replies": [
            {
              "id": "UgxKREWxIgDrw8w2e94AaABAg.9x8y7z6w5v4",
              "text": "Agreed — the wheels alone are taller than I am.",
              "published_text": "4 days ago",
              "parent_id": "UgxKREWxIgDrw8w2e94AaABAg",
              "is_reply": true,
              "like_count_text": "412",
              "author": {
                "name": "@padcam",
                "channel_id": "UC1a2b3c4d5e6f7g8h9i0j",
                "is_verified": false,
                "avatar_url": "https://youtube.example/img/padcam.jpg"
              }
            }
          ]
        }
      ]
    },
    {
      "id": "C8xYabcDEF1",
      "url": "https://www.youtube.com/watch?v=C8xYabcDEF1",
      "title": "What a Moon Sunrise Actually Looks Like",
      "duration": "8:12",
      "duration_seconds": 492,
      "published_text": "2 weeks ago",
      "view_count_text": "812K views",
      "view_count": 812004,
      "thumbnail_url": "https://youtube.example/vi/C8xYabcDEF1/hq720.jpg",
      "author": {
        "id": "UCLA_DiR1FfKNvjuUpBHmylQ",
        "name": "NASA",
        "url": "https://www.youtube.com/channel/UCLA_DiR1FfKNvjuUpBHmylQ"
      },
      "comments": [
        {
          "id": "UgxKREWxIgDrw8w2e94AaABAg",
          "text": "The scale of the crawler-transporter never lands until you see a person next to it.",
          "published_text": "4 days ago",
          "is_reply": false,
          "like_count_text": "8.8K",
          "reply_count_text": "46",
          "author": {
            "name": "@orbitalmech",
            "channel_id": "UC9x8y7z6w5v4u3t2s1r0q",
            "is_verified": false,
            "avatar_url": "https://youtube.example/img/orbitalmech.jpg"
          },
          "replies": [
            {
              "id": "UgxKREWxIgDrw8w2e94AaABAg.9x8y7z6w5v4",
              "text": "Agreed — the wheels alone are taller than I am.",
              "published_text": "4 days ago",
              "parent_id": "UgxKREWxIgDrw8w2e94AaABAg",
              "is_reply": true,
              "like_count_text": "412",
              "author": {
                "name": "@padcam",
                "channel_id": "UC1a2b3c4d5e6f7g8h9i0j",
                "is_verified": false,
                "avatar_url": "https://youtube.example/img/padcam.jpg"
              }
            }
          ]
        }
      ]
    }
  ],
  "counts": {
    "posts": 2,
    "comments": 2,
    "replies": 2,
    "total": 7
  },
  "stages": {
    "profile": "succeeded",
    "posts": "succeeded",
    "comments": {
      "requested": 2,
      "run": 2,
      "succeeded": 2,
      "empty": 0,
      "failed": 0
    }
  }
}

Try it