字段与选项

有些服务除了链接和数量，还需要更多信息。本页列出每个额外字段、其限制、数量如何确定，以及 Telegram 反应如何发送。

字段如何工作

每个服务都会在 fields 中列出它接受的字段（见列出服务）。在同一个 add 请求中按各自的 key 发送。字段属于下列类型之一。行列表是每行一项，以换行符分隔。

字段类型

integer: 在所示限制内的整数。
text: 不超过所示长度的短文本。
lines: 每行一项的列表。空行会被丢弃。
choice: 固定列表中的一个值。
url: 以 http:// 或 https:// 开头的链接。
reactions: Telegram 反应，可混合或指定精确数量。见 Telegram 反应。

把已知字段发送给不提供它的服务，会被 OPTION_NOT_SUPPORTED 拒绝。缺少必填字段会返回 MISSING_PARAMETER，超出限制的值会返回 INVALID_OPTION。以上都在扣费之前检查。未知参数会被忽略。

400
OPTION_NOT_SUPPORTED
This service does not accept {param}
该服务不接受你发送的某个字段。请先修正请求。
400
MISSING_PARAMETER
Missing required parameter: {param}
缺少必填参数。details.param 指明了它。请先修正请求。
400
INVALID_OPTION
Invalid {param}: {rule}
某个额外字段的值无效。details.param 和 details.rule 说明是哪个以及原因。请先修正请求。

按服务类型划分的字段与数量

type_key 告诉你该发送哪些字段。基于你发送的列表工作的类型（自定义评论、评论回复和自定义用户名列表）自行决定数量：即行数，不同的 quantity 会被 QUANTITY_MISMATCH 拒绝。如果省略 quantity，系统会替你计算。

服务类型及其字段和数量规则
type_key	字段	数量
default	–	从服务最小值到最大值之间的任意数量，须为其步长（step）的倍数。
package	–	由服务固定。请省略数量。
seo	keywords	从服务最小值到最大值之间的任意数量，须为其步长（step）的倍数。
custom_comments	comments	列表中的行数。可以省略数量。
custom_comments_package	comments	由服务固定。请省略数量。
mentions	usernames	从服务最小值到最大值之间的任意数量，须为其步长（step）的倍数。
mentions_with_hashtags	usernames, hashtags	从服务最小值到最大值之间的任意数量，须为其步长（step）的倍数。
mentions_custom_list	usernames	列表中的行数。可以省略数量。
mentions_hashtag	hashtag	从服务最小值到最大值之间的任意数量，须为其步长（step）的倍数。
mentions_user_followers	username	从服务最小值到最大值之间的任意数量，须为其步长（step）的倍数。
mentions_media_likers	media	从服务最小值到最大值之间的任意数量，须为其步长（step）的倍数。
comment_likes	username	从服务最小值到最大值之间的任意数量，须为其步长（step）的倍数。
poll	answer_number	从服务最小值到最大值之间的任意数量，须为其步长（step）的倍数。
comment_replies	comments, username	列表中的行数。可以省略数量。
invites_from_groups	groups	从服务最小值到最大值之间的任意数量，须为其步长（step）的倍数。
web_traffic	country, device, type_of_traffic, google_keyword, referring_url	从服务最小值到最大值之间的任意数量，须为其步长（step）的倍数。

请求

key=YOUR_API_KEY&action=add&service=31&link=https://instagram.com/example/p/abc123&comments=Great shot!%0ALove the colors%0ASo clean

响应200 OK

{
  "order": 1234573,
  "status": "Pending",
  "status_key": "pending",
  "charge": "0.27",
  "currency": "USD",
  "instant_cancel_until": "2026-10-03T10:00:15Z",
  "cancel_available": true,
  "cancel_window_seconds": 15,
  "cancel_before": "2026-10-03T10:00:15Z"
}

精确反应的工作方式相同：数量是各计数之和。如果你发送的 quantity 与该总和不同，请求会被 QUANTITY_MISMATCH 拒绝。

全部字段

名称即你发送的字段名。被多个类型使用的字段只有一个名称：username 在评论点赞和评论回复中是评论作者，在粉丝提及中是目标账户。

额外字段

