REST API

Direct API Access

Fetch your workspace content programmatically via secure, token-authorized endpoints.

Interactive Playground

Configure your request and dry-run with your token.

curl -X GET "https://api.visualref.com/api/v1/content?page=1&limit=20" \
  -H "Authorization: Bearer YOUR_TOKEN_HERE"

Available Endpoints

GET/api/v1/content

Returns a paginated list of articles in your workspace.

{
  "data": [
    {
      "id": "item_123",
      "title": "Introduction to GEO",
      "status": "PUBLISHED",
      "createdAt": "2024-04-19T20:25:59.000Z"
    }
  ],
  "pagination": {
    "total": 1,
    "page": 1,
    "limit": 20,
    "totalPages": 1
  }
}
GET/api/v1/content/:id

Returns the full content and metadata for a specific article.

{
  "id": "item_123",
  "title": "Introduction to GEO",
  "bodyMarkdown": "# Introduction to GEO\n\nContent goes here...",
  "htmlContent": "<h1>Introduction to GEO</h1><p>Content goes here...</p>",
  "status": "PUBLISHED",
  "coverImageUrl": "https://img.visualref.com/123.png",
  "createdAt": "2024-04-19T20:25:59.000Z",
  "updatedAt": "2024-04-19T20:25:59.000Z"
}

Security & Authentication

All requests must be authenticated via the Authorization header using the Bearer scheme. Tokens can be generated in your dashboard under **Settings > Integrations**.