Validate in CI/CD Pipeline in cURL
The validate endpoint is designed for CI/CD integration. With wait=true, it blocks until the scan completes and returns pass/fail based on your configured rules. Returns HTTP 200 for pass and 409 for fail, making it easy to gate deployments.
Endpoint
POST /api/v1/validate
cURL Code
curl -X POST "https://seodiff.io/api/v1/validate" \
-H "Authorization: Bearer $SEODIFF_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://staging.example.com","wait":true,"rules":{"max_issues":0,"required_score":80}}'Example Response
{"pass":true,"score":92,"issues":[],"scan_id":"s_abc123","duration_ms":3200}All requests require an API key in the Authorization: Bearer header. Get your API key →
Same Endpoint, Other Languages
More cURL Examples
Evaluate pSEO Pages
Test programmatic pages against assertion rules. The core agentic evaluation endpoint.
Scan a Website
Enqueue a surface scan for diff detection and SEO regression identification.
Trigger Deep Audit
Start a comprehensive multi-page crawl with PageRank, link analysis, and pSEO diagnostics.
Validate llms.txt File
Test your llms.txt file against the specification and get actionable fixes.
Google Search Console Data Sync
Pull GSC performance data into SEODiff for correlation with AI-readiness metrics.