Getting Started

Start integrating with the Trustmarkt API to programmatically access reviews, users, case studies, and company data.

Looking for a Classic API Reference?

We also provide a more traditional, minimal API documentation without extended explanations.

Same API. Same endpoints. Just more compact.

Prerequisites

Upgrade to Premium: API access is only available for Premium customers. If you don't have a Premium plan, upgrade at https://www.trustmarkt.de/preisgestaltung before continuing.

Generate an API token: Log in to your Trustmarkt account, navigate to your profile settings, scroll to the bottom, and create an integration key under "Integrationsschlüssel". You can create up to 5 tokens per account. Store your token securely — it's only displayed once after creation.

Make Your First Request

The Trustmarkt API uses REST principles and returns responses exclusively in JSON format. All requests require authentication via a Bearer token in the Authorization header.

  <?php
  use Illuminate\Support\Facades\Http;

  $response = Http::withToken('YOUR_API_TOKEN')->get('https://api.trustmarkt.de/v1/reviews');
  $data = $response->json();

  print_r($data);
  ?>

const fetch = require('node-fetch');

const response = await fetch('https://api.trustmarkt.de/v1/reviews', {
  headers: {
    'Accept': 'application/json',
    'Authorization': 'Bearer YOUR_API_TOKEN'
  }
});

const data = await response.json();
console.log(data);

import requests

response = requests.get(
    'https://api.trustmarkt.de/v1/reviews',
headers={
  'Accept': 'application/json',	
  'Authorization': 'Bearer YOUR_API_TOKEN'
}
)

data = response.json()
print(data)

<?php
$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'https://api.trustmarkt.de/v1/reviews');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Accept: application/json',
    'Authorization: Bearer YOUR_API_TOKEN'
]);

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

curl_close($ch);
print_r($data);
?>

Expected response:

{
  "data": [
    {
      "id": "V5QrXa40B0oRLMDkxZYj",
      "company_id": "XZzyJn9jEB1lWdvVRx6w",
      "user_id": "5GdkVeN8ZLaw29zBDXyb",
      "is_highlighted": true,
      "rating": 5,
      "title": "Great company with an amazing team!",
      "content": "I had a fantastic experience working with this company...",
      "experience_date": "2023-08-15",
      "created_at": "2026-02-28T14:30:00+01:00"
    }
  ],
  "links": {
    "first": "https://api.trustmarkt.de/v1/reviews?page=1",
    "last": "https://api.trustmarkt.de/v1/reviews?page=5",
    "prev": null,
    "next": "https://api.trustmarkt.de/v1/reviews?page=2"
  },
  "meta": {
    "current_page": 1,
    "per_page": 15,
    "total": 67
  }
}

Rate Limits

The API enforces a rate limit of 120 requests per minute (2 requests per second). If you exceed this limit, you'll receive a 429 Too Many Requests error response:

{
  "message": "Too many requests"
}

Monitor your request rate to stay within the limit. The rate limit window resets every minute.

Error Handling

Handle errors appropriately in your integration:

401 Unauthenticated — Your API token is missing or invalid
403 Authorization error — You don't have a Premium plan or lack permission to access the resource
422 Validation error — Request parameters are invalid
429 Too many requests — You've exceeded the rate limit

No Premium Plan? Without an active Premium subscription, all API requests will return a 403 error. Upgrade at https://www.trustmarkt.de/preisgestaltung to enable API access.

Next Steps

key

Authentication

Learn how to generate and use API tokens to authenticate your requests

book

API Reference

Explore all available endpoints, parameters, and response schemas

webhook

Webhooks

Set up webhooks to receive real-time notifications for events

Get Help

Need assistance? Contact our support team via the live chat on https://app.trustmarkt.de.