---
title: API-referentie
description: Bekijk de Firmreader REST API-referentie om posts te maken, kanalen te beheren, met API-sleutels te authenticeren en programmatisch analyses op te vragen.
lastUpdated: "2026-08-21"
---

> **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version.

De Firmreader API is een REST API waarmee je met code programmatisch posts kunt maken, kanalen kunt beheren en analyses kunt opvragen. Probeer onze krachtige API.

## Basis-URL

```
https://api.firmreader.com/v1
```

## Authenticatie

Voor elke aanvraag is een API-sleutel vereist in de header `Authorization`:

<CodeGroup>
```bash cURL
curl https://api.firmreader.com/v1/posts \
  -H "Authorization: Bearer fr_live_abc123"
```

```javascript Node.js
const response = await fetch('https://api.firmreader.com/v1/posts', {
  headers: {
    'Authorization': 'Bearer fr_live_abc123',
  },
});
```

```python Python
import requests

response = requests.get(
    'https://api.firmreader.com/v1/posts',
    headers={'Authorization': 'Bearer fr_live_abc123'},
)
```
</CodeGroup>

API-sleutels worden aangemaakt in **Settings > API Keys**. Elke sleutel heeft een bereik dat bepaalt waartoe deze toegang heeft:

| Bereik | Machtigingen |
|-------|------------|
| `posts:read` | Posts weergeven en ophalen |
| `posts:write` | Posts maken, bijwerken en verwijderen |
| `channels:read` | Kanalen weergeven en ophalen |
| `channels:write` | Kanalen maken, bijwerken en verwijderen |
| `analytics:read` | Engagementstatistieken opvragen |

## Snelheidslimieten

| Abonnement | Aanvragen per minuut |
|------|-------------------|
| Starter | 60 |
| Business | 300 |
| Enterprise | 1.000 |

Headers voor snelheidslimieten zijn opgenomen in elke response:

```
X-RateLimit-Limit: 300
X-RateLimit-Remaining: 297
X-RateLimit-Reset: 1708790400
```

## Foutindeling

Alle fouten volgen een consistente indeling:

```json
{
  "error": {
    "code": "invalid_request",
    "message": "The channel_id field is required.",
    "param": "channel_id"
  }
}
```

| HTTP-status | Betekenis |
|-------------|---------|
| 400 | Ongeldige aanvraag — controleer je parameters |
| 401 | Niet geautoriseerd — ongeldige of ontbrekende API-sleutel |
| 403 | Verboden — API-sleutel heeft niet het vereiste bereik |
| 404 | Niet gevonden — resource bestaat niet |
| 429 | Snelheidslimiet bereikt — verlaag het tempo |
| 500 | Serverfout — probeer het later opnieuw |

## Paginering

List-endpoints retourneren gepagineerde resultaten. Gebruik de parameters `cursor` en `limit`:

```bash
curl "https://api.firmreader.com/v1/posts?limit=20&cursor=post_abc123" \
  -H "Authorization: Bearer fr_live_abc123"
```

De response bevat een veld `next_cursor`. Wanneer dit `null` is, heb je het einde bereikt.

```json
{
  "data": [...],
  "next_cursor": "post_xyz789",
  "has_more": true
}
```