본문으로 건너뛰기
KO
API 키 받기
문서 둘러보기

API 참조

YouTube Channel API

API 키 받기

YouTube 채널 프로파일을 검색하고 최근의 비디오를 처리하여 가입자 수, 채널 이미지 및 비디오 세부 사항을 포함하여 검색합니다.

요청 구성

@youtube와 같은 채널 핸들을 입력하면 URL가 아닙니다.

POSThttps://data.flashdata.dev/v1/queries/realtime
Python 3 · requests
python3 -m pip install requests
import json

import requests

api_key = "YOUR_API_KEY"
payload = {
    "source": "youtube_channel",
    "handle": "@jawed",
    "params": {
        "video_limit": 10,
    },
}

response = requests.post(
    "https://data.flashdata.dev/v1/queries/realtime",
    headers={"X-API-Key": api_key, "Accept": "application/json"},
    json=payload,
    timeout=120,
)
response.raise_for_status()
print(json.dumps(response.json(), ensure_ascii=False, indent=2))
HTTP 응답 결과X-API-Key 인증

제품 설명

제품 정보 source 으로 handle 최고 수준에서. Source 옵션은 params. 선택적인 분야는 omitted 일 수 있습니다.

요청 본문

sourcestring / 필수
youtube_channel로 설정.
handlestring / 필수
@jawed와 같은 채널 손잡이. @ 접두사는 선택 사항입니다.
1 으로 100 이름 *기본 정보: 설정하기
paramsobject / 선택 사항
이 요구를 위한 Settings.
기본 정보: {}
callback_urlstring · nullable / 선택 사항
Async 및 배치만. 공공 HTTPS 완료 URL 포트에 443, 최대 2,048 문자. 사용자 자격 또는 URL 파편이 없습니다. Omit, null 또는 알림이 없는 빈 문자열을 사용하십시오. 일괄 처리에서, 각 쿼리에 설정, 외부 params.
기본 정보: 설정하기

영상 선택

params.video_limitinteger / 선택 사항
최대 동영상이 포함되어 있습니다. Fewer는 사용할 수 있습니다.
1 으로 100, 전체 번호기본 정보: 20

응답

Realtime 반환 status: done. 소스 출력을 읽으십시오 results[0].videos; usage.credits 책임의 기록.

채널 프로파일은 결과[0]; 그것의 비디오 어레이는 최근 동영상이 포함되어 있습니다. videoCount는 채널을 설명하고 반환된 어레이 길이가 아닙니다.

결과보기

response.json로 성공적인 JSON 응답을 저장하십시오. read-response.py로 저장하고 python read-response.py를 실행하십시오. Python의 표준 라이브러리를 사용하고 새로운 요청을 만들 수 있습니다.

read-response.py
import json
from pathlib import Path

response = json.loads(Path("response.json").read_text(encoding="utf-8-sig"))
if response.get("status") not in ("done", "completed") or not isinstance(response.get("results"), list):
    raise SystemExit("Expected completed result JSON; inspect the response or job status.")
if not response["results"]:
    print("[]")
    raise SystemExit(0)
result = response["results"][0]

output = {
    "channelId": result.get("channelId"),
    "name": result.get("name"),
    "videos": [
        {"videoId": item.get("videoId"), "title": item.get("title")}
        for item in result.get("videos", [])
    ],
}
print(json.dumps(output, ensure_ascii=False, indent=2))

@ 접두사없이 상단 레벨에서 핸들을 보내십시오. video_limit는 params에 속하며 1를 100로 받아들입니다. 20로 기본값입니다. 예시 요청 10.

요청한 제한은 최대이며 보증이 아닙니다. 카운트, 이미지 URLs 및 동영상 세부 사항은 사용할 수 없을 때 null일 수 있습니다.

모든 응답 분야
- 연혁의 특징
sourcestring요청된 API 소스.
statusstring실시간 요청이 성공할 때 완료됩니다.
created_atstringISO 8601 형식의 응답 생성 시간.
usage.creditsnumber요청시 크레딧이 청구되며, 플랜을 기준으로 합니다.
results[0].channelIdstring채널 ID.
results[0].channelHandlestring채널 손잡이.
results[0].namestring채널 이름.
results[0].descriptionstring채널 설명.
results[0].subscriberCountnumber · nullable구독자 수.
results[0].videoCountnumber · nullable총 채널 비디오 카운트.
results[0].viewCountnumber · nullable사용할 때 채널 보기 수.
results[0].avatarUrlstring · nullable채널 아바타 URL.
results[0].bannerUrlstring · nullable채널 배너 URL.
results[0].channelUrlstring채널 페이지 URL.
results[0].videosarray최근 동영상, 최대 video_limit 항목.
results[0].videos[].videoIdstring비디오 ID.
results[0].videos[].titlestring비디오 제목.
results[0].videos[].durationnumber · nullable몇 초 동안 지속됩니다.
results[0].videos[].viewCountnumber · nullable보기 수.
results[0].videos[].uploadDatestring · nullable관련 기사
results[0].videos[].thumbnailstring · nullable비디오 썸네일 URL.

위의 필드는 기본 JSON 응답을 설명합니다. JSON, 일반 텍스트 및 Markdown 형식.

Async는 1개의 일 영수증을 돌려보냅니다; 배치는 당 1개를 돌려보냅니다 채널 핸들. 각 업무의 상태를 확인하고 반환된 링크를 사용하여 결과를 검색하십시오.

Async 및 배치 수명주기

제출은 영수증을 반환, 결과가 아닙니다. Async는 한 일을 만듭니다; 배치는 분리된 일을 안으로 돌려보냅니다 queries[] 모든 허용된 쿼리에 대 한. 각 직무를 독립적으로 추적하고 검색합니다.

