--- title: "Read the comments under one piece of content." method: POST path: "/comments" --- # Read the comments under one piece of content. `POST /comments` ## Request - Base URL: `https://api.socialtoai.com/v1` - URL: `https://api.socialtoai.com/v1/comments` - Auth: one of: - HTTP bearer - API key in header `X-API-Key` ## Headers - `Idempotency-Key` string - `Accept-Language` string ## Request body - object - `platform` union, required: One platform, or several: several are answered as cells, each charged on its own. - 'bilibili' | 'douyin' | 'facebook' | 'instagram' | 'kuaishou' | 'reddit' | 'tiktok' | 'wechat' | 'wechat_channels' | 'weibo' | 'x' | 'xiaohongshu' | 'youtube' | 'zhihu' - string[] - `id` union[] - union - string - integer - `reply_of` union[] - union - string - integer - `url` union[] - union - string - integer - `sort` union[] - union - string - integer - `cursor` string: page.cursor of the answer before, with the same request otherwise: the next page, charged as a call of its own. - `max_cost_credits` integer: The most this call may cost. Over it, the call is refused for free and the answer carries the quote. ## Response `200` The Envelope: flat for a request that falls on one cell, `cells` for one that falls on several. A cell that failed is still answered under 200, with its status and error, and costs 0. - union - Envelope - `request_id` string, required - `schema_version` 'v1', required - `fetched_at` string, date-time, required - `action` 'search' | 'trending' | 'detail' | 'comments' | 'user_profile' | 'user_posts' | 'call', required - `op` string - `billing` Billing, required - `cost_credits` integer, required - `balance_credits` integer, required - `today_spend_credits` integer, required - `daily_limit_credits` integer, nullable, required - `daily_remaining_credits` integer, nullable, required - `display` string, required - `replayed` boolean, required - `replayed_cost_credits` integer - `platform` string, required - `target` string - `status` 'ok' | 'empty' | 'error' | 'not_supported' | 'timeout' | 'skipped', required - `reason` string - `items` Object[], required - union - Content - `platform` string, required - `id` string, nullable, required - `ref` string, nullable, required - `approx` object[], required - `field` string, required - `kind` 'approximate' | 'lower_bound', required - `type` 'content', required - `url` string, nullable, required - `format` 'video' | 'image' | 'text' | 'article', nullable, required - `title` string, nullable, required - `text` string, nullable, required - `published_at` string, date-time, nullable, required - `author` object, nullable, required - `id` string, nullable, required - `username` string, nullable, required - `name` string, nullable, required - `verified` boolean, nullable, required - `followers` integer, nullable, required - `metrics` object, required - `likes` integer, nullable, required - `comments` integer, nullable, required - `shares` integer, nullable, required - `collects` integer, nullable, required - `views` integer, nullable, required - `reposts` integer, nullable, required - `images` string[], nullable, required - `hashtags` string[], nullable, required - `is_pinned` boolean, nullable, required - Account - `platform` string, required - `id` string, nullable, required - `ref` string, nullable, required - `approx` object[], required - `field` string, required - `kind` 'approximate' | 'lower_bound', required - `type` 'account', required - `username` string, nullable, required - `name` string, nullable, required - `url` string, nullable, required - `bio` string, nullable, required - `verified` boolean, nullable, required - `followers` integer, nullable, required - `following` integer, nullable, required - `posts_count` integer, nullable, required - Comment - `platform` string, required - `id` string, nullable, required - `ref` string, nullable, required - `approx` object[], required - `field` string, required - `kind` 'approximate' | 'lower_bound', required - `type` 'comment', required - `url` string, nullable, required - `text` string, nullable, required - `published_at` string, date-time, nullable, required - `author` object, required - `label` string, required - `metrics` object, required - `likes` integer, nullable, required - `reply_count` integer, nullable, required - `content_id` string, nullable, required - `parent_id` string, nullable, required - `root_id` string, nullable, required - union - object - `platform` string, required - `id` string, nullable, required - `ref` string, nullable, required - `approx` object[], required - … - `type` 'entry', required - `entry_type` 'trend', required - `title` string, nullable, required - `url` string, nullable, required - `rank` integer, nullable, required - `heat` integer, nullable, required - `fields` object, required - object - `platform` string, required - `id` string, nullable, required - `ref` string, nullable, required - `approx` object[], required - … - `type` 'entry', required - `entry_type` 'transcript', required - `title` string, nullable, required - `url` string, nullable, required - `rank` integer, nullable, required - `heat` integer, nullable, required - `fields` object, required - … - object - `platform` string, required - `id` string, nullable, required - `ref` string, nullable, required - `approx` object[], required - … - `type` 'entry', required - `entry_type` 'creator_rates', required - `title` string, nullable, required - `url` string, nullable, required - `rank` integer, nullable, required - `heat` integer, nullable, required - `fields` object, required - … - object - `platform` string, required - `id` string, nullable, required - `ref` string, nullable, required - `approx` object[], required - … - `type` 'entry', required - `entry_type` 'community', required - `title` string, nullable, required - `url` string, nullable, required - `rank` integer, nullable, required - `heat` integer, nullable, required - `fields` object, required - … - object - `platform` string, required - `id` string, nullable, required - `ref` string, nullable, required - `approx` object[], required - … - `type` 'entry', required - `entry_type` 'product', required - `title` string, nullable, required - `url` string, nullable, required - `rank` integer, nullable, required - `heat` integer, nullable, required - `fields` object, required - … - object - `platform` string, required - `id` string, nullable, required - `ref` string, nullable, required - `approx` object[], required - … - `type` 'entry', required - `entry_type` 'review', required - `title` string, nullable, required - `url` string, nullable, required - `rank` integer, nullable, required - `heat` integer, nullable, required - `fields` object, required - … - object - `platform` string, required - `id` string, nullable, required - `ref` string, nullable, required - `approx` object[], required - … - `type` 'entry', required - `entry_type` 'keyword_history', required - `title` string, nullable, required - `url` string, nullable, required - `rank` integer, nullable, required - `heat` integer, nullable, required - `fields` object, required - … - object - `platform` string, required - `id` string, nullable, required - `ref` string, nullable, required - `approx` object[], required - … - `type` 'entry', required - `entry_type` 'keyword_related', required - `title` string, nullable, required - `url` string, nullable, required - `rank` integer, nullable, required - `heat` integer, nullable, required - `fields` object, required - … - object - `platform` string, required - `id` string, nullable, required - `ref` string, nullable, required - `approx` object[], required - … - `type` 'entry', required - `entry_type` 'keyword_audience', required - `title` string, nullable, required - `url` string, nullable, required - `rank` integer, nullable, required - `heat` integer, nullable, required - `fields` object, required - … - object - `platform` string, required - `id` string, nullable, required - `ref` string, nullable, required - `approx` object[], required - … - `type` 'entry', required - `entry_type` 'brand_history', required - `title` string, nullable, required - `url` string, nullable, required - `rank` integer, nullable, required - `heat` integer, nullable, required - `fields` object, required - … - object - `platform` string, required - `id` string, nullable, required - `ref` string, nullable, required - `approx` object[], required - … - `type` 'entry', required - `entry_type` 'brand_metrics', required - `title` string, nullable, required - `url` string, nullable, required - `rank` integer, nullable, required - `heat` integer, nullable, required - `fields` object, required - … - object - `platform` string, required - `id` string, nullable, required - `ref` string, nullable, required - `approx` object[], required - … - `type` 'entry', required - `entry_type` 'account_history', required - `title` string, nullable, required - `url` string, nullable, required - `rank` integer, nullable, required - `heat` integer, nullable, required - `fields` object, required - … - object - `platform` string, required - `id` string, nullable, required - `ref` string, nullable, required - `approx` object[], required - … - `type` 'entry', required - `entry_type` 'index_creator_metrics', required - `title` string, nullable, required - `url` string, nullable, required - `rank` integer, nullable, required - `heat` integer, nullable, required - `fields` object, required - … - object - `platform` string, required - `id` string, nullable, required - `ref` string, nullable, required - `approx` object[], required - … - `type` 'entry', required - `entry_type` 'creator', required - `title` string, nullable, required - `url` string, nullable, required - `rank` integer, nullable, required - `heat` integer, nullable, required - `fields` object, required - … - object - `platform` string, required - `id` string, nullable, required - `ref` string, nullable, required - `approx` object[], required - … - `type` 'entry', required - `entry_type` 'audience', required - `title` string, nullable, required - `url` string, nullable, required - `rank` integer, nullable, required - `heat` integer, nullable, required - `fields` object, required - … - object - `platform` string, required - `id` string, nullable, required - `ref` string, nullable, required - `approx` object[], required - … - `type` 'entry', required - `entry_type` 'xingtu_creator_metrics', required - `title` string, nullable, required - `url` string, nullable, required - `rank` integer, nullable, required - `heat` integer, nullable, required - `fields` object, required - … - object - `platform` string, required - `id` string, nullable, required - `ref` string, nullable, required - `approx` object[], required - … - `type` 'entry', required - `entry_type` 'xingtu_creator_post', required - `title` string, nullable, required - `url` string, nullable, required - `rank` integer, nullable, required - `heat` integer, nullable, required - `fields` object, required - … - object - `platform` string, required - `id` string, nullable, required - `ref` string, nullable, required - `approx` object[], required - … - `type` 'entry', required - `entry_type` 'pgy_creator_metrics', required - `title` string, nullable, required - `url` string, nullable, required - `rank` integer, nullable, required - `heat` integer, nullable, required - `fields` object, required - … - object - `platform` string, required - `id` string, nullable, required - `ref` string, nullable, required - `approx` object[], required - … - `type` 'entry', required - `entry_type` 'pgy_creator_post', required - `title` string, nullable, required - `url` string, nullable, required - `rank` integer, nullable, required - `heat` integer, nullable, required - `fields` object, required - … - object - `platform` string, required - `id` string, nullable, required - `ref` string, nullable, required - `approx` object[], required - … - `type` 'entry', required - `entry_type` 'xingtu_creator_keywords', required - `title` string, nullable, required - `url` string, nullable, required - `rank` integer, nullable, required - `heat` integer, nullable, required - `fields` object, required - … - object - `platform` string, required - `id` string, nullable, required - `ref` string, nullable, required - `approx` object[], required - … - `type` 'entry', required - `entry_type` 'xingtu_creator_scores', required - `title` string, nullable, required - `url` string, nullable, required - `rank` integer, nullable, required - `heat` integer, nullable, required - `fields` object, required - … - object - `platform` string, required - `id` string, nullable, required - `ref` string, nullable, required - `approx` object[], required - … - `type` 'entry', required - `entry_type` 'xingtu_creator_content_mix', required - `title` string, nullable, required - `url` string, nullable, required - `rank` integer, nullable, required - `heat` integer, nullable, required - `fields` object, required - … - object - `platform` string, required - `id` string, nullable, required - `ref` string, nullable, required - `approx` object[], required - … - `type` 'entry', required - `entry_type` 'xingtu_creator_conversion', required - `title` string, nullable, required - `url` string, nullable, required - `rank` integer, nullable, required - `heat` integer, nullable, required - `fields` object, required - … - object - `platform` string, required - `id` string, nullable, required - `ref` string, nullable, required - `approx` object[], required - … - `type` 'entry', required - `entry_type` 'xingtu_campaign', required - `title` string, nullable, required - `url` string, nullable, required - `rank` integer, nullable, required - `heat` integer, nullable, required - `fields` object, required - … - object - `platform` string, required - `id` string, nullable, required - `ref` string, nullable, required - `approx` object[], required - … - `type` 'entry', required - `entry_type` 'ad', required - `title` string, nullable, required - `url` string, nullable, required - `rank` integer, nullable, required - `heat` integer, nullable, required - `fields` object, required - … - object - `platform` string, required - `id` string, nullable, required - `ref` string, nullable, required - `approx` object[], required - … - `type` 'entry', required - `entry_type` 'advertiser', required - `title` string, nullable, required - `url` string, nullable, required - `rank` integer, nullable, required - `heat` integer, nullable, required - `fields` object, required - … - object - `platform` string, required - `id` string, nullable, required - `ref` string, nullable, required - `approx` object[], required - … - `type` 'entry', required - `entry_type` 'channels_collection', required - `title` string, nullable, required - `url` string, nullable, required - `rank` integer, nullable, required - `heat` integer, nullable, required - `fields` object, required - … - object - `platform` string, required - `id` string, nullable, required - `ref` string, nullable, required - `approx` object[], required - … - `type` 'entry', required - `entry_type` 'topic', required - `title` string, nullable, required - `url` string, nullable, required - `rank` integer, nullable, required - `heat` integer, nullable, required - `fields` object, required - … - `unavailable` string[], required - `page` object - `has_more` boolean, required - `cursor` string - `cursor_expires_at` string, date-time - `empty_reason` 'no_match' | 'filtered' - `warnings` object[], required - `code` string, required - `count` integer - `message` string, required - `applied_params` object, required - `includes` object - `cost_credits` integer, required - `error` Error - `code` string, required - `message` string, required - `retryable` boolean, required - `reason` string - `quote_credits` integer - `resets_at` string, date-time - `retry_at` string, date-time - `fix` object, required - `param` string - `allowed` unknown[] - unknown - `example_call` object - `action_url` string - `note` string - CellsEnvelope - `request_id` string, required - `schema_version` 'v1', required - `fetched_at` string, date-time, required - `action` 'search' | 'trending' | 'detail' | 'comments' | 'user_profile' | 'user_posts' | 'call', required - `op` string - `billing` Billing, required - `cost_credits` integer, required - `balance_credits` integer, required - `today_spend_credits` integer, required - `daily_limit_credits` integer, nullable, required - `daily_remaining_credits` integer, nullable, required - `display` string, required - `replayed` boolean, required - `replayed_cost_credits` integer - `status` 'ok' | 'empty' | 'error' | 'not_supported' | 'timeout' | 'skipped', required - `cells` Cell[], required - `platform` string, required - `target` string - `status` 'ok' | 'empty' | 'error' | 'not_supported' | 'timeout' | 'skipped', required - `reason` string - `items` Object[], required - union - Content - `platform` string, required - `id` string, nullable, required - `ref` string, nullable, required - `approx` object[], required - … - `type` 'content', required - `url` string, nullable, required - `format` 'video' | 'image' | 'text' | 'article', nullable, required - `title` string, nullable, required - `text` string, nullable, required - `published_at` string, date-time, nullable, required - `author` object, nullable, required - … - `metrics` object, required - … - `images` string[], nullable, required - `hashtags` string[], nullable, required - `is_pinned` boolean, nullable, required - Account - `platform` string, required - `id` string, nullable, required - `ref` string, nullable, required - `approx` object[], required - … - `type` 'account', required - `username` string, nullable, required - `name` string, nullable, required - `url` string, nullable, required - `bio` string, nullable, required - `verified` boolean, nullable, required - `followers` integer, nullable, required - `following` integer, nullable, required - `posts_count` integer, nullable, required - Comment - `platform` string, required - `id` string, nullable, required - `ref` string, nullable, required - `approx` object[], required - … - `type` 'comment', required - `url` string, nullable, required - `text` string, nullable, required - `published_at` string, date-time, nullable, required - `author` object, required - … - `metrics` object, required - … - `reply_count` integer, nullable, required - `content_id` string, nullable, required - `parent_id` string, nullable, required - `root_id` string, nullable, required - union - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - `unavailable` string[], required - `page` object - `has_more` boolean, required - `cursor` string - `cursor_expires_at` string, date-time - `empty_reason` 'no_match' | 'filtered' - `warnings` object[], required - `code` string, required - `count` integer - `message` string, required - `applied_params` object, required - `includes` object - `cost_credits` integer, required - `error` Error - `code` string, required - `message` string, required - `retryable` boolean, required - `reason` string - `quote_credits` integer - `resets_at` string, date-time - `retry_at` string, date-time - `fix` object, required - `param` string - `allowed` unknown[] - unknown - `example_call` object - `action_url` string - `note` string ## Other responses - `400`: invalid_params, not_supported - `401`: unauthorized - `402`: insufficient_balance, max_cost_exceeded - `403`: plan_limit, key_scope_denied - `409`: idempotency_in_progress - `422`: idempotency_conflict - `429`: daily_limit_reached, free_failure_limit, rate_limited - `500`: internal_error - `503`: temporarily_unavailable --- [API](https://skmtc.dev/socialtoai/apis/socialtoai-api.md) · [All operations](https://skmtc.dev/socialtoai/apis/socialtoai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/socialtoai/apis/socialtoai-api/revisions/f46bb0989cc8?raw)