Filter comments | Dialogue API

Returns a paginated, filtered slice of the corpus sorted by like count descending. Combine filters freely — all active filters are ANDed together. Use for quantitative analysis or bulk export of a segment.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

emotional_registerenumOptional

Filter to a single emotional tone.

life_stageenumOptional

Filter to a single life stage.

productstringOptional

Filter to comments mentioning this product (e.g. mortgage, pension_sipp, life_insurance).

signalstringOptional

Filter to comments containing this behavioural signal (e.g. protection_gap_described, broker_distrust).

min_likesintegerOptional>=0Defaults to 0

Only return comments with at least this many likes.

limitintegerOptional1-100Defaults to 20

Maximum number of comments to return (1–100).

offsetintegerOptional>=0Defaults to 0

Pagination offset.

Response

Paginated list of comments

resultslist of objects

paginationobject

Errors

500

Internal Server Error

1	{
2	"results": [
3	{
4	"comment_id": "Ugx0Okov_YDfLTae95V4AaABAg",
5	"text": "Got my first home about 18 months ago. Took me 14 years to save for the deposit...",
6	"like_count": 494,
7	"video_title": "Should You Buy or Rent in 2025?",
8	"emotional_register": "pride_accomplishment",
9	"life_stage": "first_home_buyer",
10	"life_event": [
11	"first_home_purchase"
12	],
13	"product_named": [
14	"mortgage"
15	],
16	"signals": [
17	"post_purchase_decision_point"
18	]
19	}
20	],
21	"pagination": {
22	"limit": 20,
23	"offset": 0,
24	"next_offset": 20
25	}
26	}

$	curl https://api.dialogue-ai.co/v1/filter \
>	-H "Authorization: Bearer <token>"