SeoMetadata
SEO fields: per-language meta tags, Open Graph, Twitter cards, canonical config, and schema.org
The seoMetadata object on a TRCItem carries search-engine and social-sharing metadata. It supports per-language SEO details, canonical URL configuration, and a read-only schema.org JSON-LD block.
Structure
{
"seoMetadata": {
"seoDetails": [
{
"lang": "nl",
"metaTitle": "Koningsdag Festival — Amsterdam",
"metaDescription": "Het grootste Koningsdag festival...",
"ogImage": "https://example.com/og-image.jpg",
"ogType": "event",
"twitterCardType": "summary_large_image"
},
{
"lang": "en",
"metaTitle": "King's Day Festival — Amsterdam",
"metaDescription": "The largest King's Day festival...",
"ogImage": "https://example.com/og-image-en.jpg",
"ogType": "event",
"twitterCardType": "summary_large_image"
}
],
"canonical": {
"canonicalUrl": "https://example.com/events/kings-day",
"useCanonical": true
},
"schemaOrgJsonLd": "{\"@context\":\"https://schema.org\",...}"
}
}SeoDetail
One entry per language. Each carries:
| Field | Type | Description |
|---|---|---|
lang | string | Language code |
metaTitle | string | Page title for search engines |
metaDescription | string | Meta description |
ogImage | string | Open Graph image URL |
ogType | string | Open Graph type (e.g., event, place, website) |
twitterCardType | string | Twitter card type: summary, summary_large_image, app, player |
CanonicalConfig
Controls the canonical URL for SEO:
| Field | Type | Description |
|---|---|---|
canonicalUrl | string | The preferred URL for this item |
useCanonical | boolean | Whether to emit a canonical link tag |
schemaOrgJsonLd (Read-Only)
The schemaOrgJsonLd field is a read-only string computed by the API from the TRCItem's existing data. It contains a JSON-LD structured data block conforming to schema.org.
Do not attempt to write to schemaOrgJsonLd — it is computed by the API and any value you send will be ignored.
The API builds the JSON-LD from the item's title, description, dates (from Calendar), location, images, and other fields. This means the structured data stays in sync with the item's content without manual maintenance.
See the API Reference for the full SeoMetadata schema.