제출하기 data.flashdata.dev; 작업 상태 및 결과 읽기 api.flashdata.dev 동일한 X-API-Key로. API 기본 예제는 Python 및 cURL를 사용합니다.

  1. 1. 작업 IDs 저장

    Async로 전환 할 때이 소스 요청 필드를 유지하십시오. Batch의 경우, JSON 객체의 쿼리 배열 내부에 각 요청을 넣어. 모든 반환 작업 ID 저장.

    Async 요청 및 영수증 · Batch 요구 몸

  2. 2. 본문 바로가기

    GET https://api.flashdata.dev/v2/jobs/{jobId}

    pending / processing: 지연 및 존경을 가진 오염 Retry-After 현재 위치 completed: fetch 결과. failed: 검사 job.error.

    job.status를 읽으십시오, 제출 영수증의 상태는 아닙니다.

    상태 확인 · Python 및 cURL

    일 상태 API 참고
  3. 3. Fetch 결과

    GET https://api.flashdata.dev/v2/jobs/{jobId}/results

    완료 후 결과를 확인한 다음 302 저장 URL 키를 사용하지 않고 API 저장을 읽습니다. 24 시간 내에 JSON를 저장하십시오.

    흠집 결과 · Python 및 cURL · 응답 형식

    결과 다운로드 API 참조

오염 및 기존 결과를 fetching하는 것은 쿼리 크레딧을 사용하지 않습니다. 퇴직시간은 업무 취소를 하지 않습니다. ID 대신 중복 청구 가능한 작업을 제출합니다. 오류 코드 및 재시동 행동.

완료 웹훅

자주 묻는 질문

설치하기 callback_url async 요청의 최고 수준에서, 또는 각 질의 안 배치에서, 밖에 params. 별도의 webhook-registration 요청이 필요하지 않습니다. Realtime 요청은 콜백을 보내지 않습니다.

포트 443에 공공 HTTPS URL를 사용하십시오. FlashData POSTs 각 작업에 대한 알림 completed 또는 failed; 이벤트 포함 링크, 그 결과 자체.

Acknowledge 및 검증

을 읽다 2xx 이벤트를 수락 한 후. 으로 Deduplicate delivery_id, 또한 보내진 것과 같이 X-Delivery-Id. Redirects는 다음과 같습니다.

실패한 납품은 exponential backoff, 까지 재기합니다 8는 총 시도 가장 많이 완료 후 24 시간. 추락으로 오염을 지키십시오.

Callbacks는 할당되지 않습니다. ID, 소스 및 터미널 상태를 확인 인증된 상태 endpoint 알림을 처리하기 전에. 납품 ID는 deduplication를 위해, 정정성의 증거 아닙니다.

webhook 이벤트 및 필드 보기
일러스트레이션 완료 알림
{
  "delivery_id": "completion:job_example0001",
  "id": "job_example0001",
  "source": "youtube_channel",
  "status": "completed",
  "links": [
    {
      "rel": "self",
      "href": "https://api.flashdata.dev/v2/jobs/job_example0001",
      "method": "GET"
    },
    {
      "rel": "results",
      "href": "https://api.flashdata.dev/v2/jobs/job_example0001/results",
      "method": "GET"
    }
  ]
}
- 연혁의 특징
delivery_idstring안정적인 납품 식별자. 이 값을 사용하여 알림을 삭제; 또한 X-Delivery-Id 헤더에 보내집니다.
idstring작업 ID.
sourcestring요청된 데이터 소스.
statusstring완료 또는 실패.
linksarray상태 및 결과 링크. 알림은 결과 내용이나 API 키가 포함되지 않습니다.
links[].relstring자기 또는 결과.
links[].hrefstring절대 관리 API URL; 당신의 API 열쇠로 정정.
links[].methodstringGET.

웹훅 계약 및 URL 제한

오류 복구

채널 핸들을 사용하여 비디오 ID 또는 전체 채널 URL. 핸들이 입력 유효성을 전달할 때 제거되거나 접근 가능한 채널이 실패할 수 있습니다. 이미지 또는 수를 놓는 것은 스스로 실패를 의미하지 않습니다.

인증, 균형, 요청 정보 및 속도 제한 실패를 위해, 공유 오류 참조를 사용합니다. 제출 시간표는 여전히 일자리를 만들 수 있습니다; 재발하기 전에 기존 작업을 확인하십시오.

오류와 상태 코드 · 재발행 · 비율 제한

단계별 가이드: 채널 및 최근 동영상 작업

요금

계획하기사용법 비율표준 요청 1,000회당이름 *청구 기간 당 크레딧 포함
사용량 기반 결제US$0.50월 이용료 없음필요할 때 충전
MicroUS$0.40US$49.00 / 월별 월별1,000 크레딧 (US$50.00의 API 사용) 포함
StarterUS$0.35US$199.00 / 월별 월별4,000 크레딧 (US$200.00의 API 사용) 포함
ProUS$0.30US$499.00 / 월별 월별10,000 크레딧 (US$500.00의 API 사용) 포함
ScaleUS$0.25US$999.00 / 월별 월별20,000 크레딧 (US$1,000.00의 API 사용) 포함
BusinessUS$0.20US$1,999.00 / 월별 월별40,000 크레딧 (US$2,000.00의 API 사용) 포함

계정당 하나의 요금제. 세 제품이 크레딧을 공유합니다. 포함된 크레딧으로 처리한 사용량에는 다시 과금하지 않습니다.

현재 가격 및 계획 제한