Endpoints SEO

Les endpoints SEO offrent un accès programmatique aux outils d'analyse SEO : • **SEO Report** — rapport d'audit SEO complet ({{PRICE_SEO_REPORT}}/requête) • **PageSpeed** — analyse des Core Web Vitals et de la performance (€0,012/requête) • **SERP Track** — suivi du positionnement d'un mot-clé (€0,035/requête) • **SERP Batch** — suivi de plusieurs mots-clés (€0,035/mot-clé) Ces endpoints utilisent l'automatisation de navigateur, l'API PageSpeed Insights de Google et des services professionnels de suivi SERP pour livrer des données précises en temps réel.

Analyse les Core Web Vitals et les indicateurs de performance d'une URL. **Endpoint :** `POST /v1/seo/pagespeed` **Requête :** ```json { "url": "https://example.com", "strategy": "mobile" } ``` **Réponse :** ```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 } } ``` **Coût :** €0,012 par analyse **Stratégies :** `mobile` (par défaut) ou `desktop`

Suit la position d'un mot-clé dans les résultats de recherche. **Endpoint :** `POST /v1/seo/serp/track` **Requête :** ```json { "keyword": "seo tools", "domain": "example.com", "location": "United Kingdom", "language": "en" } ``` **Réponse :** ```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 } } ``` **Coût :** €0,035 par mot-clé

Suit plusieurs mots-clés dans une seule requête (jusqu'à 50). **Endpoint :** `POST /v1/seo/serp/batch` **Requête :** ```json { "keywords": ["seo tools", "keyword research", "serp tracking"], "domain": "example.com", "location": "United Kingdom", "language": "en" } ``` **Réponse :** ```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 } } ``` **Coût :** €0,035 par mot-clé (17 % de remise par rapport au suivi unitaire)

Les endpoints SEO suivants sont prévus pour une prochaine version : • **Crawl** — explorer et analyser des pages individuelles • **Audit** — audit SEO technique complet avec 8 analyseurs Ces endpoints nécessitent une infrastructure d'automatisation de navigateur. Abonnez-vous à notre changelog pour suivre la disponibilité.