YouTube API

SEMUST-API-USER: kullanici_adiniz
SEMUST-API-PASSWORD: sifreniz
Content-Type: application/json
Accept-Language: tr

{
  "type": "search",
  "keyword": "seo nedir",
  "limit": 20
}

{
  "type": "transcript",
  "video_id": "https://www.youtube.com/watch?v=CnQmoQD4xRM",
  "translate_to": "en"
}

curl -X POST https://data.semust.com/v1/youtube \
  -H "SEMUST-API-USER: kullanici_adiniz" \
  -H "SEMUST-API-PASSWORD: sifreniz" \
  -H "Content-Type: application/json" \
  -H "Accept-Language: tr" \
  -d '{"type": "transcript", "video_id": "https://youtu.be/CnQmoQD4xRM"}'

import requests

response = requests.post(
    "https://data.semust.com/v1/youtube",
    headers={
        "SEMUST-API-USER": "kullanici_adiniz",
        "SEMUST-API-PASSWORD": "sifreniz",
        "Accept-Language": "tr",
    },
    json={"type": "search", "keyword": "seo nedir", "limit": 20},
    timeout=120,
)

data = response.json()
if response.status_code != 200:
    raise SystemExit(f"{data['code']}: {data['error']} {data.get('hint', '')}")

for row in data["items"]:
    print(row["position"], row["type"], row["title"], row["views"])

{
  "success": true,
  "type": "search",
  "keyword": "seo nedir",
  "country": "TR",
  "language": "tr",
  "device": "desktop",
  "total": 628065,
  "count": 2,
  "limit": 2,
  "items": [
    {
      "position": 1,
      "type": "video",
      "title": "SEO Nedir? | Webtures",
      "url": "https://www.youtube.com/watch?v=CnQmoQD4xRM",
      "video_id": "CnQmoQD4xRM",
      "channel_name": "Webtures",
      "channel_url": "https://www.youtube.com/@Webturescom",
      "views": 241552,
      "video_count": null,
      "published_at": "2021-11-05T21:17:53Z",
      "duration_seconds": 180,
      "is_live": false
    },
    {
      "position": 2,
      "type": "playlist",
      "title": "SEO Eğitimi Serisi - 2024 - Sıfırdan Uzmanlığa",
      "url": "https://www.youtube.com/playlist?list=PLaqVtetWSaGhlXiU48bDd8511btrbx6T2",
      "video_id": null,
      "channel_name": "Mehmet Ali Yassı",
      "channel_url": "https://www.youtube.com/@maliyassi",
      "views": null,
      "video_count": 20,
      "published_at": null,
      "duration_seconds": null,
      "is_live": null
    }
  ],
  "cost": 0.0022,
  "cached": false,
  "request_id": "0b7e6f1a-3c2d-4e5f-9a8b-1c2d3e4f5a6b"
}

{
  "success": true,
  "type": "video",
  "video_id": "CnQmoQD4xRM",
  "country": "TR",
  "data": {
    "video_id": "CnQmoQD4xRM",
    "title": "SEO Nedir? | Webtures",
    "url": "https://www.youtube.com/watch?v=CnQmoQD4xRM",
    "description": "SEO Nedir? Açılımı “Arama Motoru Optimizasyonu” olan SEO, firmalara ait olan web sitelerin…",
    "channel_name": "Webtures",
    "channel_url": "https://www.youtube.com/channel/UCKSAxJxwfIyHrcgJP12CoSg",
    "channel_subscribers": 2420,
    "views": 241552,
    "likes": 83,
    "comments": 30,
    "published_at": "2021-02-10T20:17:24Z",
    "duration_seconds": 179,
    "category": "Science & Technology",
    "tags": ["seo", "seo nedir", "arama motoru optimizasyonu"],
    "is_live": false,
    "transcripts": [
      { "language": "en-GB", "auto_generated": false },
      { "language": "tr", "auto_generated": false },
      { "language": "tr", "auto_generated": true }
    ]
  },
  "cost": 0.0066,
  "cached": false,
  "request_id": "5d4c3b2a-1f0e-4d9c-8b7a-6f5e4d3c2b1a"
}

{
  "success": true,
  "type": "transcript",
  "video_id": "CnQmoQD4xRM",
  "country": "TR",
  "data": {
    "video_id": "CnQmoQD4xRM",
    "title": "SEO Nedir? | Webtures",
    "language": "tr",
    "translated_to": null,
    "text": "SEO’yu bir yerden duymuş ya da zaten biliyor olabilirsiniz. SEO’nun nasıl çalıştığınız ve ne gibi faydalar sağladığını anlatmaya çalışacağım. …",
    "segments": [
      { "start": 0.603, "end": 3.89, "text": "SEO’yu bir yerden duymuş ya da zaten biliyor olabilirsiniz." },
      { "start": 3.887, "end": 8.24, "text": "SEO’nun nasıl çalıştığınız ve ne gibi faydalar sağladığını anlatmaya çalışacağım." }
    ]
  },
  "cost": 0.0066,
  "cached": false,
  "request_id": "9a8b7c6d-5e4f-4a3b-2c1d-0e9f8a7b6c5d"
}

{
  "success": true,
  "type": "comments",
  "video_id": "CnQmoQD4xRM",
  "country": "TR",
  "total": 30,
  "count": 1,
  "limit": 1,
  "items": [
    {
      "author": "@metehanbas890",
      "author_url": "https://www.youtube.com/@metehanbas890",
      "text": "SEO nedir veya nasıl yapılır. Çok açık bir şekilde anlatmışsınız. Video çok iyi olmuş.",
      "likes": 3,
      "replies": 0,
      "published_at": "2021-11-05T21:18:13Z"
    }
  ],
  "cost": 0.0022,
  "cached": false,
  "request_id": "1e2d3c4b-5a6f-4e7d-8c9b-0a1f2e3d4c5b"
}

{
  "error": "Bu videonun istenen dilde altyazısı yok",
  "code": "TRANSCRIPT_NOT_FOUND",
  "hint": "type=video, videonun hangi dillerde altyazısı olduğunu listeler. Ücret alınmadı",
  "retryable": false,
  "request_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
}

{
  "error": "'limit' parametresi type=video ile kullanılamaz",
  "code": "PARAMETER_NOT_ALLOWED",
  "field": "limit",
  "hint": "Bu parametreyi kabul eden tipler: comments, search",
  "retryable": false
}