Bijgewerkt 22 april 2026
/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();Artikeldetails
Haal alle details op van een specifiek artikel aan de hand van de slug.
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). Stelt de locale in voor de response. |
include_media | boolean | true | Uitgelichte afbeeldings-URL's meenemen |
Responsevelden
Het detail-endpoint retourneert alle velden van het lijstendpoint, plus:
| Veld | Type | Beschrijving | |
|---|---|---|---|
body | string | Volledige artikeltekst (HTML) | |
meta_title | string\ | null | SEO-metatitel |
meta_description | string\ | null | SEO-metabeschrijving |
structured_data | object | 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
}
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 taalinstelling
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"]
}
}
}
Opmerkingen
- De
views_countwordt bij elk verzoek aan dit endpoint opgehoogd - Alleen gepubliceerde artikelen op het
website-kanaal zijn toegankelijk - Het artikel wordt opgezocht aan de hand van de slug van de content (taalspecifieke slugs)
- Uitgelichte afbeeldingen worden altijd meegeleverd in de detailweergave
- Het veld
structured_databiedt kant-en-klare Schema.org JSON-LD voor SEO - Gebruik het veld
available_languagesom andere taalversies en bijbehorende slugs te ontdekken