Skip to content

DEVELOPER PLATFORM / REST v1

Collabraz API.

Your content workflow, connected to your own tools. Read your workspace, generate articles, discover keywords and evaluate AI visibility.

BASE URLhttps://www.collabraz.com/api/v1

Start with your workspace key.

Create a key in Settings / Developer API & MCP, then include Authorization: Bearer YOUR_API_KEY with every request. API access requires a paid workspace plan.

Websites / Reference

List websites

Retrieve the websites in your API key's workspace, including their domains, publishing mode and content counts.

GET/api/v1/websites

Query parameters

URL parameters

No parameters required. This endpoint returns websites belonging to the authenticated workspace.

Request builder

Adjust the example values. Requests are not sent from this page.

Your first request is ready to copy.

Request example

Bash / cURL
curl --request GET 'https://www.collabraz.com/api/v1/websites' \
  --header "Authorization: Bearer $COLLABRAZ_API_KEY"

Set COLLABRAZ_API_KEY in your local environment. Keep API keys on your server.

Response example

JSON / illustrative response
{
  "success": true,
  "workspace": {
    "id": "workspace_example",
    "name": "My workspace",
    "plan": "Growth"
  },
  "total": 1,
  "websites": [
    {
      "id": "website_example",
      "name": "My website",
      "slug": "my-website",
      "subdomain": "example.collabraz.com",
      "customDomain": null,
      "primaryUrl": "https://example.collabraz.com",
      "category": "TECHNOLOGY",
      "language": "en",
      "destinationType": "NATIVE",
      "publishingMode": "MANUAL_REVIEW",
      "totalArticles": 12,
      "totalKeywords": 24,
      "status": "ACTIVE",
      "createdAt": "2026-01-01T09:00:00.000Z"
    }
  ]
}

WHEN A REQUEST NEEDS ATTENTION

Errors & usage

Read the HTTP status and JSON error message together. A successful generation response means the background job was started.

400
Invalid JSON, validation failure or no active website for generation.
401
Missing, invalid, expired or revoked API key, or a workspace plan without API access.
402
Article-generation allowance exceeded.
404
The requested website was not found in the workspace.
500
An AI operation failed. Review the error message before retrying.

Article generation is subject to your workspace allowance. Check Content Queue before retrying a generation request: repeating it can create another job. There is currently no public job-status endpoint or documented per-minute request limit.