Klusio API Documentatie

X-API-Key: jouw_api_key_hier

$ch = curl_init('https://klusio.nl/api/blog.php?company_id=123&limit=10');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-API-Key: jouw_api_key_hier',
    'Content-Type: application/json'
]);

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

{
  "success": true,
  "total": 47,
  "limit": 10,
  "offset": 0,
  "posts": [
    {
      "id": 123,
      "title": "Hoe kies je de juiste dakpannen?",
      "slug": "hoe-kies-je-de-juiste-dakpannen",
      "excerpt": "Een korte samenvatting van de post...",
      "content": "Volledige HTML content...",
      "featured_image": "https://...",
      "published_at": "2025-01-20 10:30:00",
      "views": 342,
      "topic_id": 5,
      "topic_name": "Dakbedekking"
    }
  ],
  "reviews": {
    "google_rating": 4.8,
    "total_reviews": 47,
    "rating_distribution": {
      "5": 42,
      "4": 3,
      "3": 1,
      "2": 0,
      "1": 1
    },
    "business_name": "Jouw Bedrijf BV",
    "latest_reviews": [
      {
        "reviewer_name": "Jan Janssen",
        "author_image_url": "https://...",
        "rating": 5,
        "review_text": "Uitstekende service!",
        "review_timestamp": "2025-01-15 14:30:00",
        "time_ago": "5 dagen geleden",
        "review_link": "https://g.page/..."
      }
    ]
  }
}

{
  "success": true,
  "post": {
    "id": 123,
    "title": "Hoe kies je de juiste dakpannen?",
    "slug": "hoe-kies-je-de-juiste-dakpannen",
    "excerpt": "Een korte samenvatting...",
    "content": "<p>Volledige HTML content...</p>",
    "featured_image": "https://...",
    "published_at": "2025-01-20 10:30:00",
    "views": 342,
    "topic_id": 5,
    "topic_name": "Dakbedekking"
  },
  "reviews": { ... },
  "tracking_script": "<script>...</script>"
}

{
  "success": true,
  "total": 8,
  "posts": [ ... ],
  "topic": {
    "id": 5,
    "name": "Dakbedekking",
    "slug": "dakbedekking",
    "status": "active",
    "pillar_type": "pillar"
  },
  "pillar": {
    "url": "https://voorbeeld.nl/dakbedekking",
    "title": "Alles over dakbedekking",
    "type": "page"
  },
  "reviews": { ... }
}

{
  "success": true,
  "total": 3,
  "posts": [ ... ],
  "related_to": "mijn-blog-post",
  "matching_strategy": "topic_cluster",
  "source_post": {
    "id": 123,
    "topic_id": 5,
    "content_role": "cluster",
    "content_type": "how_to_guide"
  },
  "pillar_info": {
    "pillar_url": "https://voorbeeld.nl/dakbedekking",
    "pillar_title": "Alles over dakbedekking"
  },
  "reviews": { ... }
}

// Haal single post op
$response = file_get_contents('https://klusio.nl/api/blog.php?company_id=123&slug=mijn-post', false,
    stream_context_create(['http' => ['header' => 'X-API-Key: jouw_key']])
);
$data = json_decode($response, true);

// Toon de post content
echo $data['post']['content'];

// Plaats het tracking script voor </body>
echo $data['tracking_script'];

// Genereer of hergebruik een uniek visitor ID
let visitorId = localStorage.getItem('klusio_visitor_id');
if (!visitorId) {
    visitorId = 'v_' + Math.random().toString(36).substr(2, 12)
                + '_' + Date.now().toString(36);
    localStorage.setItem('klusio_visitor_id', visitorId);
}

// Track de view bij het verlaten van de pagina
const startTime = Date.now();
let maxScroll = 0;

window.addEventListener('scroll', () => {
    const pct = Math.round(
        (window.scrollY + window.innerHeight)
        / document.documentElement.scrollHeight * 100
    );
    if (pct > maxScroll) maxScroll = pct;
});

window.addEventListener('beforeunload', () => {
    const data = JSON.stringify({
        post_id: 123,        // ID van de blog post
        company_id: 456,     // Jouw company ID
        visitor_id: visitorId,
        time_spent: Math.round((Date.now() - startTime) / 1000),
        scroll_depth: maxScroll,
        referrer: document.referrer || ''
    });

    navigator.sendBeacon(
        'https://klusio.nl/api/track-blog-view.php',
        data
    );
});

{
  "success": true,
  "message": "View succesvol geregistreerd",
  "is_unique": true
}

{
  "reviews": {
    "google_rating": 4.8,
    "total_reviews": 47,
    "rating_distribution": {
      "5": 42,
      "4": 3,
      "3": 1,
      "2": 0,
      "1": 1
    },
    "business_name": "Jouw Bedrijf BV",
    "latest_reviews": [
      {
        "reviewer_name": "Jan Janssen",
        "author_image_url": "https://lh3.googleusercontent.com/...",
        "rating": 5,
        "review_text": "Uitstekende service! Zeer professioneel.",
        "review_timestamp": "2025-01-15 14:30:00",
        "time_ago": "5 dagen geleden",
        "review_link": "https://g.page/..."
      }
    ]
  }
}

// Fetch blog posts met reviews
const response = await fetch('https://klusio.nl/api/blog.php?company_id=123');
const data = await response.json();

if (data.reviews) {
  const rating = data.reviews.google_rating;
  const totalReviews = data.reviews.total_reviews;

  // Toon rating
  document.getElementById('rating').textContent = `${rating}/5`;
  document.getElementById('count').textContent = `${totalReviews} reviews`;

  // Toon reviews
  data.reviews.latest_reviews.forEach(review => {
    console.log(`${review.reviewer_name}: ${review.review_text}`);
  });
}

{
  "error": "company_id is required",
  "success": false
}