Récupérez les vidéos de n'importe quel hashtag TikTok via l'API Scavio à $0.005/requête. Processus en deux étapes : obtenez les informations du hashtag (y compris challenge_id), puis récupérez les vidéos pour ce hashtag avec les métriques d'engagement complètes.
Prérequis
- Clé API Scavio
- Nom du hashtag cible
- Python 3.8+ ou Node.js 18+
Parcours
Étape 1: Obtenir les informations du hashtag
Consultez les métadonnées du hashtag, y compris le challenge_id et le nombre de vues.
Python
import requests, os
HEADERS = {'Authorization': f'Bearer {os.environ["SCAVIO_API_KEY"]}',
'Content-Type': 'application/json'}
info = requests.post('https://api.scavio.dev/api/v1/tiktok/hashtag',
headers=HEADERS, json={'hashtag': 'smallbusiness'}).json()['data']
print(f"Views: {info['stats']['view_count']:,}")
print(f"Videos: {info['stats']['video_count']:,}")
challenge_id = info['challenge_id']Étape 2: Récupérer les vidéos pour le hashtag
Utilisez le challenge_id pour obtenir les vidéos publiées sous ce hashtag.
Python
videos = requests.post('https://api.scavio.dev/api/v1/tiktok/hashtag/videos',
headers=HEADERS,
json={'challenge_id': challenge_id, 'count': 20, 'cursor': 0}).json()['data']
for v in videos.get('videos', []):
print(f"{v['desc'][:40]} | {v['stats']['playCount']:,} plays")Exemple Python
Python
import requests, os
HEADERS = {'Authorization': f'Bearer {os.environ["SCAVIO_API_KEY"]}',
'Content-Type': 'application/json'}
def hashtag_research(hashtag, video_pages=3):
info = requests.post('https://api.scavio.dev/api/v1/tiktok/hashtag',
headers=HEADERS, json={'hashtag': hashtag}).json()['data']
challenge_id = info['challenge_id']
videos = []
cursor = 0
for _ in range(video_pages):
resp = requests.post('https://api.scavio.dev/api/v1/tiktok/hashtag/videos',
headers=HEADERS,
json={'challenge_id': challenge_id, 'count': 20, 'cursor': cursor}).json()['data']
videos.extend(resp.get('videos', []))
if not resp.get('has_more'):
break
cursor = resp['cursor']
return {'views': info['stats']['view_count'],
'video_count': info['stats']['video_count'],
'sample_videos': len(videos), 'videos': videos}
result = hashtag_research('smallbusiness')
print(f"{result['views']:,} views, {result['sample_videos']} videos sampled")Exemple JavaScript
JavaScript
const H = {'Authorization': `Bearer ${process.env.SCAVIO_API_KEY}`, 'Content-Type': 'application/json'};
async function hashtagResearch(hashtag) {
const info = await fetch('https://api.scavio.dev/api/v1/tiktok/hashtag', {
method: 'POST', headers: H, body: JSON.stringify({hashtag})
}).then(r => r.json());
const cid = info.data.challenge_id;
const vids = await fetch('https://api.scavio.dev/api/v1/tiktok/hashtag/videos', {
method: 'POST', headers: H,
body: JSON.stringify({challenge_id: cid, count: 20, cursor: 0})
}).then(r => r.json());
console.log(`${info.data.stats.view_count} views, ${(vids.data.videos||[]).length} sample videos`);
}
hashtagResearch('smallbusiness');Sortie attendue
JSON
Hashtag metadata (total views, video count) plus sample videos with engagement metrics for content research.