commentslines必需: 你的评论，每行一条。1 到 10000 行，每行最多 500 个字符 · 使用者： custom_comments, custom_comments_package, comment_replies
usernameslines必需: 要提及的用户名，每行一个。开头的 @ 会被去除。1 到 10000 行，每行最多 64 个字符 · 使用者： mentions, mentions_with_hashtags, mentions_custom_list
hashtagslines必需: 要使用的话题标签，每行一个。开头的 # 会被去除。1 到 1000 行，每行最多 100 个字符 · 使用者： mentions_with_hashtags
hashtagtext必需: 要定向其发帖者的话题标签。最多 100 个字符 · 使用者： mentions_hashtag
usernametext必需: 要定向其粉丝的账户。用户名或主页链接。最多 255 个字符 · 使用者： mentions_user_followers
mediaurl必需: 要定向其点赞者的帖子。最多 2048 个字符 · 使用者： mentions_media_likers
usernametext必需: 评论作者的用户名。最多 64 个字符 · 使用者： comment_likes, comment_replies
answer_numberinteger必需: 要投票的投票选项编号。1 到 100 的整数 · 使用者： poll
keywordslines必需: 搜索关键词，每行一个。1 到 1000 行，每行最多 255 个字符 · 使用者： seo
groupslines必需: 群组链接，每行一个。1 到 1000 行，每行最多 2048 个字符 · 使用者： invites_from_groups
countrytext可选: 国家，使用两位 ISO 3166-1 代码，例如 US。最多 2 个字符 · 使用者： web_traffic
devicechoice可选: 访问所用的设备类型。desktop · android · ios · mobile_mixed · all_mixed · 使用者： web_traffic
type_of_trafficchoice可选: 访问的来源。默认值为 direct。google_search · referrer · direct · 使用者： web_traffic
google_keywordtext取决于服务类型: Google 搜索关键词。当 type_of_traffic 为 google_search 时必填。最多 255 个字符 · 使用者： web_traffic
referring_urlurl取决于服务类型: 访问来源页面。当 type_of_traffic 为 referrer 时必填。最多 2048 个字符 · 使用者： web_traffic
reactionsreactions可选: Telegram 反应，可混合或指定精确数量。见 Telegram 反应。使用者：在 fields 中列出它的服务
last_postsinteger必需: 要覆盖频道最新的多少篇帖子。对这些服务，链接是频道的用户名。10 到 500 的整数 · 使用者：在 fields 中列出它的服务

网站流量字段相互依赖：当 type_of_traffic 为 google_search 时需要 google_keyword，为 referrer 时需要 referring_url。缺失时返回 MISSING_PARAMETER。

Telegram 反应

Telegram 接受 73 种反应表情符号，每篇帖子最多 11 种不同的反应。带 reactions 字段的服务以一个文本值接收它们，超出允许集合的任何内容会在扣费之前被拒绝。请在请求中以纯文本发送表情符号。

发送反应的两种方式

👍,❤️,🔥mix: 表情符号列表。我们把 quantity 分摊到这些表情上，因此 quantity 必填。
👍:60,❤️:40exact: 每个表情符号附带各自的数量，为不小于 1 的整数。总数量即这些数量之和，因此 quantity 可选；如果发送，它必须等于该总和。

请求

key=YOUR_API_KEY&action=add&service=12&link=https://t.me/example/42&quantity=500&reactions=👍,❤️,🔥

响应200 OK

{
  "order": 1234571,
  "status": "Pending",
  "status_key": "pending",
  "charge": "0.45",
  "currency": "USD",
  "instant_cancel_until": "2026-10-03T10:00:15Z",
  "cancel_available": true,
  "cancel_window_seconds": 15,
  "cancel_before": "2026-10-03T10:00:15Z"
}

请求

key=YOUR_API_KEY&action=add&service=12&link=https://t.me/example/42&reactions=👍:60,❤️:40

响应200 OK

{
  "order": 1234572,
  "status": "Pending",
  "status_key": "pending",
  "charge": "0.09",
  "currency": "USD",
  "instant_cancel_until": "2026-10-03T10:00:15Z",
  "cancel_available": true,
  "cancel_window_seconds": 15,
  "cancel_before": "2026-10-03T10:00:15Z"
}

只有在目标频道中开启了反应，反应才会送达。下单前请检查频道的设置。

73 种允许的反应

服务可能只允许更少的反应。其 fields 条目会在 allowed 中准确列出它接受的内容，并附带 max_distinct 和 modes。比较时会忽略变体选择符，因此带或不带它的爱心视为同一个表情符号。

