API Overview

The SEOGEO Tools Public API provides programmatic access to your projects, audits, content drafts, and GEO monitoring data. Use it to automate workflows, integrate with your tools, and build custom dashboards.

What It Is

The SEOGEO Tools API is a RESTful HTTP API that returns JSON responses. All endpoints are prefixed with /api/public/v1 and require Bearer token authentication using your API key.

How It Works

1. Generate an API key in Settings > API Keys
2. Include the key in the Authorization header: Bearer sg_live_xxx
3. Make requests to endpoints like GET /api/public/v1/projects
4. Receive JSON responses with data and metadata

Base URL

``

https://seogeo.tools/api/public/v1

`

Quick Example

`bash

curl -X GET "https://seogeo.tools/api/public/v1/projects" \

-H "Authorization: Bearer sg_live_abc123..."

`

Available Endpoints

Endpoint	Method	Description
/me	GET	Get current user info
/projects	GET, POST	List or create projects
/projects/:id	GET	Get project details
/projects/:id/audits	GET, POST	List or start audits
/projects/:id/audits/:auditId/pages	GET	List audit pages
/projects/:id/drafts	GET	List content drafts
/projects/:id/content/briefs	POST	Create content brief
/projects/:id/reports	GET	List reports
/projects/:id/geo-monitor/tests	POST	Start GEO test

Next Steps

• Authentication - Learn how to authenticate
• Quick Start - Make your first API call
• API Reference - Complete endpoint documentation

Glossary

API Key: A unique identifier (prefixed sg_live_ or sg_test_) used to authenticate API requests. projectId: UUID identifier for a project, e.g., 550e8400-e29b-41d4-a716-446655440000. auditRunId: UUID identifier for a specific audit run within a project. geoScore: A 0-100 numeric score indicating how well a page is optimized for AI search visibility. Bearer Token: The authorization scheme used. Format: Authorization: Bearer `.