/get/blog_post/{id} - Get article by ID

Overview

The /get/blog_post/{id} endpoint retrieves detailed information about a specific blog post or article by its ID.

Purpose

• Fetch complete article content and metadata
• Get article images and media
• Access author information
• Retrieve publication and modification dates

Endpoint

GET /get/blog_post/{id}

Parameters

Path parameters

id (string, required)

The article's composite ID in the format <site_id>_<wp_id>.

Format: {site_id}_{wordpress_id}

• site_id: The site/resort identifier (numeric)
• wordpress_id: The WordPress post ID (numeric)

Examples:

• id=1_12345 - Article with site_id=1 and WordPress ID=12345
• id=14_98765 - Article with site_id=14 and WordPress ID=98765

Validation: Must match the pattern {number}_{number}. Invalid formats will return an error.

---

Query parameters

sourceFields (string, optional)

Return only specific fields from the _source object using dot notation (comma-separated).

Purpose: Optimize response payload size by requesting only needed fields

Examples:

• sourceFields=title,description,date
• sourceFields=title,images,author
• sourceFields=title,description,video

---

Response format

Success response structure

{
  "_index": "fnugg_blog",
  "_type": "blog_post",
  "_id": "1_12345",
  "_version": 1,
  "found": true,
  "_source": {
    "title": "Guide til Trysil: Alt du trenger å vite",
    "description": "Komplett guide til Norges største alpinområde. Her får du alle tips og råd for en perfekt skiopplevelse i Trysil...",
    "images": [
      {
        "url": "https://example.com/article-image.jpg",
        "caption": "Fantastisk utsikt fra toppen",
        "width": 1920,
        "height": 1080
      }
    ],
    "video": {
      "url": "https://youtube.com/watch?v=abc123",
      "provider": "youtube",
      "thumbnail": "https://img.youtube.com/vi/abc123/maxresdefault.jpg"
    },
    "timezone": "Europe/Oslo",
    "date": "2024-11-01T10:30:00",
    "modified": "2024-11-05T14:20:00",
    "type": "blog_post",
    "site_id": "1",
    "id": 12345,
    "author": {
      "first_name": "Ole",
      "last_name": "Hansen",
      "name": "Ole Hansen"
    }
  }
}

Error response (invalid ID format)

{
  "error": "Invalid article ID. Must follow the format <resort_id>_<article_id>."
}

Error response (not found)

{
  "error": "Article with ID '1_99999' was not found.",
  "error_key": "article_not_found",
  "id": "1_99999"
}

---

Response fields

Top level fields

• _index (string): Index name, always "fnugg_blog"
• _type (string): Type name, always "blog_post"
• _id (string): Article's composite ID in format {site_id}_{wp_id}
• _version (integer): Document version, always 1
• found (boolean): Whether article was found, always true on success
• _source (object): The article data object

_source fields

Content

• title (string): Article headline/title
• description (string): Full article content (HTML or plain text)
• type (string): Content type, always "blog_post"

Identification

• id (integer): WordPress post ID (numeric part after underscore)
• site_id (string): Site/resort identifier (numeric part before underscore)

Media

• images (array): Article images

  • Each object may contain: url (string), caption (string), width (integer), height (integer)

• video (object	null): Embedded video information

  • provider (string): Video platform (e.g., "youtube", "vimeo")
  • thumbnail (string): Video thumbnail URL

Metadata

• date (string): Publication date (ISO 8601 format without Z)
• modified (string): Last modification date (ISO 8601 format without Z)
• timezone (string): Timezone identifier, always "Europe/Oslo"

Author

• author (object): Article author information
  • first_name (string|null): Author's first name
  • last_name (string|null): Author's last name
  • name (string|null): Author's full display name

---

Example requests

Get complete article

GET /get/blog_post/1_12345

Returns all fields for article with ID "1_12345".

---

Get article with specific fields only

GET /get/blog_post/1_12345?sourceFields=title,description,date,author

Returns only title, description, publication date, and author information.

---

Get article preview data

GET /get/blog_post/14_98765?sourceFields=title,description,images,date

Returns data suitable for article previews/cards (title, excerpt, image, date).

---

Get article media

GET /get/blog_post/1_12345?sourceFields=images,video

Returns only media assets (images and video).

---

Use cases

1. Display article detail page: Fetch complete article data for full article view
2. Article preview cards: Use sourceFields=title,description,images,date for list views
3. Social media sharing: Use sourceFields=title,description,images for metadata
4. RSS/feed generation: Use sourceFields=title,description,date,author for feed items
5. Search results: Use sourceFields=title,description for search result snippets
6. Related articles: Fetch multiple articles with filtered fields for sidebar recommendations

---

Notes

• The id parameter must follow the format {number}_{number} (e.g., "1_12345")
• Invalid ID formats (missing underscore, non-numeric parts) will return a 200 status with error message
• Articles not found will return a 200 status with error object
• The date and modified fields use ISO 8601 format without the trailing "Z" (unlike resort dates)
• The timezone field is always "Europe/Oslo" for consistency
• The images array may be empty if the article has no images
• The video field is null if no video is embedded
• The description field may contain HTML markup depending on the source content
• The author object fields (first_name, last_name) may be null if author information is not available
• The sourceFields parameter uses dot notation to access nested fields (e.g., author.first_name)