👍
👎
❤️
🔥
🥰
👏
😁
🤔
🤯
😱
🤬
😢
🎉
🤩
🤮
💩
🙏
👌
🕊️
🤡
🥱
🥴
😍
🐳
❤️‍🔥
🌚
🌭
💯
🤣
⚡
🍌
🏆
💔
🤨
😐
🍓
🍾
💋
🖕
😈
😴
😭
🤓
👻
👨‍💻
👀
🎃
🙈
😇
😨
🤝
✍️
🤗
🫡
🎅
🎄
☃️
💅
🤪
🗿
🆒
💘
🙉
🦄
😘
💊
🙊
😎
👾
🤷‍♂️
🤷
🤷‍♀️
😡

反应错误

400
INVALID_OPTION
Invalid {param}: {rule}
某个额外字段的值无效。details.param 和 details.rule 说明是哪个以及原因。请先修正请求。
400
QUANTITY_MISMATCH
quantity must equal the number of items in {param} ({count})
数量与列表或反应字段中的项目数不一致。请先修正请求。
400
MISSING_PARAMETER
Missing required parameter: {param}
缺少必填参数。details.param 指明了它。请先修正请求。

请求

key=YOUR_API_KEY&action=add&service=12&link=https://t.me/example/42&quantity=100&reactions=🧿,👍

响应400 Bad Request

{
  "error": "Invalid reactions: unsupported_emoji",
  "error_code": "INVALID_OPTION",
  "retryable": false,
  "details": {
    "emoji": "🧿",
    "param": "reactions",
    "rule": "unsupported_emoji"
  }
}

规则词

INVALID_PARAMETER 和 INVALID_OPTION 带有一个简短的 details.rule，说明哪里出了问题。请先根据 error_code 分支处理，并把不认识的规则词当作通用的无效值，因为可能会新增规则词。

details.rule 中的规则词

must_be_integer: 需要整数。
too_small: 值低于允许的最小值。
too_large: 值高于允许的最大值。
too_long: 文本超过允许的长度。
bad_format: 值不是预期的格式。
not_allowed: 值不是允许的选项之一。
not_a_url: 值不是 http 或 https 链接。
too_few_lines: 列表的行数少于要求。
too_many_lines: 列表的行数超过允许值。
empty: 值为空。
unsupported_emoji: 某个反应不在该服务接受的范围内。details.emoji 会指明它。
too_many_emoji: 不同反应的数量超过服务允许的上限。
duplicate_emoji: 同一个反应出现了两次。
bad_count: 某个反应的数量不是不小于 1 的整数。
mixed_forms: 同一个值中混用了带数量和不带数量的反应。
line_too_long: 某一行超过允许的长度。
bad_length: 文本为空或超过允许的长度。
iso_country: 国家不是两位 ISO 3166-1 代码。
invalid_choice: 值不是允许的选项之一。
url: 值不是 http 或 https 链接。
between_1_and_100: 数字超出该字段的范围。该词会指明范围，例如 between_1_and_100。
between_10_and_500: 数字超出该字段的范围。该词会指明范围，例如 between_1_and_100。

下单

字段如何工作

字段类型

integer: 在所示限制内的整数。
text: 不超过所示长度的短文本。
lines: 每行一项的列表。空行会被丢弃。
choice: 固定列表中的一个值。
url: 以 http:// 或 https:// 开头的链接。
reactions: Telegram 反应，可混合或指定精确数量。见 Telegram 反应。

400
OPTION_NOT_SUPPORTED
This service does not accept {param}
该服务不接受你发送的某个字段。请先修正请求。
400
MISSING_PARAMETER
Missing required parameter: {param}
缺少必填参数。details.param 指明了它。请先修正请求。
400
INVALID_OPTION
Invalid {param}: {rule}
某个额外字段的值无效。details.param 和 details.rule 说明是哪个以及原因。请先修正请求。

按服务类型划分的字段与数量

