{"platforms":["airbnb","alibaba1688","aliexpress","amazon","app_store","apple_maps","behance","bilibili","bing","bing_maps","bluesky","booking","capterra","clutch","company_data","craigslist","crexi","crypto_market","crypto_news","dailymotion","deviantart","dewu","dice","discord","douban","douyin","dribbble","duckduckgo","duckduckgo_maps","ebay","etsy","eventbrite","expedia","facebook","flickr","g2","gab","github","glassdoor","google_ads_transparency","google_maps_reviews","google_news","google_play","google_shopping","google_trends","indeed","instagram","iqiyi","jd","kalshi","kuaishou","lemmy","linkedin","mastodon","medium","naukri","naver","netease_music","nextdoor","odysee","patreon","pinterest","polymarket","producthunt","quora","realtor","reddit","rumble","seek","shopee","similarweb","snapchat","soundcloud","spotify","stepstone","substack","taobao","telegram","temu","thomasnet","threads","tiktok","toutiao","tripadvisor","trustpilot","truth_social","tumblr","twitch","twitter","upwork","vk","walmart","web","wechat_channels","wechat_oa","weibo","xianyu","xiaohongshu","xing","yahoo_finance","yandex","yelp","youku","youtube","zhihu","zillow"],"capabilities":[{"platform":"facebook","action":"search","action_label":"关键词搜索","required_params":["keyword"],"mode":"sync","cost_credits":1152,"price_cny":0.106877,"price_usd":0.016,"rows_per_unit":10,"optional_params":["content_type","since","until"],"param_meanings":{"content_type":{"description":"search 的排序维度，latest 为较新帖子、most_popular 为热门帖子。虽然参数名为 content_type，它不是 image/video 图片或视频格式筛选。","allowed_values":["latest","most_popular"],"type":"string"},"since":{"description":"search 帖子发布时间起点，建议 YYYY-MM-DD；不是广告投放开始时间或评论时间筛选。","type":"string","format":"date"},"until":{"description":"search 帖子发布时间终点，建议 YYYY-MM-DD，与 since 组成查询时间范围；不控制广告到期时间。","type":"string","format":"date"},"keyword":{"description":"search 查公开帖子；ads 查广告关键词，也可传广告库/主页 URL；marketplace 查商品词，也可传完整 Marketplace 搜索 URL。三个入口范围不同，不是同一份结果换字段。","type":"string"}},"returns_list":true,"available":true,"default_limit":10,"max_limit":200,"response_fields":["id","url","text","author_name","author_username","author_id","author_url","author_avatar_url","media","reactions","view_count","link","group_name","is_paid_partnership","like_count","comment_count","share_count","posted_at","platform"],"field_note":"When the main source is unavailable, a backup returns at most about 30 posts per request and no is_paid_partnership.","platform_field_meanings":{"author_id":"评论作者的数字用户 ID（稳定标识，可用于跨请求去重）。","author_url":"评论作者的主页链接。","media":"帖子的图片 / 视频：type、url（图片或视频封面）、width、height、link（点开的地址）。","reactions":"分表情计数：like、love、care、haha、wow、sad、angry。","link":"帖子附带的外链。","group_name":"帖子所在的群名（群帖才有）。","is_paid_partnership":"是否付费合作帖。"}},{"platform":"facebook","action":"profile","action_label":"主页或对象详情","required_params":["url"],"mode":"async","cost_credits":200,"price_cny":0.018555,"price_usd":0.002778,"param_meanings":{"url":{"description":"按接口传目标：profile/user_posts 传公开主页，post/comments 传帖子，group_posts 传群组主页或群组标识，reviews 传商家主页（会补 /reviews）。不是任意 Facebook 链接均可用于所有接口。","type":"string","format":"uri"}},"returns_list":false,"available":true,"response_fields":["id","name","url","bio","category","like_count","follower_count","is_verified","phone","email","website","rating","rating_scale","avatar_url","platform"],"platform_field_meanings":{"email":"邮箱（主页公开信息）。"}},{"platform":"facebook","action":"user_posts","action_label":"用户内容","required_params":["url"],"mode":"async","cost_credits":200,"price_cny":0.018555,"price_usd":0.002778,"param_meanings":{"url":{"description":"按接口传目标：profile/user_posts 传公开主页，post/comments 传帖子，group_posts 传群组主页或群组标识，reviews 传商家主页（会补 /reviews）。不是任意 Facebook 链接均可用于所有接口。","type":"string","format":"uri"}},"returns_list":true,"available":true,"default_limit":10,"max_limit":50,"response_fields":["id","url","text","author_name","author_username","author_id","author_url","author_avatar_url","media","reactions","view_count","link","group_name","is_paid_partnership","like_count","comment_count","share_count","posted_at","platform"],"platform_field_meanings":{"author_id":"评论作者的数字用户 ID（稳定标识，可用于跨请求去重）。","author_url":"评论作者的主页链接。","media":"帖子的图片 / 视频：type、url（图片或视频封面）、width、height、link（点开的地址）。","reactions":"分表情计数：like、love、care、haha、wow、sad、angry。","link":"帖子附带的外链。","group_name":"帖子所在的群名（群帖才有）。","is_paid_partnership":"是否付费合作帖。"}},{"platform":"facebook","action":"post","action_label":"单条内容","required_params":["url"],"mode":"sync","cost_credits":100,"price_cny":0.009278,"price_usd":0.001389,"param_meanings":{"url":{"description":"按接口传目标：profile/user_posts 传公开主页，post/comments 传帖子，group_posts 传群组主页或群组标识，reviews 传商家主页（会补 /reviews）。不是任意 Facebook 链接均可用于所有接口。","type":"string","format":"uri"}},"returns_list":false,"available":true,"response_fields":["id","url","text","author_name","author_username","author_id","author_url","author_avatar_url","media","reactions","view_count","link","group_name","is_paid_partnership","like_count","comment_count","share_count","posted_at","platform"],"field_note":"When the backup source answers, author_username, author_url, link, group_name and is_paid_partnership are not returned.","platform_field_meanings":{"author_id":"评论作者的数字用户 ID（稳定标识，可用于跨请求去重）。","author_url":"评论作者的主页链接。","media":"帖子的图片 / 视频：type、url（图片或视频封面）、width、height、link（点开的地址）。","reactions":"分表情计数：like、love、care、haha、wow、sad、angry。","link":"帖子附带的外链。","group_name":"帖子所在的群名（群帖才有）。","is_paid_partnership":"是否付费合作帖。"}},{"platform":"facebook","action":"comments","action_label":"评论","required_params":["url"],"mode":"async","cost_credits":200,"price_cny":0.018555,"price_usd":0.002778,"param_meanings":{"url":{"description":"按接口传目标：profile/user_posts 传公开主页，post/comments 传帖子，group_posts 传群组主页或群组标识，reviews 传商家主页（会补 /reviews）。不是任意 Facebook 链接均可用于所有接口。","type":"string","format":"uri"}},"returns_list":true,"available":true,"default_limit":10,"max_limit":50,"response_fields":["id","text","author_name","author_username","depth","reply_to_id","comment_url","author_id","author_url","like_count","reply_count","posted_at","platform"],"platform_field_meanings":{"reply_to_id":"被回复评论的 ID（depth>=1 才有；depth=0 恒为空）。回复行的 id 会复用父评论组 ID，要区分父子请以本字段为准。","depth":"评论层级：0 是顶层评论（一级），1 是对顶层评论的回复（二级），2 是对回复的再回复（三级）。深度行的 id 与其父评论组相同，重建评论树请用 depth + reply_to_id。","comment_url":"该条评论的永久链接；深度行的链接带 reply_comment_id 参数指向被回复的评论。","author_id":"评论作者的数字用户 ID（稳定标识，可用于跨请求去重）。","author_url":"评论作者的主页链接。"}},{"platform":"facebook","action":"followers","action_label":"粉丝数量","required_params":["username"],"mode":"sync","cost_credits":100,"price_cny":0.009278,"price_usd":0.001389,"optional_params":["channel"],"param_meanings":{"username":{"description":"followers 的 Facebook 账号/主页标识，不带 @；followers 返回粉丝数量对象，不是粉丝个人名单，不能用于逐人导出关系链。","type":"string"},"channel":{"description":"followers 的账号标识兼容输入；username 已提供时优先 username，且公开请求仍需包含必填 username。这里不是聊天频道 ID。","type":"string"}},"returns_list":false,"available":true,"response_fields":["id","username","url","follower_count","following_count","post_count","like_count","connection_count","precision","platform"],"platform_field_meanings":{"connection_count":"人脉数。","precision":"数据精确度标记（平台对模糊值的标注）。"}},{"platform":"facebook","action":"ads","action_label":"广告素材","required_params":["keyword"],"mode":"sync","cost_credits":100,"price_cny":0.009278,"price_usd":0.001389,"optional_params":["country","status"],"param_meanings":{"keyword":{"description":"search 查公开帖子；ads 查广告关键词，也可传广告库/主页 URL；marketplace 查商品词，也可传完整 Marketplace 搜索 URL。三个入口范围不同，不是同一份结果换字段。","type":"string"},"country":{"description":"ads 关键词查询的国家代码，例如 US，默认 US，构造 URL 时转为大写。keyword 已是完整 URL 时直接使用该 URL 中的条件，不再用此参数替换地区。","type":"string"},"status":{"description":"广告主页查询状态：all 全部（默认）、active 在投、inactive 已停投。这是投放状态，不是广告审核状态；keyword 传广告库 URL 时，URL 里自带的 active_status 可能与此参数不一致，建议两者保持一致。","type":"string"}},"returns_list":true,"available":true,"default_limit":20,"max_limit":200,"response_fields":["id","url","text","title","cta_text","link_url","is_active","started_at","ended_at","platforms","variant_count","advertiser_id","advertiser_name","advertiser_url","advertiser_likes","image_url","platform"],"platform_field_meanings":{"advertiser_id":"广告主 ID。","advertiser_name":"广告主名称。","advertiser_url":"广告主主页。","advertiser_likes":"广告主主页点赞数。","is_active":"广告是否在投。","started_at":"投放开始时间。","ended_at":"投放结束时间。","cta_text":"行动按钮文案（如 Shop Now）。","link_url":"广告落地页链接。分析竞品投放策略时最有用的字段。","platforms":"投放平台（Facebook/Instagram/Messenger/AN）。","variant_count":"广告素材变体数。多变体说明在做 A/B 测试。"}},{"platform":"facebook","action":"group_posts","action_label":"群组帖子","required_params":["url"],"mode":"sync","cost_credits":100,"price_cny":0.009278,"price_usd":0.001389,"optional_params":["sort"],"param_meanings":{"url":{"description":"按接口传目标：profile/user_posts 传公开主页，post/comments 传帖子，group_posts 传群组主页或群组标识，reviews 传商家主页（会补 /reviews）。不是任意 Facebook 链接均可用于所有接口。","type":"string","format":"uri"},"sort":{"description":"group_posts 用 top 表示热门帖子、recent 表示最近有活动的帖子；不传时按时间顺序。recent 不只看发帖时间；其他取值按时间顺序处理，不报错。","type":"string"}},"returns_list":true,"available":true,"default_limit":20,"max_limit":200,"response_fields":["id","url","text","posted_at","like_count","comment_count","share_count","author_id","author_name","author_url","group_url","platform"],"platform_field_meanings":{"group_url":"小组链接。","author_id":"评论作者的数字用户 ID（稳定标识，可用于跨请求去重）。","author_url":"评论作者的主页链接。"}},{"platform":"facebook","action":"marketplace","action_label":"市集商品","required_params":["keyword"],"mode":"sync","cost_credits":100,"price_cny":0.009278,"price_usd":0.001389,"optional_params":["location"],"param_meanings":{"keyword":{"description":"search 查公开帖子；ads 查广告关键词，也可传广告库/主页 URL；marketplace 查商品词，也可传完整 Marketplace 搜索 URL。三个入口范围不同，不是同一份结果换字段。","type":"string"},"location":{"description":"marketplace 的城市路径标识，例如 nyc，默认 nyc；不是自由文本街道地址。keyword 为完整 Marketplace URL 时以该 URL 为准，不再应用 location。","type":"string"}},"returns_list":true,"available":true,"default_limit":20,"max_limit":200,"response_fields":["id","url","name","price","currency","city","state","condition","image_url","posted_at","platform"],"platform_field_meanings":{"condition":"商品成色（Marketplace 用）。","state":"所在州/状态。"}},{"platform":"facebook","action":"reviews","action_label":"评价","required_params":["url"],"mode":"sync","cost_credits":100,"price_cny":0.009278,"price_usd":0.001389,"param_meanings":{"url":{"description":"按接口传目标：profile/user_posts 传公开主页，post/comments 传帖子，group_posts 传群组主页或群组标识，reviews 传商家主页（会补 /reviews）。不是任意 Facebook 链接均可用于所有接口。","type":"string","format":"uri"}},"returns_list":true,"available":true,"default_limit":20,"max_limit":200,"response_fields":["id","url","text","is_recommended","rating","rating_scale","posted_at","like_count","comment_count","author_id","author_name","author_url","platform"],"platform_field_meanings":{"is_recommended":"是否为推荐评价（FB 用推荐/不推荐替代星级）。","author_id":"评论作者的数字用户 ID（稳定标识，可用于跨请求去重）。","author_url":"评论作者的主页链接。"}},{"platform":"facebook","action":"advertiser_search","action_label":"广告主搜索","required_params":["keyword"],"mode":"sync","cost_credits":63,"price_cny":0.005845,"price_usd":0.000875,"param_meanings":{"keyword":{"description":"广告主名称或品牌词，如 nike。在广告库里找投广告的公共主页，返回主页 ID（id）、名称、类目、是否认证和关联的 Instagram 账号；拿 id 或主页链接再调 ads 看它在投什么。一次返回一批，没有翻页。","type":"string"}},"returns_list":true,"available":true,"default_limit":15,"max_limit":15,"limit_over_max":"capped","response_fields":["id","name","username","url","category","avatar_url","page_like_count","is_verified","instagram_username","instagram_follower_count","instagram_verified","country","platform"],"field_note":"country may be absent.","platform_field_meanings":{"page_like_count":"主页点赞数（advertiser_search）。","instagram_username":"这个主页关联的 Instagram 账号（advertiser_search）；没关联时没有这个字段。","instagram_follower_count":"关联 Instagram 账号的粉丝数（advertiser_search）；没关联时没有这个字段。","instagram_verified":"关联 Instagram 账号是否认证（advertiser_search）；没关联时没有这个字段。"}},{"platform":"facebook","action":"ad_detail","action_label":"广告详情","required_params":["url"],"mode":"sync","cost_credits":69,"price_cny":0.006401,"price_usd":0.000958,"param_meanings":{"url":{"description":"单条广告：广告库链接（https://www.facebook.com/ads/library/?id=<数字>）或纯数字广告 ID（ads 结果里的 id）。","type":"string","format":"uri"}},"returns_list":false,"available":true,"response_fields":["id","url","is_active","started_at","ended_at","text","title","caption","link_url","link_description","cta_text","display_format","platforms","media","creatives","variant_count","advertiser_id","advertiser_name","advertiser_url","advertiser_likes","advertiser_avatar_url","advertiser_categories","platform"],"field_note":"creatives and variant_count are returned only for some ads with several creative versions (carousel and dynamic product ads); link_description only when the ad's link card has a description. advertiser_id, advertiser_url, advertiser_likes, advertiser_categories and caption are not returned for every ad.","platform_field_meanings":{"advertiser_id":"广告主 ID。","advertiser_name":"广告主名称。","advertiser_url":"广告主主页。","advertiser_likes":"广告主主页点赞数。","is_active":"广告是否在投。","started_at":"投放开始时间。","ended_at":"投放结束时间。","cta_text":"行动按钮文案（如 Shop Now）。","link_url":"广告落地页链接。分析竞品投放策略时最有用的字段。","platforms":"投放平台（Facebook/Instagram/Messenger/AN）。","variant_count":"广告素材变体数。多变体说明在做 A/B 测试。","media":"帖子的图片 / 视频：type、url（图片或视频封面）、width、height、link（点开的地址）。","caption":"广告里显示的落地页域名（ad_detail，如 example.com）。","link_description":"广告链接卡片下方的描述文字（ad_detail）。","display_format":"广告形式（ad_detail）：IMAGE、VIDEO、CAROUSEL、DPA（动态商品广告）等。","creatives":"广告的各个素材版本（ad_detail）：title、text、caption、link_url、link_description、cta_text、image_url、video_url。轮播和动态商品广告每张卡片一项。","advertiser_avatar_url":"广告主主页头像（ad_detail）。","advertiser_categories":"广告主主页的类目（ad_detail）。"}},{"platform":"facebook","action":"events_search","action_label":"活动搜索","required_params":["keyword"],"mode":"sync","cost_credits":69,"price_cny":0.006401,"price_usd":0.000958,"optional_params":["page_token"],"param_meanings":{"keyword":{"description":"活动关键词，如 music festival、yoga Singapore。返回公开活动，含已结束的（is_past）。","type":"string"},"page_token":{"description":"翻页令牌：把上一次响应里的 next_page_token 原样传回，拿下一页（每页约 5 个）；不传从第一页开始。令牌 24 小时有效，每页算一次调用。","type":"string"}},"returns_list":true,"available":true,"pagination":{"page_token":true,"token_ttl_hours":24},"page_size":5,"limit_ignored":true,"page_size_varies":true,"response_fields":["id","url","name","starts_at","date_text","place_name","place_id","is_online","is_past","going_count","interested_count","price_text","image_url","next_page_token","platform"],"field_note":"price_text is returned only when the event lists a ticket price. Consecutive pages can repeat an event or two.","platform_field_meanings":{"starts_at":"活动开始时间（events_search、page_events；ISO 8601，UTC）。","date_text":"Facebook 页面上显示的活动时间原文，带当地时区（events_search、page_events），如「Sat, Oct 31 at 8:00 PM CDT」。","place_name":"活动地点名称或地址（events_search、page_events）；线上活动可能没有。","place_id":"活动地点的 Facebook 主页 ID（events_search）。","is_online":"是否线上活动（events_search、page_events）。","is_past":"活动是否已结束（events_search、page_events）。","going_count":"标记「参加」的人数（events_search）。","interested_count":"标记「感兴趣」的人数（events_search）。","price_text":"票价说明原文（events_search）；免费或没写时没有这个字段。","next_page_token":"翻页令牌（events_search、page_events）：作为下一次请求的 page_token 原样传回取下一页；同一页每行的值相同，响应顶层也有同一个 next_page_token。没有该字段即到底。"}},{"platform":"facebook","action":"marketplace_item","action_label":"市集商品详情","required_params":["url"],"mode":"sync","cost_credits":69,"price_cny":0.006401,"price_usd":0.000958,"param_meanings":{"url":{"description":"Marketplace 商品链接（https://www.facebook.com/marketplace/item/<数字>/）或纯数字商品 ID（marketplace 结果里的 id）。","type":"string","format":"uri"}},"returns_list":false,"available":true,"response_fields":["id","url","title","text","price","price_text","original_price_text","currency","condition","attributes","location","latitude","longitude","posted_at","is_sold","is_pending","is_shipping_offered","delivery_types","category_id","image_urls","seller_id","seller_name","seller_rating","seller_rating_count","seller_joined_at","platform"],"field_note":"original_price_text is returned only when the seller has lowered the price; seller_rating only when the seller has ratings.","platform_field_meanings":{"condition":"商品成色（Marketplace 用）。","price_text":"票价说明原文（events_search）；免费或没写时没有这个字段。","original_price_text":"划线原价原文（marketplace_item），卖家降过价才有。","attributes":"商品属性（marketplace_item）：name、value，如 Condition = Used - Good、Bicycle Type = Mountain Bike。","latitude":"商品所在位置纬度（marketplace_item，Facebook 给的大致位置）。","longitude":"商品所在位置经度（marketplace_item）。","is_sold":"是否已售出（marketplace_item）。","is_pending":"是否交易中（marketplace_item）。","is_shipping_offered":"卖家是否提供邮寄（marketplace_item）。","delivery_types":"交付方式（marketplace_item）：IN_PERSON 当面交易、SHIPPING 邮寄等。","category_id":"Marketplace 商品类目 ID（marketplace_item）。","seller_id":"卖家的 Facebook 标识（marketplace_item）。","seller_name":"卖家显示名（marketplace_item）。","seller_rating":"卖家评分（marketplace_item，满分 5）；没有评价时没有这个字段。","seller_rating_count":"卖家收到的评价数（marketplace_item）。","seller_joined_at":"卖家加入 Facebook 的时间（marketplace_item；ISO 8601，UTC）。"}},{"platform":"facebook","action":"page_events","action_label":"主页活动","required_params":["url"],"mode":"sync","cost_credits":69,"price_cny":0.006401,"price_usd":0.000958,"optional_params":["page_token"],"param_meanings":{"url":{"description":"公共主页链接，如 https://www.facebook.com/brickyardoldtown，也收 /p/<名字>-<数字> 形式。返回这个主页办的活动，即将开始的和已结束的都有。","type":"string","format":"uri"},"page_token":{"description":"翻页令牌：把上一次响应里的 next_page_token 原样传回，拿下一页；不传从第一页开始。令牌 24 小时有效，每页算一次调用。","type":"string"}},"returns_list":true,"available":true,"pagination":{"page_token":true,"token_ttl_hours":24},"page_size":10,"limit_ignored":true,"page_size_varies":true,"response_fields":["id","url","name","starts_at","date_text","place_name","city","host_name","is_online","is_past","is_canceled","next_page_token","platform"],"platform_field_meanings":{"starts_at":"活动开始时间（events_search、page_events；ISO 8601，UTC）。","date_text":"Facebook 页面上显示的活动时间原文，带当地时区（events_search、page_events），如「Sat, Oct 31 at 8:00 PM CDT」。","place_name":"活动地点名称或地址（events_search、page_events）；线上活动可能没有。","is_online":"是否线上活动（events_search、page_events）。","is_past":"活动是否已结束（events_search、page_events）。","is_canceled":"活动是否已取消（page_events）。","host_name":"办活动的主页名称（page_events）；联合主办时可能是合作方主页。","next_page_token":"翻页令牌（events_search、page_events）：作为下一次请求的 page_token 原样传回取下一页；同一页每行的值相同，响应顶层也有同一个 next_page_token。没有该字段即到底。"}},{"platform":"facebook","action":"post_transcript","action_label":"视频帖文稿","required_params":["url"],"mode":"sync","cost_credits":69,"price_cny":0.006401,"price_usd":0.000958,"param_meanings":{"url":{"description":"公开视频帖、Reel 或带视频的帖子链接，如 https://www.facebook.com/reel/<数字>/。返回口播转写文本；视频里没人说话时没有 text。","type":"string","format":"uri"}},"returns_list":false,"available":true,"response_fields":["id","url","text","duration_seconds","duration_sec","platform"],"field_note":"text is absent when the video has no speech; duration_seconds is not returned for every video."}],"async_mode":"Any capability can run async: send {\"mode\":\"async\"} in the POST /api/v1/social body to receive 202 + job_id immediately, then poll GET /api/v1/jobs/{job_id}. Use it for slow tasks or large limits instead of waiting on the 85s sync budget."}