Skip to main content

API Overview

The SEO Platform provides a RESTful API for programmatic access to all platform features.

Base URL​

https://seo.bedmar.dk/api/v1

For local development:

http://localhost:8000/api/v1

Authentication​

All API requests require authentication via Bearer token:

curl -H "Authorization: Bearer YOUR_TOKEN" \
     https://api.seo-platform.com/api/v1/keywords

Response Format​

All responses are JSON formatted:

{
  "data": { ... },
  "meta": {
    "total": 100,
    "page": 1,
    "per_page": 20
  }
}

Error Handling​

Errors return appropriate HTTP status codes with details:

{
  "detail": "Error message here",
  "code": "ERROR_CODE"
}

Rate Limiting​

API requests are rate-limited to 100 requests per minute per user.

Available Endpoints​

The API provides endpoints for:

  • Keywords - CRUD operations for keyword management
  • Taxonomy - Category and hierarchy management
  • Classification - AI-powered keyword classification
  • Users - User and authentication management