Vertical Viral

Riferimento API

L'API asincrona di Vertical Viral estrae le informazioni segrete.

Autenticazione

Dall'Autenticatore Dashboard per sviluppatori.

Non condividere le tue chiavi.

Intestazione
curl -X POST https://verticalviral.io/api/scrape/reelsanalyzer \
  -H "Authorization: Bearer vv_live_xt789..." \
  -H "Content-Type: application/json"

Instagram Reels Analyzer

Inizziazione rapida e non rilevabile.

POSThttps://verticalviral.io/api/scrape/reelsanalyzer

Corpo Richiesta

target_usernamestring · required
Username esatto. Es: nike
webhook_urlstring · required
Dove riceverai i dati in POST.
depthinteger · optional
Reel analizzati, massimi 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
  }'

Risposta Server (200)

Metti da parte l'ID lavoro per l'aggiornamento.

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

Corpo Richiesta

target_usernamestring · required
The exact Instagram handle to analyze without the @ symbol.
webhook_urlstring · required
Dove riceverai i dati in POST.

Instagram Comment Scraper

Parses up to 500 top-level comments and replies directly from an Instagram Post URL.

POSThttps://verticalviral.io/api/scrape/commentscraper

Corpo Richiesta

target_urlstring · required
The absolute URL of the Instagram Reel or Post to extract comments from.
webhook_urlstring · required
Dove riceverai i dati in POST.

Spedizione Webhook

Appr. 20-30s di calcolo automatico.

Campi Utili

status"completed" | "failed"
Esprime fallimenti.
magnetism_scorefloat (0.0 - 10.0)
Score da 0 a 10 per interazione.
outlier_statusboolean
Indica il raddoppiamento della media con 'true'.
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
      }
    ]
  }
}

Errori e Limiti

Status vari.

200OK - Entrato.
400Bad Request - Manca.
401Unauthorized - Non autoriz.
429Too Many Requests - Rate.
Tutelato da Stripe.