API Reference
API Media Metadata
API Media Metadata zwraca ustrukturyzowane informacje o publicznym URL mediów (YouTube, Instagram, TikTok, Vimeo, X, Facebook, Twitch, Reddit itd.) bez pobierania pliku.
Ten endpoint jest synchroniczny: metadane są w odpowiedzi HTTP (bez pollingu job_id).
x-api-key:stringwymagane
Twój prywatny klucz HuntAPI.
Endpoint: GET https://api.huntapi.com/v1/media/metadata
Koszt: 1 kredyt za udane wywołanie.
query:stringwymagane
Publiczny URL mediów do sprawdzenia (np. URL YouTube).
Odpowiedź
{
"metadata": {
"id": "3g3Eow41B6I",
"ext": "mp4",
"title": "Faire une interview Multicam avec UNE SEULE caméra",
"width": 640,
"height": 360,
"channel": "Alex Jackson",
"is_live": false,
"duration": 432,
"was_live": false,
"extractor": "Youtube",
"thumbnail": "https://i.ytimg.com/vi/3g3Eow41B6I/maxresdefault.jpg",
"like_count": 4060,
"view_count": 93297,
"channel_url": "https://www.youtube.com/channel/UCW0GdGxlRENND_ft84Cp5vg",
"description": "...",
"live_status": "not_live",
"upload_date": 1712188800,
"webpage_url": "https://www.youtube.com/watch?v=3g3Eow41B6I",
"original_url": "https://www.youtube.com/watch?v=3g3Eow41B6I"
}
}Pola odpowiedzi
| Pole | Typ | Opis |
|---|---|---|
metadata.id | string | Id mediów na platformie |
metadata.title | string | Tytuł |
metadata.description | string | Opis |
metadata.duration | number | Czas trwania w sekundach |
metadata.thumbnail | string | URL miniatury |
metadata.channel | string | Nazwa kanału / uploadera |
metadata.channel_url | string | URL kanału |
metadata.view_count | number | Liczba wyświetleń |
metadata.like_count | number | Liczba polubień |
metadata.width / height | number | Rozdzielczość jeśli dostępna |
metadata.upload_date | number | Znacznik czasu Unix |
metadata.is_live / was_live / live_status | - | Flagi live |
metadata.extractor | string | Extractor źródłowy (np. Youtube) |
metadata.webpage_url | string | Kanoniczny URL strony |
metadata.original_url | string | URL przekazany w query |
Uwagi
Niektórych URL-i nie da się sprawdzić, gdy treść jest:
- Prywatna
- Niedostępna (usunięta lub niedostępna)
- Z ograniczeniem wiekowym
W takich przypadkach API zwraca opisowy błąd.
Powiązane
- Pobierz plik potem przez
https://api.huntapi.com/v1/video/downloadlubhttps://api.huntapi.com/v1/audio/download - Odpytuj joby async przez
https://api.huntapi.com/v1/jobs/{id}(poleprogress0–100)
VIDEO API
Discover why Hunt is the preferred API provider for developers.