List LINE Audiences
line_list_audiencesList audience groups on your LINE Official Account. Filter by status or name to find audiences ready for narrowcast campaigns.
Instructions
List audience groups on the OA. Audiences created via LINE OA Manager UI (e.g. chat-tag audiences, friend-path audiences, web-traffic audiences) also appear here — even though those types cannot be CREATED via Messaging API.
Status meanings:
READY: usable in narrowcast immediately
IN_PROGRESS: still indexing — wait ~10 minutes
FAILED: creation failed; recreate
EXPIRED: aged out; recreate
Args:
status_filter: 'all' (default) | 'READY' | 'IN_PROGRESS' | 'FAILED' | 'EXPIRED'.
name_contains: optional substring filter (case-insensitive).
limit, page: pagination (default 20/page).
oa: optional OA id.
Returns: { total: number, count: number, page: number, audiences: [{ audience_group_id, name, status, audience_count?, created, type? }], has_more: boolean }
Examples:
"ดู audience ที่พร้อมส่ง" → { status_filter: "READY" }
"หา audience ชื่อ vip" → { name_contains: "vip" }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status_filter | No | Filter audiences by readiness status. Default 'all'. | all |
| name_contains | No | Optional substring filter on audience name (case-insensitive). | |
| limit | No | Page size (max 100). | |
| page | No | Page number (1-indexed). | |
| oa | No | ||
| response_format | No | markdown |