Bijgewerkt 15 juni 2026
GET
/api/v1/articles/{slug}
curl -X GET \
"https://app.recruitsome.com/api/v1/articles/{slug}" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json"const response = await fetch('https://app.recruitsome.com/api/v1/articles/{slug}', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Accept': 'application/json',
},
});
const data = await response.json();
console.log(data);use Illuminate\Support\Facades\Http;
$response = Http::withToken('YOUR_API_KEY')
->acceptJson()
->get('https://app.recruitsome.com/api/v1/articles/{slug}');
$data = $response->json();Haal alle details op van een specifiek artikel aan de hand van de slug.
Authenticatie
Vereist een API sleutel met de articles:read scope (inbegrepen in het Carrièrewebsite-preset). Aanroepen met een sleutel zonder deze scope retourneren een 403 met foutcode INSUFFICIENT_SCOPE.
Endpoint
GET /api/v1/articles/{slug}Padparameters
| Parameter | Type | Beschrijving |
|---|---|---|
slug | string | De slug van de artikelcontent (URL-vriendelijke identifier) |
Queryparameters
| Parameter | Type | Standaard | Beschrijving |
|---|---|---|---|
language | string | - | ISO 639-1 taalcode (bijv. nl, en). Bepaalt de taal van het antwoord. |
Het detail-endpoint bevat altijd de uitgelichte afbeelding. De parameter include_media van het lijstendpoint wordt hier wel geaccepteerd, maar heeft geen effect.
Responsvelden
Het detail-endpoint retourneert alle velden van het lijst-endpoint, plus:
| Veld | Type | Beschrijving |
|---|---|---|
body | string | Volledige artikeltekst (HTML) |
meta_title | string|null | SEO-metatitel |
meta_description | string|null | SEO-metabeschrijving |
structured_data | object|null | Schema.org NewsArticle gestructureerde data voor SEO |
Structured Data Object
{
"@context": "https://schema.org",
"@type": "NewsArticle",
"headline": "Welcome to our team",
"description": "A warm welcome to our new colleagues.",
"datePublished": "2026-02-01T09:00:00+00:00",
"author": {
"@type": "Person",
"name": "Jane Smith"
},
"wordCount": 450
}De author-sleutel binnen structured_data is null wanneer het artikel geen bekende auteur heeft.
Voorbeeldverzoek
Basisverzoek
curl -X GET "https://app.recruitsome.com/api/v1/articles/welkom-bij-ons-team-nl" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json"Met taal
curl -X GET "https://app.recruitsome.com/api/v1/articles/welcome-to-our-team-en?language=en" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json"Voorbeeldrespons
{
"data": {
"id": 1,
"slug": "welkom-bij-ons-team-nl",
"type": "news",
"title": "Welkom bij ons team",
"excerpt": "Een warm welkom aan onze nieuwe collega's die deze maand zijn gestart.",
"language": "nl",
"published_at": "2026-02-01T09:00:00+00:00",
"expires_at": null,
"views_count": 151,
"is_featured": true,
"estimated_reading_time": 3,
"featured_image": {
"original": "https://cdn.example.com/images/welcome.jpg",
"thumb": "https://cdn.example.com/images/welcome-thumb.jpg",
"medium": "https://cdn.example.com/images/welcome-medium.jpg"
},
"tags": [
{
"id": 1,
"name": "Bedrijfsnieuws",
"type": "main",
"parent_id": null
}
],
"author": {
"given_name": "Jane",
"family_name": "Smith",
"full_name": "Jane Smith",
"avatar": null
},
"available_languages": ["nl", "en"],
"body": "<h2>Welkom!</h2><p>We zijn verheugd om onze nieuwe collega's te verwelkomen...</p>",
"meta_title": "Welkom bij ons team | Bedrijfsnaam",
"meta_description": "Een warm welkom aan onze nieuwe collega's die deze maand zijn gestart bij ons bedrijf.",
"structured_data": {
"@context": "https://schema.org",
"@type": "NewsArticle",
"headline": "Welkom bij ons team",
"description": "Een warm welkom aan onze nieuwe collega's die deze maand zijn gestart.",
"datePublished": "2026-02-01T09:00:00+00:00",
"author": {
"@type": "Person",
"name": "Jane Smith"
},
"wordCount": 450
},
"metadata": {
"type_label": "Nieuws",
"channels": ["website", "employee_self_service"]
}
}
}Fouten
Niet gevonden 404
De meest voorkomende fout op dit endpoint. Wordt geretourneerd wanneer de slug niet bestaat, het artikel niet gepubliceerd is (concept of ingepland), het verlopen is, of het niet gepubliceerd is op het website-kanaal:
{
"message": "Resource not found."
}Authenticatie en autorisatie
| Status | Body | Wanneer |
|---|---|---|
401 | {"message": "Unauthenticated."} | Ontbrekende of ongeldige API sleutel |
403 | {"message": "This API key does not have the required permission: articles:read", "error": "INSUFFICIENT_SCOPE", "required_scope": "articles:read"} | API sleutel mist de articles:read scope |
Opmerkingen
- De
views_countwordt bij elk verzoek aan dit endpoint opgehoogd - Alleen gepubliceerde artikelen op het
website-kanaal zijn toegankelijk. Al het andere retourneert de hierboven genoemde404 - Het artikel wordt opgezocht aan de hand van de slug van de content (taalspecifieke slugs)
- Uitgelichte afbeeldingen worden altijd meegeleverd in de detailweergave.
include_mediaheeft hier geen effect - Het veld
structured_databevat kant-en-klare Schema.org JSON-LD voor SEO - Gebruik het veld
available_languagesom te ontdekken welke taalcodes er voor een artikel bestaan. Vraag het artikel vervolgens op met?language=. Dit veld bevat alleen codes, geen slugs