服务类型及其字段和数量规则
type_key	字段	数量
default	–	从服务最小值到最大值之间的任意数量，须为其步长（step）的倍数。
package	–	由服务固定。请省略数量。
seo	keywords	从服务最小值到最大值之间的任意数量，须为其步长（step）的倍数。
custom_comments	comments	列表中的行数。可以省略数量。
custom_comments_package	comments	由服务固定。请省略数量。
mentions	usernames	从服务最小值到最大值之间的任意数量，须为其步长（step）的倍数。
mentions_with_hashtags	usernames, hashtags	从服务最小值到最大值之间的任意数量，须为其步长（step）的倍数。
mentions_custom_list	usernames	列表中的行数。可以省略数量。
mentions_hashtag	hashtag	从服务最小值到最大值之间的任意数量，须为其步长（step）的倍数。
mentions_user_followers	username	从服务最小值到最大值之间的任意数量，须为其步长（step）的倍数。
mentions_media_likers	media	从服务最小值到最大值之间的任意数量，须为其步长（step）的倍数。
comment_likes	username	从服务最小值到最大值之间的任意数量，须为其步长（step）的倍数。
poll	answer_number	从服务最小值到最大值之间的任意数量，须为其步长（step）的倍数。
comment_replies	comments, username	列表中的行数。可以省略数量。
invites_from_groups	groups	从服务最小值到最大值之间的任意数量，须为其步长（step）的倍数。
web_traffic	country, device, type_of_traffic, google_keyword, referring_url	从服务最小值到最大值之间的任意数量，须为其步长（step）的倍数。

请求

key=YOUR_API_KEY&action=add&service=31&link=https://instagram.com/example/p/abc123&comments=Great shot!%0ALove the colors%0ASo clean

响应200 OK

{
  "order": 1234573,
  "status": "Pending",
  "status_key": "pending",
  "charge": "0.27",
  "currency": "USD",
  "instant_cancel_until": "2026-10-03T10:00:15Z",
  "cancel_available": true,
  "cancel_window_seconds": 15,
  "cancel_before": "2026-10-03T10:00:15Z"
}

精确反应的工作方式相同：数量是各计数之和。如果你发送的 quantity 与该总和不同，请求会被 QUANTITY_MISMATCH 拒绝。

全部字段

名称即你发送的字段名。被多个类型使用的字段只有一个名称：username 在评论点赞和评论回复中是评论作者，在粉丝提及中是目标账户。

额外字段

commentslines必需: 你的评论，每行一条。1 到 10000 行，每行最多 500 个字符 · 使用者： custom_comments, custom_comments_package, comment_replies
usernameslines必需: 要提及的用户名，每行一个。开头的 @ 会被去除。1 到 10000 行，每行最多 64 个字符 · 使用者： mentions, mentions_with_hashtags, mentions_custom_list
hashtagslines必需: 要使用的话题标签，每行一个。开头的 # 会被去除。1 到 1000 行，每行最多 100 个字符 · 使用者： mentions_with_hashtags
hashtagtext必需: 要定向其发帖者的话题标签。最多 100 个字符 · 使用者： mentions_hashtag
usernametext必需: 要定向其粉丝的账户。用户名或主页链接。最多 255 个字符 · 使用者： mentions_user_followers
mediaurl必需: 要定向其点赞者的帖子。最多 2048 个字符 · 使用者： mentions_media_likers
usernametext必需: 评论作者的用户名。最多 64 个字符 · 使用者： comment_likes, comment_replies
answer_numberinteger必需: 要投票的投票选项编号。1 到 100 的整数 · 使用者： poll
keywordslines必需: 搜索关键词，每行一个。1 到 1000 行，每行最多 255 个字符 · 使用者： seo
groupslines必需: 群组链接，每行一个。1 到 1000 行，每行最多 2048 个字符 · 使用者： invites_from_groups
countrytext可选: 国家，使用两位 ISO 3166-1 代码，例如 US。最多 2 个字符 · 使用者： web_traffic
devicechoice可选: 访问所用的设备类型。desktop · android · ios · mobile_mixed · all_mixed · 使用者： web_traffic
type_of_trafficchoice可选: 访问的来源。默认值为 direct。google_search · referrer · direct · 使用者： web_traffic
google_keywordtext取决于服务类型: Google 搜索关键词。当 type_of_traffic 为 google_search 时必填。最多 255 个字符 · 使用者： web_traffic
referring_urlurl取决于服务类型: 访问来源页面。当 type_of_traffic 为 referrer 时必填。最多 2048 个字符 · 使用者： web_traffic
reactionsreactions可选: Telegram 反应，可混合或指定精确数量。见 Telegram 反应。使用者：在 fields 中列出它的服务
last_postsinteger必需: 要覆盖频道最新的多少篇帖子。对这些服务，链接是频道的用户名。10 到 500 的整数 · 使用者：在 fields 中列出它的服务

网站流量字段相互依赖：当 type_of_traffic 为 google_search 时需要 google_keyword，为 referrer 时需要 referring_url。缺失时返回 MISSING_PARAMETER。

