# Post Data Fields

Every element of the `posts` array has the same structure across news, blogs, and forums - only the values differ by content type. This page lists the fields as they apply to Forums API results.

A complete post as the Forums API returns it (long values truncated):

```json
{
  "thread": {
    "uuid": "8c6292ea6cd2b6f200049f792a4eafab4ae22b6f",
    "url": "https://community.home-assistant.io/t/1018908",
    "site_full": "community.home-assistant.io",
    "site": "home-assistant.io",
    "site_section": "https://community.home-assistant.io/",
    "site_categories": [
      "tech"
    ],
    "section_title": "Home Assistant Community",
    "site_title": "Home Assistant Community",
    "title": "",
    "title_full": "",
    "published": "2026-07-27T13:17:00.000+03:00",
    "replies_count": 0,
    "participants_count": 1,
    "site_type": "discussions",
    "country": "US",
    "main_image": "",
    "performance_score": 0,
    "domain_rank": 2513,
    "domain_rank_updated": null,
    "social": {
      "facebook": {
        "shares": 0,
        "likes": 0,
        "comments": 0
      },
      "vk": {
        "shares": 0
      },
      "updated": null
    }
  },
  "uuid": "8c6292ea6cd2b6f200049f792a4eafab4ae22b6f",
  "url": "https://community.home-assistant.io/t/1018908",
  "ord_in_thread": 0,
  "author": "eltomato89",
  "published": "2026-07-27T13:17:00.000+03:00",
  "title": "",
  "text": "Energy Manager Card + Integration Hey there!\nI would like to share my personal project with you! Until now, I had not found an easy way to control my devices based on my pv surplus ...",
  "highlightText": "",
  "highlightTitle": "",
  "highlightThreadTitle": "",
  "language": "english",
  "sentiment": null,
  "ai_allow": true,
  "has_canonical": false,
  "external_links": [],
  "external_images": [],
  "internal_images": [],
  "entities": {
    "persons": [],
    "locations": [],
    "organizations": []
  },
  "rating": null,
  "crawled": "2026-07-27T14:05:03.634+03:00",
  "updated": "2026-07-27T14:05:03.634+03:00"
}
```

## Post

| Field | Type | Description |
| --- | --- | --- |
| `uuid` | string | Unique id of the post |
| `url` | string | URL of the post |
| `title` | string | Post title |
| `text` | string | Full extracted text |
| `author` | string | Author name |
| `published` | string | Publication time, ISO 8601 |
| `crawled` | string | Time the post was crawled, ISO 8601 |
| `updated` | string | Time the post was last updated, ISO 8601 |
| `language` | string | Language name, e.g. `english` |
| `ord_in_thread` | integer | Position in the thread, `0` = original post |
| `external_links` | array | Links pointing outside the source site |
| `external_images` / `internal_images` | array | Image URLs |
| `rating` | number | Rating, when the source provides one |
| `ai_allow` | boolean | Content is licensed for AI use |
| `has_canonical` | boolean | Post has a canonical URL |
| `highlightText` / `highlightTitle` / `highlightThreadTitle` | string | Matched fragments, only with `highlight=true` |

## `thread`

The thread (article page or forum thread) the post belongs to.

| Field | Type | Description |
| --- | --- | --- |
| `uuid`, `url` | string | Thread id and URL |
| `site`, `site_full` | string | Source domain and full host |
| `site_section`, `section_title` | string | Site section |
| `site_title` | string | Name of the site |
| `site_type` | string | `discussions` - forum content is internally typed discussions |
| `site_categories` | array | Categories of the site |
| `title`, `title_full` | string | Thread title |
| `published` | string | Thread publication time |
| `country` | string | Source country code |
| `main_image` | string | Main image URL |
| `replies_count`, `participants_count` | integer | Thread activity |
| `domain_rank`, `domain_rank_updated` | integer | Domain rank and when it was updated |