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):
{
"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"
}| 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 |
threadThe 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 |