문서 둘러보기
API 참조
YouTube 비디오 메타 데이터 API
YouTube 비디오 ID에 의해 비디오 메타 데이터를 검색, 채널 세부 사항, 참여 수, 엄지나일, 사용 가능한 형식 및 챕터를 포함하여.
요청 구성
11-character ID 비디오에서 URL, 전체 URL.
https://data.flashdata.dev/v1/queries/realtime제품 설명
제품 정보 source 으로 video_id 최고 수준에서. Source 옵션은 params. 선택적인 분야는 omitted 일 수 있습니다.
요청 본문
sourcestring / 필수- youtube_metadata로 설정.
video_idstring / 필수- 11-character YouTube 비디오 ID, FUfGcZ092b0와 같은. 문자, 숫자, 밑줄 및 하이픈을 허용한다.정확히 11 이름 *기본 정보:
설정하기수용된 체재
^[A-Za-z0-9_-]{11}$ paramsobject / 선택 사항- 이 요구를 위한 Settings.기본 정보:
{} callback_urlstring · nullable / 선택 사항- Async 및 배치만. 공공 HTTPS 완료 URL 포트에 443, 최대 2,048 문자. 사용자 자격 또는 URL 파편이 없습니다. Omit, null 또는 알림이 없는 빈 문자열을 사용하십시오. 일괄 처리에서, 각 쿼리에 설정, 외부 params.기본 정보:
설정하기
응답 옵션
params.include_formatsboolean / 선택 사항- 사용 가능한 미디어 형식과 그들의 코덱, 해상도 및 비트레이트 정보를 포함.
true또는false기본 정보:true params.include_chaptersboolean / 선택 사항- 동영상이있을 때 챕터를 포함.
true또는false기본 정보:true
응답
Realtime 반환 status: done. 소스 출력을 읽으십시오 results[0]; usage.credits 책임의 기록.
한 비디오의 메타 데이터에는 videoId, 제목, 채널 세부 사항, 기간 및 참여 수가 포함됩니다.
결과보기
response.json로 성공적인 JSON 응답을 저장하십시오. read-response.py로 저장하고 python read-response.py를 실행하십시오. Python의 표준 라이브러리를 사용하고 새로운 요청을 만들 수 있습니다.
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 = {name: result.get(name) for name in (
"videoId", "title", "channel", "duration", "hasTranscripts", "transcriptLanguages"
)}
print(json.dumps(output, ensure_ascii=False, indent=2))true에 대한 응답 옵션 모두 기본적으로 모두 호환됩니다. 더 작은 응답을 위해 include_formats를 비활성화하면 metadata만 필요로 합니다. 요청할 때만 장이 나타났습니다. 사용 가능한 수치는 null일 수 있습니다.
formats 사용할 수 있는 인코딩을 설명 합니다. 그것은 비디오를 다운로드 하지 않습니다. hasTranscripts 으로 transcriptLanguages transcript 텍스트가 아닌 가용성을 설명합니다. 사용 방법 다운로드 API 미디어 및 Transcript의 API 본문내용
모든 응답 분야
| - 연혁 | 의 특징 |
|---|---|
sourcestring | 요청된 API 소스. |
statusstring | 실시간 요청이 성공할 때 완료됩니다. |
created_atstring | ISO 8601 형식의 응답 생성 시간. |
usage.creditsnumber | 요청시 크레딧이 청구되며, 플랜을 기준으로 합니다. |
results[0].videoIdstring | YouTube 비디오 ID. |
results[0].titlestring | 비디오 제목. |
results[0].descriptionstring | 가득 차있는 영상 묘사. |
results[0].channelstring | 채널 이름. |
results[0].channelIdstring | 채널 ID. |
results[0].channelUrlstring | 채널 URL. |
results[0].channelSubscriberCountnumber · nullable | 채널 가입자 수. |
results[0].viewCountnumber · nullable | 보기 수. |
results[0].likeCountnumber · nullable | 숫자처럼. |
results[0].commentCountnumber · nullable | 댓글 개수. |
results[0].uploadDatestring · nullable | 관련 기사 |
results[0].durationnumber · nullable | 몇 초 안에 비디오 지속. |
results[0].durationStringstring · nullable | 사용 가능한 기간을 지정했습니다. |
results[0].thumbnailsarray | Thumbnail URLs 및 치수. |
results[0].categoriesarray | 비디오 카테고리. |
results[0].tagsarray | 동영상 태그. |
results[0].ageLimitinteger | 제한, 또는 0를 제한할 경우. |
results[0].isLiveboolean | 비디오가 현재 살고 있는지 여부. |
results[0].wasLiveboolean | 비디오가 라이브 스트림인지 여부. |
results[0].hasTranscriptsboolean | 캡션이 사용할 수 있는지 여부. |
results[0].transcriptLanguagesarray | 사용 가능한 캡션 언어 코드. |
results[0].formatsarray · optional | include_formats가 true일 때 사용 가능한 미디어 형식. |
results[0].chaptersarray · optional | 장 제목, start_time 및 end_time 초, 요청 및 사용할 때. |
위의 필드는 기본 JSON 응답을 설명합니다. JSON, 일반 텍스트 및 Markdown 형식.
Async는 1개의 일 영수증을 돌려보냅니다; 배치는 당 1개를 돌려보냅니다 비디오 ID. 각 업무의 상태를 확인하고 반환된 링크를 사용하여 결과를 검색하십시오.
Async 및 배치 수명주기
제출은 영수증을 반환, 결과가 아닙니다. Async는 한 일을 만듭니다; 배치는 분리된 일을 안으로 돌려보냅니다 queries[] 모든 허용된 쿼리에 대 한. 각 직무를 독립적으로 추적하고 검색합니다.
제출하기 data.flashdata.dev; 작업 상태 및 결과 읽기 api.flashdata.dev 동일한 X-API-Key로. API 기본 예제는 Python 및 cURL를 사용합니다.
1. 작업 IDs 저장
Async로 전환 할 때이 소스 요청 필드를 유지하십시오. Batch의 경우, JSON 객체의 쿼리 배열 내부에 각 요청을 넣어. 모든 반환 작업 ID 저장.
2. 본문 바로가기
GET https://api.flashdata.dev/v2/jobs/{jobId}pending/processing: 지연 및 존경을 가진 오염Retry-After현재 위치completed: fetch 결과.failed: 검사job.error.job.status를 읽으십시오, 제출 영수증의 상태는 아닙니다.
일 상태 API 참고3. Fetch 결과
GET https://api.flashdata.dev/v2/jobs/{jobId}/results완료 후 결과를 확인한 다음 302 저장 URL 키를 사용하지 않고 API 저장을 읽습니다. 24 시간 내에 JSON를 저장하십시오.
결과 다운로드 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_metadata",
"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[].methodstring | GET. |
Bulk 파일 처리
라인 당 하나의 비디오 ID를 업로드하고 소스와 Bulk 작업을 만듭니다.: youtube_metadata. 공유 옵션은 모든 ID 파일에 적용됩니다.
근원 선택권: include_formats, include_chapters. Bulk 작업을 만들 때 옵션에 넣어.
NDJSON 결과 부품으로 완성된 컬렉션을 검색합니다. 데이터 소스는 Bulk 작업을 만들 때 options.result_storage를 설정하여 클라우드 스토리지에 결과를 제공 할 수 있습니다. Bulk 작업 전체가 완료된 후 24 시간 내에 나타날과 부품을 저장하십시오.
오류 복구
11-character 비디오 ID, 전체 YouTube URL를 공급하십시오. 유효한 ID는 영상을 보장하지 않습니다 접근할 수 없습니다: 제거, 개인 또는 제한한 영상은 가공 도중 실패할 수 있습니다. 계산은 null가 될 수 있습니다. 부당한 장 또는 형식은 자체 작업 실패가 아닙니다.
인증, 균형, 요청 정보 및 속도 제한 실패를 위해, 공유 오류 참조를 사용합니다. 제출 시간표는 여전히 일자리를 만들 수 있습니다; 재발하기 전에 기존 작업을 확인하십시오.
단계별 가이드: 검색 및 사용 비디오 metadata
요금
| 계획하기 | 사용법 비율표준 요청 1,000회당 | 이름 * | 청구 기간 당 크레딧 포함 |
|---|---|---|---|
| 사용량 기반 결제 | US$0.50 | 월 이용료 없음 | 필요할 때 충전 |
| Micro | US$0.40 | US$49.00 / 월별 월별 | 1,000 크레딧 (US$50.00의 API 사용) 포함 |
| Starter | US$0.35 | US$199.00 / 월별 월별 | 4,000 크레딧 (US$200.00의 API 사용) 포함 |
| Pro | US$0.30 | US$499.00 / 월별 월별 | 10,000 크레딧 (US$500.00의 API 사용) 포함 |
| Scale | US$0.25 | US$999.00 / 월별 월별 | 20,000 크레딧 (US$1,000.00의 API 사용) 포함 |
| Business | US$0.20 | US$1,999.00 / 월별 월별 | 40,000 크레딧 (US$2,000.00의 API 사용) 포함 |
계정당 하나의 요금제. 세 제품이 크레딧을 공유합니다. 포함된 크레딧으로 처리한 사용량에는 다시 과금하지 않습니다.
현재 가격 및 계획 제한