---
title: "Comment data model"
url: "https://docs.unified.to/social/comment/model"
description: "The Comment data model object in Unified's Comment API: 13 fields, including created_at, updated_at and post_id, with types and enum values."
date: "2026-11-09T23:41:55.096Z"
updated: "2026-11-09T23:41:55.096Z"
---
# Comment data model

Updated: November 9, 2026

 View field support, webhooks, and list parameters for each integration on the [Supported Integrations](https://docs.unified.to/social/integrations.md) page. 

| Field                | Type               | Required | Description                                                                                             |
| -------------------- | ------------------ | -------- | ------------------------------------------------------------------------------------------------------- |
| id                   | string             | No       | Unique identifier for the comment                                                                       |
| created\_at          | string (date-time) | No       | When the comment was posted (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)                                    |
| updated\_at          | string (date-time) | No       | When the comment was last edited, when the provider reports it (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) |
| post\_id             | string             | No       | The post (or video) the comment belongs to                                                              |
| parent\_id           | string             | No       | Set when this comment is a reply; the id of the comment being replied to                                |
| author\_identifier   | string             | No       | Provider id of the commenter (not a Unified id)                                                         |
| author\_name         | string             | No       | Display name of the commenter                                                                           |
| author\_username     | string             | No       | Handle / username of the commenter                                                                      |
| author\_avatar\_url  | string             | No       | Avatar URL of the commenter                                                                             |
| content              | string             | No       | The comment text                                                                                        |
| url                  | string             | No       | Permalink to the comment, when available                                                                |
| is\_hidden           | boolean            | No       | True if the comment is hidden or held for moderation                                                    |
| metrics              | object             | No       |                                                                                                         |
| metrics.like\_count  | number             | No       | Number of likes on the comment                                                                          |
| metrics.reply\_count | number             | No       | Number of replies to the comment                                                                        |

## TypeScript

```typescript
export type SocialComment = {
	id?: string; // Unique identifier for the comment
	created_at?: string-time; // When the comment was posted (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
	updated_at?: string-time; // When the comment was last edited, when the provider reports it (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
	post_id?: string; // The post (or video) the comment belongs to
	parent_id?: string; // Set when this comment is a reply; the id of the comment being replied to
	author_identifier?: string; // Provider id of the commenter (not a Unified id)
	author_name?: string; // Display name of the commenter
	author_username?: string; // Handle / username of the commenter
	author_avatar_url?: string; // Avatar URL of the commenter
	content?: string; // The comment text
	url?: string; // Permalink to the comment, when available
	is_hidden?: boolean; // True if the comment is hidden or held for moderation
	metrics?: {
		like_count?: number; // Number of likes on the comment 
		reply_count?: number; // Number of replies to the comment 
	};
	raw?: any; // Raw data from integration
} 
```

## Zod

```typescript
import { z } from 'zod';

export const ZodSocialComment = z.object({
	id: z.string().optional().describe("Unique identifier for the comment"),
	created_at: z.string-time().optional().describe("When the comment was posted (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)"),
	updated_at: z.string-time().optional().describe("When the comment was last edited, when the provider reports it (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)"),
	post_id: z.string().optional().describe("The post (or video) the comment belongs to"),
	parent_id: z.string().optional().describe("Set when this comment is a reply; the id of the comment being replied to"),
	author_identifier: z.string().optional().describe("Provider id of the commenter (not a Unified id)"),
	author_name: z.string().optional().describe("Display name of the commenter"),
	author_username: z.string().optional().describe("Handle / username of the commenter"),
	author_avatar_url: z.string().optional().describe("Avatar URL of the commenter"),
	content: z.string().optional().describe("The comment text"),
	url: z.string().optional().describe("Permalink to the comment, when available"),
	is_hidden: z.boolean().optional().describe("True if the comment is hidden or held for moderation"),
	metrics: z.object({
			like_count: z.number().optional().describe("Number of likes on the comment"),
			reply_count: z.number().optional().describe("Number of replies to the comment")
}).optional(),

});
```

## Python

```python
import dataclasses

@dataclasses.dataclass
class PropertySocialCommentMetrics:
	"""Number of likes on the comment"""
	like_count: Optional[int]
	"""Number of replies to the comment"""
	reply_count: Optional[int]

@dataclasses.dataclass
class SocialComment:
	"""Unique identifier for the comment"""
	id: Optional[str]
	"""When the comment was posted (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)"""
	created_at: Optional[str]
	"""When the comment was last edited, when the provider reports it (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)"""
	updated_at: Optional[str]
	"""The post (or video) the comment belongs to"""
	post_id: Optional[str]
	"""Set when this comment is a reply; the id of the comment being replied to"""
	parent_id: Optional[str]
	"""Provider id of the commenter (not a Unified id)"""
	author_identifier: Optional[str]
	"""Display name of the commenter"""
	author_name: Optional[str]
	"""Handle / username of the commenter"""
	author_username: Optional[str]
	"""Avatar URL of the commenter"""
	author_avatar_url: Optional[str]
	"""The comment text"""
	content: Optional[str]
	"""Permalink to the comment, when available"""
	url: Optional[str]
	"""True if the comment is hidden or held for moderation"""
	is_hidden: Optional[bool]
	metrics: Optional[PropertySocialCommentMetrics]

```