curl -X GET \
  "https://api.kardow.com/analytics" \
  -H "x-api-key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "period": "30d",
    "includeComparison": true
  }'

curl -X GET \
  "https://api.kardow.com/analytics" \
  -H "x-api-key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "period": "30d",
    "filters": {
      "device": ["Desktop"],
      "country": ["US", "GB"],
      "source": ["Google", "LinkedIn"]
    },
    "includeComparison": true
  }'

curl -X GET \
  "https://api.kardow.com/analytics" \
  -H "x-api-key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "period": "custom",
    "dateRange": {
      "from": "2024-01-01",
      "to": "2024-01-31"
    },
    "includeComparison": true
  }'

const apiKey = process.env.KARDOW_API_KEY;

const response = await fetch(
  'https://api.kardow.com/analytics',
  {
    method: 'GET',
    headers: {
      'x-api-key': apiKey,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      period: '30d',
      filters: {
        device: ['Desktop'],
        country: ['US', 'GB']
      },
      includeComparison: true
    })
  }
);

const data = await response.json();
console.log('Analytics:', data.data.metrics);
console.log('Comparison:', data.data.comparison);

import os
import requests

api_key = os.environ.get('KARDOW_API_KEY')

url = 'https://api.kardow.com/analytics'
headers = {
    'x-api-key': api_key,
    'Content-Type': 'application/json'
}
payload = {
    'period': '30d',
    'filters': {
        'device': ['Desktop'],
        'country': ['US', 'GB']
    },
    'includeComparison': True
}

response = requests.get(url, headers=headers, json=payload)
data = response.json()
print('Analytics:', data['data']['metrics'])
print('Comparison:', data['data']['comparison'])

<?php
$apiKey = getenv('KARDOW_API_KEY');

$url = 'https://api.kardow.com/analytics';
$payload = [
    'period' => '30d',
    'filters' => [
        'device' => ['Desktop'],
        'country' => ['US', 'GB']
    ],
    'includeComparison' => true
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "x-api-key: $apiKey",
    'Content-Type: application/json'
]);
curl_setopt($ch, GET, true);
curl_setopt($ch, CURLOPT_GETFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

print_r($data['data']['metrics']);
?>

{
  "data": {
    "metrics": {
      "visitors": 1500,
      "pageviews": 4200,
      "bounce_rate": 45.2,
      "visit_duration": 125
    },
    "comparison": {
      "visitors": {
        "value": 1500,
        "change": 12.5
      },
      "pageviews": {
        "value": 4200,
        "change": 8.3
      },
      "bounce_rate": {
        "value": 45.2,
        "change": -5.2
      },
      "visit_duration": {
        "value": 125,
        "change": 3.8
      }
    },
    "previousMetrics": {
      "visitors": 1333,
      "pageviews": 3878,
      "bounce_rate": 47.7,
      "visit_duration": 120
    },
    "timeseries": [
      {
        "date": "2024-01-01",
        "visitors": 50,
        "pageviews": 140,
        "bounce_rate": 44.5,
        "visit_duration": 128
      }
    ],
    "topPages": [
      {
        "name": "/companies/acme/jobs/software-engineer",
        "visitors": 320,
        "pageviews": 580,
        "bounce_rate": 42.1,
        "visit_duration": 135
      }
    ],
    "topSources": [
      {
        "name": "Google",
        "visitors": 450,
        "pageviews": 1200,
        "bounce_rate": 38.5,
        "visit_duration": 142
      }
    ],
    "topCountries": [
      {
        "code": "US",
        "name": "United States",
        "visitors": 650,
        "pageviews": 1850
      }
    ],
    "devices": [
      {
        "name": "Desktop",
        "visitors": 800,
        "pageviews": 2200
      }
    ],
    "browsers": [
      {
        "name": "Chrome",
        "visitors": 900,
        "pageviews": 2500
      }
    ],
    "os": [
      {
        "name": "Windows",
        "visitors": 600,
        "pageviews": 1700
      }
    ],
    "topCompanies": [
      {
        "name": "Acme Inc",
        "visitors": 450
      }
    ],
    "topJobs": [
      {
        "name": "Software Engineer",
        "visitors": 320
      }
    ]
  },
  "meta": {
    "period": "30d",
    "filters_applied": {
      "device": ["Desktop"],
      "country": ["US", "GB"]
    },
    "organization_domain": "acme.kardow.com"
  }
}

{
  "error": {
    "message": "API key is required",
    "code": "missing_api_key",
    "details": "Please provide an API key in the x-api-key header",
    "url": "https://kardow.featurebase.app/help/articles/api-documentation"
  }
}

{
  "error": {
    "message": "Invalid parameters",
    "code": "validation_error",
    "details": [
      {
        "code": "invalid_enum_value",
        "options": ["7d", "30d", "6mo", "12mo", "custom"],
        "path": ["period"],
        "message": "Invalid enum value. Expected '7d' | '30d' | '6mo' | '12mo' | 'custom'"
      }
    ],
    "url": "https://kardow.com/help/api/full-analytics"
  }
}

{
  "error": {
    "message": "Missing required parameter",
    "code": "missing_parameter",
    "details": "dateRange is required when period is \"custom\"",
    "url": "https://kardow.com/help/api/full-analytics"
  }
}