Aan de slag

Introductie Authenticatie Foutcodes Rate limits

Endpoints

Posts Content generatie Analytics

Geavanceerd

Webhooks SDK's

Developer API

Greet API v1

Integreer Greet's AI-marketingfuncties direct in jouw applicaties. REST API met JSON responses.

v1.4.2 Stable https://api.heygreet.nl/v1

Authenticatie

De Greet API gebruikt Bearer token authenticatie. Voeg jouw API-sleutel toe aan elke request via de Authorization header.

API-sleutel ophalen

Je vindt jouw API-sleutel in het Greet Dashboard onder Instellingen → Developers → API Keys. Bewaar je sleutel veilig — deel hem nooit publiekelijk.

# Voorbeeld authenticatie header
Authorization: Bearer greet_sk_live_xxxxxxxxxxxxxxxxxxxxxxxx

Posts

GET /v1/posts Haal alle posts op ▼

Query parameters

Parameter	Type	Vereist	Beschrijving
platform	string	optioneel	Filter op platform: `instagram`, `facebook`, `linkedin`
status	string	optioneel	Filter op status: `published`, `scheduled`, `draft`
limit	integer	optioneel	Maximaal aantal resultaten (default: 20, max: 100)
offset	integer	optioneel	Paginering offset (default: 0)

Codevoorbeelden

import requests

response = requests.get(
    "https://api.heygreet.nl/v1/posts",
    headers={"Authorization": "Bearer greet_sk_live_xxx"},
    params={"platform": "instagram", "status": "published", "limit": 10}
)
posts = response.json()

const response = await fetch(
  'https://api.heygreet.nl/v1/posts?platform=instagram&status=published&limit=10',
  {
    headers: {
      'Authorization': 'Bearer greet_sk_live_xxx',
      'Content-Type': 'application/json'
    }
  }
);
const posts = await response.json();

curl -X GET \
  "https://api.heygreet.nl/v1/posts?platform=instagram&status=published&limit=10" \
  -H "Authorization: Bearer greet_sk_live_xxx"

Response voorbeeld

{
  "data": [
    {
      "id": "post_01JAN2026XXXXXX",
      "platform": "instagram",
      "status": "published",
      "caption": "Wist je dat een goed geaarde installatie je energierekening...",
      "published_at": "2026-01-15T11:00:00Z",
      "engagement": { "likes": 47, "comments": 8, "reach": 1240 }
    }
  ],
  "meta": { "total": 284, "limit": 10, "offset": 0 }
}

Content Generatie

POST /v1/content/generate Genereer AI-content ▼

Request body (JSON)

Parameter	Type	Vereist	Beschrijving
branch	string	vereist	Branche van het bedrijf: `elektriciens`, `schilders`, etc.
platform	string	vereist	Doelplatform: `instagram`, `facebook`, `linkedin`
tone	string	optioneel	Toon: `professional`, `casual`, `expert` (default: professional)
topic	string	optioneel	Onderwerp of thema voor de post
include_hashtags	boolean	optioneel	Hashtags toevoegen (default: true)
language	string	optioneel	Taalcode: `nl`, `en` (default: nl)

Codevoorbeelden

import requests

response = requests.post(
    "https://api.heygreet.nl/v1/content/generate",
    headers={
        "Authorization": "Bearer greet_sk_live_xxx",
        "Content-Type": "application/json"
    },
    json={
        "branch": "elektriciens",
        "platform": "instagram",
        "tone": "expert",
        "topic": "Veiligheid bij thuisinstallaties",
        "include_hashtags": True
    }
)
content = response.json()

const response = await fetch('https://api.heygreet.nl/v1/content/generate', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer greet_sk_live_xxx',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    branch: 'elektriciens',
    platform: 'instagram',
    tone: 'expert',
    topic: 'Veiligheid bij thuisinstallaties',
    include_hashtags: true
  })
});
const content = await response.json();

Response voorbeeld

{
  "content_id": "gen_9fAb3KxP2m",
  "caption": "Veiligheid staat bij ons altijd op de eerste plaats!  Wist je dat een verouderd stopcontact brandgevaar kan opleveren? Onze elektriciens controleren jouw installatie...",
  "hashtags": ["#elektricien", "#veiligheid", "#installatie", "#vakman"],
  "platform": "instagram",
  "estimated_reach": 850,
  "created_at": "2026-01-30T09:42:00Z"
}

Analytics

GET /v1/analytics Analytics en statistieken ▼

Query parameters

Parameter	Type	Vereist	Beschrijving
period	string	optioneel	Periode: `7d`, `30d`, `90d` (default: 30d)
platform	string	optioneel	Filter op platform
metrics	string[]	optioneel	Specifieke metrics: `reach,engagement,followers,posts`

Response voorbeeld

{
  "period": "30d",
  "platforms": {
    "instagram": {
      "followers": { "total": 1842, "growth": +127 },
      "posts_published": 28,
      "avg_reach": 1240,
      "avg_engagement_rate": 4.8,
      "total_likes": 1847,
      "total_comments": 312
    }
  },
  "leads_generated": 23
}

Rate Limits

Rate limits worden per API-sleutel toegepast. De huidige limiet wordt teruggegeven in de response headers.

100

requests/minuut

5.000

requests/uur

50.000

requests/maand

# Rate limit headers in elke response
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 1706611200

Webhooks

Greet kan jouw endpoint notificaties sturen wanneer bepaalde events plaatsvinden. Configureer webhooks in het Dashboard onder Instellingen → Webhooks.

post.published

Een post is gepubliceerd op een platform

post.failed

Een post kon niet worden gepubliceerd

lead.captured

Een nieuwe lead is binnengekomen via de chatbot

content.generated

Nieuwe AI-content is gegenereerd en klaar voor review

analytics.report

Wekelijks analytics rapport beschikbaar

Foutcodes

HTTP Status	Code	Betekenis
200	OK	Verzoek succesvol verwerkt
201	Created	Resource succesvol aangemaakt
400	Bad Request	Verzoek bevat onjuiste parameters
401	Unauthorized	Ongeldige of ontbrekende API-sleutel
429	Too Many Requests	Rate limit overschreden
500	Server Error	Interne serverfout — probeer opnieuw

SDK's & Libraries

Gebruik een van onze officiële SDK's voor een snellere integratie:

Python SDK

pip install greet-sdk

GitHub →

Node.js SDK

npm install @greet/sdk

GitHub →

Vragen over de API?

Neem contact op met ons developer team via api@heygreet.nl of join onze Developer Slack community.