# 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 Blogs API results.

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

```json
{
  "thread": {
    "uuid": "e325dd7f05da88824db8329a57434dba8a1b13b5",
    "url": "https://advancedenergyunited.org/blog/getting-the-vpp-pilot-program-just-right-in-virginia/",
    "site_full": "advancedenergyunited.org",
    "site": "advancedenergyunited.org",
    "site_section": "https://advancedenergyunited.org/blog",
    "site_categories": [],
    "section_title": "Advanced Energy Perspectives – Advanced Energy United",
    "site_title": "Advanced Energy United",
    "title": "Getting the VPP Pilot Program 'Just Right' in Virginia - Advanced Energy United",
    "title_full": "Getting the VPP Pilot Program 'Just Right' in Virginia - Advanced Energy United",
    "published": "2026-07-21T22:18:00.000+03:00",
    "replies_count": 0,
    "participants_count": 1,
    "site_type": "blogs",
    "country": "US",
    "main_image": "https://advancedenergyunited.org/wp-content/uploads/2026/07/VA-VPP-Blog.png",
    "performance_score": 0,
    "domain_rank": null,
    "domain_rank_updated": null,
    "social": {
      "facebook": {
        "shares": 0,
        "likes": 0,
        "comments": 0
      },
      "vk": {
        "shares": 0
      },
      "updated": "2026-07-25T10:29:06.427+03:00"
    }
  },
  "uuid": "e325dd7f05da88824db8329a57434dba8a1b13b5",
  "url": "https://advancedenergyunited.org/blog/getting-the-vpp-pilot-program-just-right-in-virginia/",
  "ord_in_thread": 0,
  "author": "Echo Stewart",
  "published": "2026-07-21T22:18:00.000+03:00",
  "title": "Getting the VPP Pilot Program 'Just Right' in Virginia - Advanced Energy United",
  "text": "In 2025, the Virginia General Assembly passed the Community Energy Act on a bipartisan basis, and shortly afterwards it was signed into law by then-Governor Glenn Youngkin. Advance ...",
  "highlightText": "",
  "highlightTitle": "",
  "highlightThreadTitle": "",
  "language": "english",
  "sentiment": null,
  "ai_allow": true,
  "has_canonical": false,
  "external_links": [
    "https://lis.virginia.gov/bill-details/20251/SB1100/text/SB1100"
  ],
  "external_images": [],
  "internal_images": [],
  "entities": {
    "persons": [],
    "locations": [],
    "organizations": []
  },
  "crawled": "2026-07-25T10:29:06.427+03:00",
  "updated": "2026-07-25T10:29:06.427+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 |
| `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 | `news`, `blogs`, or `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 |
| `domain_rank`, `domain_rank_updated` | integer | Domain rank and when it was updated |

## `entities`

Named entities mentioned in the post, each with a `sentiment` (`positive`, `negative`, `neutral`, or `none`).

| Field | Description |
| --- | --- |
| `persons` | `{ "name", "sentiment" }` |
| `locations` | `{ "name", "sentiment" }` |
| `organizations` | `{ "name", "sentiment", "tickers": [{ "ticker", "exchange" }] }` |