Endpoint SEO

Gli endpoint SEO offrono accesso programmatico agli strumenti di analisi SEO: • **SEO Report** - report di audit SEO completo ({{PRICE_SEO_REPORT}}/richiesta) • **PageSpeed** - analisi dei Core Web Vitals e della performance (€0,012/richiesta) • **SERP Track** - traccia il posizionamento di una singola keyword (€0,035/richiesta) • **SERP Batch** - traccia più keyword (€0,035/keyword) Questi endpoint usano automazione del browser, l'API PageSpeed Insights di Google e servizi professionali di tracciamento SERP per fornire dati precisi in tempo reale.

Analizza i Core Web Vitals e le metriche di performance di un URL. **Endpoint:** `POST /v1/seo/pagespeed` **Richiesta:** ```json { "url": "https://example.com", "strategy": "mobile" } ``` **Risposta:** ```json { "success": true, "data": { "url": "https://example.com", "strategy": "mobile", "score": 72, "coreWebVitals": { "lcp": 2.4, "fid": 0.08, "cls": 0.12, "fcp": 1.8, "ttfb": 0.6 }, "opportunities": [ { "id": "render-blocking-resources", "title": "Eliminate render-blocking resources", "savings": "1.2s" } ], "diagnostics": [...] }, "usage": { "cost": 0.05, "balanceRemaining": 19.95 } } ``` **Costo:** €0,012 per analisi **Strategie:** `mobile` (predefinita) o `desktop`

Traccia la posizione di una keyword nei risultati di ricerca. **Endpoint:** `POST /v1/seo/serp/track` **Richiesta:** ```json { "keyword": "seo tools", "domain": "example.com", "location": "United Kingdom", "language": "en" } ``` **Risposta:** ```json { "success": true, "data": { "keyword": "seo tools", "domain": "example.com", "position": 8, "url": "https://example.com/seo-tools", "searchVolume": 12000, "difficulty": 65, "topResults": [ { "position": 1, "url": "https://competitor1.com/...", "title": "..." }, { "position": 2, "url": "https://competitor2.com/...", "title": "..." } ], "features": ["featured_snippet", "people_also_ask"], "trackedAt": "2026-02-27T12:00:00Z" }, "usage": { "cost": 0.03, "balanceRemaining": 19.97 } } ``` **Costo:** €0,035 per keyword

Traccia più keyword in una singola richiesta (fino a 50). **Endpoint:** `POST /v1/seo/serp/batch` **Richiesta:** ```json { "keywords": ["seo tools", "keyword research", "serp tracking"], "domain": "example.com", "location": "United Kingdom", "language": "en" } ``` **Risposta:** ```json { "success": true, "data": { "results": [ { "keyword": "seo tools", "position": 8, "change": 2 }, { "keyword": "keyword research", "position": 15, "change": -3 }, { "keyword": "serp tracking", "position": 4, "change": 1 } ], "summary": { "total": 3, "improved": 2, "declined": 1, "avgPosition": 9 } }, "usage": { "cost": 0.075, "balanceRemaining": 19.925 } } ``` **Costo:** €0,035 per keyword (17 % di sconto rispetto al tracciamento singolo)

I seguenti endpoint SEO sono previsti per una prossima versione: • **Crawl** - esegui crawl e analizza singole pagine • **Audit** - audit tecnico SEO completo con 8 analizzatori Questi endpoint richiedono un'infrastruttura di automazione del browser. Iscriviti al nostro changelog per ricevere aggiornamenti sulla disponibilità.