API Access (Premium)
Programmatic Scanning via API
Premium plan subscribers can access the AdGateScore REST API to run scans programmatically, retrieve results, and integrate readiness data into their own tools or workflows.
Getting Your API Key
Go to your Account page and scroll to the API section. Click "Generate API Key" to create a new key. Keep this key secret — it provides full access to your account's scanning capabilities.
Authentication
Include your API key in the Authorization header of every request:
Authorization: Bearer ags_your_api_key_here
Endpoints
Full API documentation is available at /docs/api. The main endpoints are:
- POST /api/v1/scan — Start a new scan by providing a URL
- GET /api/v1/scan/:id — Retrieve results for a completed scan
Rate Limits
API scans count against your plan's daily scan limit. Premium plans include unlimited scans. The API enforces a rate limit of 10 concurrent requests to ensure service quality.
Use Cases
Common API integrations include: monitoring a portfolio of sites, building custom dashboards, automated regression testing after deploys, and white-label reporting for agencies.