Telegram 反应

发送反应的两种方式

👍,❤️,🔥mix: 表情符号列表。我们把 quantity 分摊到这些表情上，因此 quantity 必填。
👍:60,❤️:40exact: 每个表情符号附带各自的数量，为不小于 1 的整数。总数量即这些数量之和，因此 quantity 可选；如果发送，它必须等于该总和。

请求

key=YOUR_API_KEY&action=add&service=12&link=https://t.me/example/42&quantity=500&reactions=👍,❤️,🔥

响应200 OK

{
  "order": 1234571,
  "status": "Pending",
  "status_key": "pending",
  "charge": "0.45",
  "currency": "USD",
  "instant_cancel_until": "2026-10-03T10:00:15Z",
  "cancel_available": true,
  "cancel_window_seconds": 15,
  "cancel_before": "2026-10-03T10:00:15Z"
}

请求

key=YOUR_API_KEY&action=add&service=12&link=https://t.me/example/42&reactions=👍:60,❤️:40

响应200 OK

{
  "order": 1234572,
  "status": "Pending",
  "status_key": "pending",
  "charge": "0.09",
  "currency": "USD",
  "instant_cancel_until": "2026-10-03T10:00:15Z",
  "cancel_available": true,
  "cancel_window_seconds": 15,
  "cancel_before": "2026-10-03T10:00:15Z"
}

只有在目标频道中开启了反应，反应才会送达。下单前请检查频道的设置。

73 种允许的反应

👍
👎
❤️
🔥
🥰
👏
😁
🤔
🤯
😱
🤬
😢
🎉
🤩
🤮
💩
🙏
👌
🕊️
🤡
🥱
🥴
😍
🐳
❤️‍🔥
🌚
🌭
💯
🤣
⚡
🍌
🏆
💔
🤨
😐
🍓
🍾
💋
🖕
😈
😴
😭
🤓
👻
👨‍💻
👀
🎃
🙈
😇
😨
🤝
✍️
🤗
🫡
🎅
🎄
☃️
💅
🤪
🗿
🆒
💘
🙉
🦄
😘
💊
🙊
😎
👾
🤷‍♂️
🤷
🤷‍♀️
😡

反应错误

400
INVALID_OPTION
Invalid {param}: {rule}
某个额外字段的值无效。details.param 和 details.rule 说明是哪个以及原因。请先修正请求。
400
QUANTITY_MISMATCH
quantity must equal the number of items in {param} ({count})
数量与列表或反应字段中的项目数不一致。请先修正请求。
400
MISSING_PARAMETER
Missing required parameter: {param}
缺少必填参数。details.param 指明了它。请先修正请求。

请求

key=YOUR_API_KEY&action=add&service=12&link=https://t.me/example/42&quantity=100&reactions=🧿,👍

响应400 Bad Request

{
  "error": "Invalid reactions: unsupported_emoji",
  "error_code": "INVALID_OPTION",
  "retryable": false,
  "details": {
    "emoji": "🧿",
    "param": "reactions",
    "rule": "unsupported_emoji"
  }
}

规则词

details.rule 中的规则词

must_be_integer: 需要整数。
too_small: 值低于允许的最小值。
too_large: 值高于允许的最大值。
too_long: 文本超过允许的长度。
bad_format: 值不是预期的格式。
not_allowed: 值不是允许的选项之一。
not_a_url: 值不是 http 或 https 链接。
too_few_lines: 列表的行数少于要求。
too_many_lines: 列表的行数超过允许值。
empty: 值为空。
unsupported_emoji: 某个反应不在该服务接受的范围内。details.emoji 会指明它。
too_many_emoji: 不同反应的数量超过服务允许的上限。
duplicate_emoji: 同一个反应出现了两次。
bad_count: 某个反应的数量不是不小于 1 的整数。
mixed_forms: 同一个值中混用了带数量和不带数量的反应。
line_too_long: 某一行超过允许的长度。
bad_length: 文本为空或超过允许的长度。
iso_country: 国家不是两位 ISO 3166-1 代码。
invalid_choice: 值不是允许的选项之一。
url: 值不是 http 或 https 链接。
between_1_and_100: 数字超出该字段的范围。该词会指明范围，例如 between_1_and_100。
between_10_and_500: 数字超出该字段的范围。该词会指明范围，例如 between_1_and_100。

下单