Strumenti

visibility_check

POST /api/v1/visibility · MCP: visibility_check · prezzo per modello interrogato

Fa una domanda reale ai modelli AI con la ricerca web attiva (come la vede un utente) e analizza la risposta.

Parametro	Tipo	Note
brand *	string (1–100)	brand da cercare; vengono riconosciute anche le varianti del nome
question *	string (5–500)	la domanda del cliente
models	string[] (max 5)	es. ["chatgpt","gemini"]; predefinito: tutti i modelli disponibili (vedi /api/v1/tools)
competitors	string[] (max 10)	concorrenti da tracciare
brand_domain	string	dominio del brand, per sapere se il sito è citato tra le fonti

Per ogni modello la risposta contiene:

• brand.mentioned, brand.mention_count
• brand.list_rank: posizione nelle liste di raccomandazioni, se presente
• brand.first_mention_percent ed excerpt: dove e come viene citato
• competitors[]: citazione e posizione di ogni concorrente
• brand_domain_cited: se il tuo sito è tra le fonti
• sources[]: URL, titolo e dominio delle fonti
• answer: il testo della risposta (fino a 8.000 caratteri)

Più un riepilogo: models_asked, models_answered, mentioned_in, visibility_percent. I modelli che non rispondono vengono rimborsati.

geo_audit

POST /api/v1/geo-audit · MCP: geo_audit · prezzo per chiamata

Parametro	Tipo	Note
url *	string	dominio o URL pubblico, es. example.com

Restituisce score (0–100), checks[] (ogni controllo con id, status = pass/warn/fail/info, weight e parametri), bots[] (18 crawler AI: consentito o bloccato da robots.txt o dal firewall) e llms (presenza, formato e link di llms.txt e llms-full.txt).

id	Cosa controlla
https	connessione sicura
robots_txt	presenza di robots.txt
ai_search_bots	crawler delle risposte AI non bloccati
ai_firewall	firewall/CDN non respinge i crawler AI (test reale)
ai_training_bots	crawler di addestramento (informativo, non pesa sul punteggio)
llms_txt, llms_links, llms_full_txt	file per gli LLM
sitemap, sitemap_in_robots, sitemap_fresh	indicizzazione
js_rendering	testo leggibile senza JavaScript
snippet_directives	noindex, nosnippet, max-snippet:0, noai
org_schema, website_schema	dati strutturati
trust_pages	Chi siamo e Contatti collegati dalla home
open_graph, html_lang	anteprime e lingua

Se il sito non è raggiungibile la chiamata viene rimborsata. Indirizzi privati o interni vengono rifiutati senza addebito (400 invalid_url).

account_balance (solo MCP) e GET /api/v1/account

Saldo e prezzi correnti. Gratis.

Formato della risposta

{
  "request_id": "req_…",
  "tool": "visibility_check",
  "gross_cents": 70,
  "charged_cents": 35,
  "refunded_cents": 35,
  "balance_cents": 1930,
  "result": { }
}

gross_cents è l'importo prenotato prima della chiamata, charged_cents quello effettivamente pagato. balance_cents è il saldo al momento della risposta: con chiamate in parallelo può includere addebiti di altre chiamate ancora in corso.