Introduction

The Trakk Agency API gives you programmatic access to your SEO projects, reports, and generated content. It is designed for server-to-server integrations - for example, automatically pulling generated SEO text into your CMS when a new report is ready.

Base URL: https://admin.trakk.ai/api/v1

All responses are JSON. All requests must be authenticated.

---

Quickstart

1. Verify your token

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  https://admin.trakk.ai/api/v1/me

2. List your projects

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  https://admin.trakk.ai/api/v1/projects

3. Check the latest report for a project

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  https://admin.trakk.ai/api/v1/projects/42/reports/latest

4. Fetch content when the report is ready (status === "completed")

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  https://admin.trakk.ai/api/v1/projects/42/reports/14/content

No webhooks are currently available. Poll /reports/latest on a schedule and fetch /content when status becomes completed.

---

What's next?

• Authentication - get a token, understand rate limits and IP restrictions
• Responses & Errors - JSON envelope, error codes, pagination, and caching
• Endpoint Reference - all available endpoints at a glance
• Integration Examples - ready-to-use JavaScript snippets