Automate your GEO optimization workflow with our REST API and webhooks
While the GEO-Score dashboard is powerful for manual analysis, the API unlocks automation at scale. Integrate GEO analysis directly into your content management system, CI/CD pipeline, or custom reporting tools to monitor AI search visibility across your entire website automatically.
Whether you're a solo developer automating your own workflow or an agency managing hundreds of client sites, the API gives you programmatic access to every feature available in the dashboard and more.
The GEO-Score API follows RESTful conventions with JSON request and response bodies. All endpoints require authentication via API key and return consistent response structures.
Base URL
Response Format
All API responses follow a consistent JSON structure with status codes and nested data objects:
Every API request must include your API key in the Authorization header. API keys are scoped to your account and can be managed from your dashboard settings.
Navigate to Dashboard > Settings > API Keys to generate a new key. You can create multiple keys with different permissions for different integrations. Each key can be revoked individually without affecting others.
Include your API key as a Bearer token in the Authorization header of every request:
The GEO-Score API provides endpoints for submitting URLs for analysis, retrieving results, triggering re-analyses, and comparing multiple URLs. Here is a summary of all available endpoints:
Retrieve a paginated list of all analyzed URLs in your account.
Get the full analysis results for a specific URL by its unique ID.
Submit a new URL for GEO analysis. Returns the analysis ID for polling results.
Trigger a fresh re-analysis of a previously analyzed URL.
Compare GEO scores and factor breakdowns across multiple URLs side by side.
Get started quickly with these ready-to-use code examples in popular programming languages. Copy, paste, and customize for your specific use case.
JavaScript (Node.js)
Python
PHP
Webhooks allow GEO-Score to push real-time notifications to your server whenever important events occur. Instead of polling the API for updates, configure a webhook URL and receive instant callbacks.
Configure your webhook endpoint in Dashboard > Settings > Webhooks. You can select which events trigger notifications and set a custom signing secret for payload verification.
Fired when a URL analysis finishes processing and results are available.
Fired when a re-analyzed URL shows a significant GEO Score change (delta > 5 points).
Fired when a scheduled or on-demand report is ready for download.
Fired when a new URL is added to your account for tracking.
Automatically analyze every new blog post published in your CMS before it goes live
Set up Slack notifications when any tracked URL drops below a GEO Score threshold
Generate weekly PDF reports and email them to your clients or stakeholders
Build a custom dashboard that combines GEO Score data with your analytics platform
Trigger re-analysis after content updates to measure the impact of your optimizations
Create a pre-publish checklist that requires a minimum GEO Score before content goes live
GEO-Score integrates with popular tools and platforms to fit seamlessly into your existing workflow. Use our native integrations or build your own using the API.
Connect GEO-Score to 5,000+ apps. Trigger Zaps on analysis completion, score changes, or new URLs added to your account.
Install the GEO-Score plugin to analyze pages directly from the WordPress editor. See real-time GEO scores as you write and publish.
Receive instant Slack notifications for score changes, completed analyses, and weekly summary reports in your chosen channel.
Automatically sync GEO Score data to Google Sheets for custom reporting, trend analysis, and easy sharing with your team.
Enrich your HubSpot content strategy with GEO Score data. Track AI visibility alongside your existing marketing metrics.
Correlate GEO Score improvements with organic traffic changes. See how AI search optimization impacts your real-world traffic.
API rate limits apply per account and are shared by every plan, from the Free tier to the €29.99/month Unlimited Subscription. Requests exceeding your rate limit will receive a 429 response with a Retry-After header indicating when you can resume.
Rate limits reset on a rolling one-hour window. Contact support if you need higher limits.
Ready to get started? Generate your API key from the dashboard settings page and try the code examples above. Our API documentation includes detailed request and response schemas for every endpoint.
For advanced use cases, explore our webhook system to build event-driven integrations. Use the POST /urls endpoint to submit pages for analysis and the GET /urls/:id endpoint to retrieve detailed results.