Référence de l'API
L'API de Vertical Viral est conçu pour l'extraction asynchrone des algorithmes secrets.
Authentification
Tous les appels doivent utiliser votre jeton. Accès: Dashboard API.
Ne jamais dévoiler votre clé secrète. Protégez-la.
En-tête Authorization
curl -X POST https://verticalviral.io/api/scrape/reelsanalyzer \
-H "Authorization: Bearer vv_live_xt789..." \
-H "Content-Type: application/json"Instagram Reels Analyzer
Créer une session invisible de manière asynchrone.
POSThttps://verticalviral.io/api/scrape/reelsanalyzer
Corps de Requête
target_usernamestring · required
Handle Instagram sans @. Ex:
nikewebhook_urlstring · required
Endpoint pour la réception de votre POST JSON.
depthinteger · optional
Nombre de Reels. (Défaut 30, max 150).
cURL Example
curl -X POST https://verticalviral.io/api/scrape/reelsanalyzer \
-H "Authorization: Bearer " \
-H "Content-Type: application/json" \
-d '{
"target_username": "mosbius",
"webhook_url": "https://your-server.com/webhooks/vv",
"depth": 50
}'Réponse Immédiate (200 OK)
La confirmation retourne le job_id à sauvegarder en base de données.
Response
{
"status": "queued",
"job_id": "job_8f2b3c4d5e",
"message": "Extraction started. Data will be sent to your webhook."
}Instagram Profile Scraper
Collects comprehensive target profile information (subscribers, business flag, public emails, and bio context).
POSThttps://verticalviral.io/api/scrape/profilescraper
Corps de Requête
target_usernamestring · required
The exact Instagram handle to analyze without the @ symbol.
webhook_urlstring · required
Endpoint pour la réception de votre POST JSON.
Attente d'Événement
Il enverra les données (en général 20 sec).
Clés Principales
status"completed" | "failed"
Échec possible via error_message.
magnetism_scorefloat (0.0 - 10.0)
Score magnétique en proportion (0-10).
outlier_statusboolean
Indique true si les vues ont dépassé X2 de la moyenne absolue.
Webhook POST Body Example
{
"id": "job_8f2b3c4d5e",
"status": "completed",
"target": "mosbius",
"data": {
"profile_stats": {
"followers": 145200,
"extracted_emails": ["hello@mosbius.com"]
},
"reels": [
{
"shortcode": "C9Z8A7X",
"views": 1245000,
"likes": 89000,
"magnetism_score": 9.8,
"outlier_status": true
}
]
}
}Erreurs et Limites
Signaux HTTP.
200OK - Succès de la file d'attente.
400Bad Request - Paramètre manquant.
401Unauthorized - Jeton manquant.
429Too Many Requests - Quota.
Sécurisé par Stripe.
Instagram Comment Scraper
Parses up to 500 top-level comments and replies directly from an Instagram Post URL.
Corps de Requête