Skip to main content
Accedi

L'API Jobs

Il Tuo Stack.
Il Nostro Team di Ricerca.

Avvia Job da n8n, Make, Zapier o dal tuo stack. PDF, slide e JSON white-label via webhook. Circa 15 minuti.

Incluso in ogni piano. PAYG e abbonati.

POST /v1/reports/signal

{
  "url": "https://yoursite.com",
  "personas": ["cmo", "founder"],
  "webhook": "https://you.com/hook"
}

Un'API. Tre Tipi di Job.

AI Visibility

Come l’IA parla del tuo brand su sette piattaforme. Consapevole del persona. Competitivo. Il quadro completo.

POST /v1/reports/signal

Site Audit

Velocità, SEO, sicurezza, accessibilità e schema. 30 o 100 pagine di profondità. Prove tecniche, non supposizioni.

POST /v1/reports/scan

Strategy

Raccomandazioni testate su sette piattaforme IA. Concatena da AI Visibility o Site Audit con Intelligence Token.

POST /v1/reports/solutions

Crawler deterministici. Scoring su sette motori. Classificazione ML. Contesto per Job. White-label in uscita.

Agenzie

Sei il team frazionale per i tuoi clienti. Surmado è il team frazionale per te. Risultati white-label via webhook, senza dashboard. Portfolio: brand illimitati, 20 Job/mese.

Sviluppatori

Costruisci su Scout. Estrai dati strutturati da qualsiasi Job, integra Zapier, Make, n8n o il tuo stack. REST, Bearer token, modalità test inclusa. Esempi Python e Node.js nella documentazione.

FAQ API

In cosa si differenzia da Claude Skills o dai connettori LLM?

Le Skills danno al tuo team un generalista da interrogare. Surmado è una pipeline opinata con crawler deterministici, scoring su sette motori, contesto per Job e output white-label. Richiamabile, non manutenuto.

Cosa c'è davvero sotto l'API?

Crawler deterministici, AI visibility su sette motori con scoring normalizzato, classificazione ML e contesto per Job per ogni brand. Non è un wrapper LLM leggero.

Posso rendere l'output white-label?

Sì. PDF e slide arrivano pronti per il brand. Il JSON strutturato è tuo, lo instradi, lo trasformi o lo renderizzi come vuoi.

Funziona con n8n, Make o Zapier?

Guide di integrazione native per tutti e tre. I webhook sono firmati HMAC. REST usa l'autenticazione Bearer standard.

Posso concatenare i Job?

Sì. I report AI Visibility e Site Audit completati restituiscono un Intelligence Token. Passalo a Strategy per ragionare su dati reali, non su un prompt nuovo.

Cosa succede quando un Job fallisce?

I crediti vengono rimborsati automaticamente. Il webhook invia report.failed con un motivo.

Accesso API. Ogni Piano. Nessun Costo Aggiuntivo.

Incluso in ogni piano. Esegui Jobs, ricevi risultati, crea integrazioni.

VEDI DOCUMENTAZIONE

Domande? hi@surmado.com