Browse published operations

Process a single URL, return the result. This endpoint blocks until the result is ready. It is intended for short-running operations. At least one of the following request fields must be set to true: - browserHtml - httpResponseBody - httpResponseHeaders - screenshot - An automatic extraction request field: - article - articleList - articleNavigation - forumThread - jobPosting - jobPostingNavigation - pageContent - product - productList - productNavigation - serp All automatic extraction data types support performing extraction using either a browser request or an HTTP request. Choose which using extractFrom; for serp use serpOptions.extractFrom instead. When no option is specified, currently automatic extraction defaults to using a browser request, except for serp, where an HTTP request is used by default instead. In the future, however, the default value may depend on the target website. When automatic extraction uses a browser request, it can be combined with any fields compatible with browserHtml, e.g. screenshot. When automatic extraction uses an HTTP request, it can be combined with any fields compatible with httpResponseBody. serp cannot be combined with any other fields besides serpOptions and url. You cannot combine multiple automatic extraction request fields (e.g. product and productList) on the same request. You cannot combine httpResponseBody with a request field that is exclusive of browser requests (e.g. httpResponseBody and browserHtml). httpResponseHeaders can be requested alone or with any other valid combination of request fields except for serp. The request body size limit is 5MiB.

[中文] ### 用途: - 美食作品 ### 参数: - count: 每页数量，默认为16 - refreshindex: 翻页索引，默认为1 - cookie: 用户自行提供的Cookie，推荐使用自己的抖音Cookie，否则在翻页时可能会出现数据重复的问题 - 游客cookie获取接口：https://api.tikhub.io/api/v1/douyin/web/fetchdouyinwebguestcookie ### 返回: - 美食作品数据 # [English] ### Purpose: - Food Video ### Parameters: - count: Number per page, default is 16 - refreshindex: Paging index, default is 1 - cookie: User provided Cookie, it is recommended to use your own Douyin Cookie, otherwise there may be a problem of data duplication when paging - Guest cookie acquisition interface: https://api.tikhub.io/api/v1/douyin/web/fetchdouyinwebguestcookie ### Return: - Food Video data

[中文] ### 用途: - 知识作品 ### 参数: - count: 每页数量，默认为16 - refreshindex: 翻页索引，默认为1 - cookie: 用户自行提供的Cookie，推荐使用自己的抖音Cookie，否则在翻页时可能会出现数据重复的问题 - 游客cookie获取接口：https://api.tikhub.io/api/v1/douyin/web/fetchdouyinwebguestcookie ### 返回: - 游戏作品数据 # [English] ### Purpose: - Knowledge Video ### Parameters: - count: Number per page, default is 16 - refreshindex: Paging index, default is 1 - cookie: User provided Cookie, it is recommended to use your own Douyin Cookie, otherwise there may be a problem of data duplication when paging - Guest cookie acquisition interface: https://api.tikhub.io/api/v1/douyin/web/fetchdouyinwebguestcookie ### Return: - Game Video data

[中文] ### 用途: - 音乐作品 ### 参数: - count: 每页数量，默认为16 - refreshindex: 翻页索引，默认为1 - cookie: 用户自行提供的Cookie，推荐使用自己的抖音Cookie，否则在翻页时可能会出现数据重复的问题 - 游客cookie获取接口：https://api.tikhub.io/api/v1/douyin/web/fetchdouyinwebguestcookie ### 返回: - 音乐作品数据 # [English] ### Purpose: - Music Video ### Parameters: - count: Number per page, default is 16 - refreshindex: Paging index, default is 1 - cookie: User provided Cookie, it is recommended to use your own Douyin Cookie, otherwise there may be a problem of data duplication when paging - Guest cookie acquisition interface: https://api.tikhub.io/api/v1/douyin/web/fetchdouyinwebguestcookie ### Return: - Music Video data

[中文] ### 用途: - 短剧作品 ### 参数: - offset: 页码，默认为0 - count: 每页数量，默认为16 - contenttype: 子类型，默认为0 - 0: 热榜 - 101: 甜宠 - 102: 搞笑 - 104: 正能量 - 105: 成长 - 106: 悬疑 - 109: 家庭 - 110: 都市 - 112: 奇幻 - 113: 玄幻 - 114: 职场 - 115: 青春 - 116: 古装 - 117: 动作 - 119: 逆袭 - 124: 其他 - cookie: 用户自行提供的Cookie，推荐使用自己的抖音Cookie，否则在翻页时可能会出现数据重复的问题 - 游客cookie获取接口：https://api.tikhub.io/api/v1/douyin/web/fetchdouyinwebguestcookie ### 返回: - 短剧作品数据 # [English] ### Purpose: - Series Video ### Parameters: - offset: Page number, default is 0 - count: Number per page, default is 16 - contenttype: Subtype, default is 0 - 0: Hot list - 101: Sweet pet - 102: Funny - 104: Positive energy - 105: Growth - 106: Suspense - 109: Family - 110: Urban - 112: Fantasy - 113: Fantasy - 114: Workplace - 115: Youth - 116: Ancient costume - 117: Action - 119: Counterattack - 124: Other - cookie: User provided Cookie, it is recommended to use your own Douyin Cookie, otherwise there may be a problem of data duplication when paging - Guest cookie acquisition interface: https://api.tikhub.io/api/v1/douyin/web/fetchdouyinwebguestcookie ### Return: - Series Video data

[中文] ### 用途: - 使用接口网址生成A-Bogus参数，提交的URL不能带有abogus参数，同时abogus参数与请求头中的User-Agent有关，需要一起提交和请求。 ### 参数: - url: API链接，请去除url中的原本的aboogus参数(如有)。 - data: 请求载荷，只有在POST请求中才需要提交，GET请求中使用空字符串即可。 - useragent: user-agent，需要提交你请求头中的User-Agent，该值参与abogus参数的计算。 - index0: 加密明文列表的第一个值，无特殊要求，默认为0，不要随意修改。 - index1: 加密明文列表的第二个值，无特殊要求，默认为1，不要随意修改。 - index2: 加密明文列表的第三个值，无特殊要求，默认为14，不要随意修改。 ### 返回: - A-Bogus参数 # [English] ### Purpose: - Generate A-Bogus parameter using API URL, the submitted URL cannot contain the original aboogus parameter, and the abogus parameter is related to the User-Agent in the request header, which needs to be submitted and requested together. ### Parameters: - url: API link, please remove the original aboogus parameter from the url (if any). - data: Request payload, only need to submit in POST request, use an empty string in GET request. - useragent: user-agent, you need to submit the User-Agent in your request header, which is involved in the calculation of the abogus parameter. - index0: The first value of the encrypted plaintext list, no special requirements, the default is 0, do not modify it at will. - index1: The second value of the encrypted plaintext list, no special requirements, the default is 1, do not modify it at will. - index2: The third value of the encrypted plaintext list, no special requirements, the default is 14, do not modify it at will. ### Return: - A-Bogus parameter # [示例/Example] ```json { "url": "https://www.douyin.com/aweme/v1/web/general/search/single/?deviceplatform=webapp&aid=6383&channel=channelpcweb&searchchannel=awemegeneral&enablehistory=1&keyword=%E4%B8%AD%E5%8D%8E%E5%A8%98&searchsource=normalsearch&querycorrecttype=1&isfiltersearch=0&fromgroupid=7346905902554844468&offset=0&count=15&needfiltersettings=1&pcclienttype=1&versioncode=190600&versionname=19.6.0&cookieenabled=true&screenwidth=1280&screenheight=800&browserlanguage=zh-CN&browserplatform=Win32&browsername=Firefox&browser_version

[中文] ### 用途: - 使用接口网址生成X-Bogus参数 ### 参数: - url: 接口网址 # [English] ### Purpose: - Generate X-Bogus parameter using API URL ### Parameters: - url: API URL # [示例/Example]

[中文] ### 用途: - 搜索接口 ### 参数: - query: 搜索关键词 - maxcursor: 翻页参数，可以从上一次请求的返回结果中获取，第一次请求为空，后续请求使用上一次请求返回的maxcursor进行翻页，可以通过返回结果的hasmore字段判断是否还有更多数据。 - filtertype: 搜索过滤类型，默认为空字符串，可选值如下： - 空字符串：All（全部，默认使用此参数搜索） - video：只搜索视频作品 - posts：只搜索文章作品 - orderby: 搜索排序方式，默认为空字符串，可选值如下： - 空字符串：Relevance（相关度，默认使用此参数排序） - popular：流行度排序 - recent：从新到旧排序 - searchtab: 搜索类型，默认为main，可选值如下： - main：APP中显示为 Top（综合搜索，默认使用此参数搜索） - user：APP中显示为 Accounts （搜索用户账号） - hashtag：APP中显示为 Hashtags（搜索话题） - article：APP中显示为 Posts（搜索文章） ### 返回: - 搜索结果 # [English] ### Purpose: - Search API ### Parameters: - query: Search keyword - maxcursor: Pagination parameter, can be obtained from the return result of the last request. It is empty for the first request, and the maxcursor returned by the last request is used for subsequent requests. You can judge whether there is more data by the hasmore field in the return result. - filtertype: Search filter type, default is an empty string, optional values are as follows: - Empty string: All (default using this parameter to search) - video: Search only video - posts: Search only posts - orderby: Search sort type, default is an empty string, optional values are as follows: - Empty string: Relevance (default using this parameter to sort) - popular: Sort by popularity - recent: Sort from new to old - searchtab: Search type, default is main, optional values are as follows: - main: Display as Top in the APP (comprehensive search, default using this parameter to search) - user: Display as Accounts in the APP (search user accounts) - hashtag: Display as Hashtags in the APP (search hashtags) - article: Display as Posts in the APP (search articles) ### Return: - Search results # [示例/Example] query = "lemon8" maxcursor = "" filtertype = "" orderby = "" searchtab = "main"

[中文] ### 用途: - 搜索接口，支持搜索用户、作品等。 ### 参数: - keyword: 搜索关键词。 - offset: 翻页游标，默认为0，后续页码从上一页返回的 offset Key中获取对应值。 - searchtype: 搜索类型，可用值如下： - 1: 综合 - 8: 热门 - 9: 新鲜 - 2：视频 - 3：图文 - 4：用户 - 5：话题 ### 返回: - 搜索结果 # [English] ### Purpose: - Search API, support search user, post, etc. ### Parameters: - keyword: Search keyword. - offset: Page cursor, default is 0, get the corresponding value from the offset Key in the previous page. - searchtype: Search type, available values are as follows: - 1: Comprehensive - 8: Hot - 9: Fresh - 2: Video - 3: Photo - 4: User - 5: Hashtag ### Return: - Search result # [示例/Example] keyword = "皮皮虾" offset = "0" search_type = "1"

[中文] ### 用途: - 搜索TikTok广告创意库中的广告，支持多维度筛选和排序 - 发现特定行业、关键词或目标相关的高效广告案例 - 为广告策划和创意制作提供参考和灵感 ### 参数: - keyword: 搜索关键词，可选参数，留空返回所有广告 - objective: 广告目标，可选；留空表示不按目标筛选 - like: 表现分位，可选；留空表示不按表现分位筛选 - period: 时间范围（天），如7、30、120、180天 - industry: 行业ID列表，多个ID用逗号分隔。完整行业ID列表见: https://github.com/TikHub/TikTok-Ads-Industry-Code - page: 页码，默认1 - limit: 每页数量，默认20，最大50 - orderby: 排序方式，"foryou"=为你推荐，"likes"=按点赞数排序 - countrycode: 国家代码，如US、UK、JP等 - adformat: 广告格式，可选；1=Spark Ads，2=非 Spark Ads - adlanguage: 广告语言代码，可选，如en、zh-Hant等 - duration: 视频时长筛选值，可选 - patternlabel: 创意趋势标签，可选 - cookie: 自定义Cookie字符串，可选参数，可以使用自己的Cookie来获取更多数据 ### 注意: - 如果您应用了一个或多个筛选条件后没有返回任何结果，请尝试调整或移除部分筛选条件。TikTok 创作者数据集仅收录部分热门数据，不一定包含全量数据。 ### 常用行业ID示例: - 游戏: 27000000000 - 电子商务: 19000000000 - 金融服务: 30000000000 - 教育: 10000000000 - 美妆个护: 22000000000 - 食品饮料: 16000000000 ### 返回内容说明: - materials: 广告素材列表 - id: 广告素材ID - awemeid: 广告视频ID - desc: 广告描述 - createtime: 创建时间 - videoinfo: 视频信息 - cover: 封面图URL - duration: 时长（秒） - statistics: 统计数据 - diggcount: 点赞数 - commentcount: 评论数 - sharecount: 分享数 - adsinfo: 广告信息 - advertisername: 广告主名称 - landingpage: 落地页URL - pagination: 分页信息 - page: 当前页 - limit: 每页数量 - total: 总数量 - hasmore: 是否有更多 ### 示例响应: # [English] ### Purpose: - Search ads

[中文] ### 用途: - Instagram用户搜索接口 - 仅返回用户搜索结果 ### 参数: - query: 搜索关键词 - ranktoken: 上一次搜索返回的ranktoken，用于翻页 ### 返回: - data.users: 用户搜索结果列表 - data.ranktoken: 排序token - data.seemore: 更多信息 - data.informmodule: 提示模块 ### 价格: - 0.008 USD/请求 # [English] ### Purpose: - Instagram user search API - Returns only user search results ### Parameters: - query: Search keyword - ranktoken: Rank token from previous search response for pagination ### Return: - data.users: User search results - data.ranktoken: Rank token - data.seemore: See more info - data.inform_module: Inform module ### Price: - 0.008 USD/request ### 示例/Example query = "justin"

[中文] ### 用途: - 批量获取多个作品数据，单次请求最多支持40个视频ID。 - 如果此接口连续请求失败，可以尝试使用价格更昂贵的V2接口进行冗余请求。 - 此接口收费标准默认为：40 0.001 = 0.04 美元/次。 ### 参数: - photo_ids: 作品ID列表，多个ID用英文逗号分隔，单次最多40个 - 格式备注：支持纯数字版本的ID，也支持短字符串版本（eID）的ID，两种ID可以混合使用。 ### 返回: - 视频数据列表 # [English] ### Purpose: - Batch fetch multiple video data, supports up to 40 video IDs per request. - If this API continuously fails, you can try to use the more expensive V2 API for redundant requests. - The default charging standard for this API is: 40 0.001 = 0.04 USD/time. ### Parameters: - photoids: Photo ID list, multiple IDs separated by commas, max 40 per request - Format note: Supports both pure digital version IDs and short string version (eID) IDs, both types can be mixed. ### Returns: - Video data list # [示例/Example] photoids = "5228960823332207296,5196309727975443273,5222486898325987583"

Finds work email (1 credit), personal email (3 credits), and/or mobile phone (10 credits) for up to 100 contacts. Provide firstname+lastname with domain or companyname, or a linkedinurl, per contact. Async: returns an enrichmentid, poll GET /api/v1/contact/enrich/bulk/{enrichmentid} or use webhook_url.

Identifies the person and company behind up to 100 emails. 1 credit per match found. Async: returns an enrichmentid, poll GET /api/v2/contact/reverse/email/bulk/{enrichmentid} or use webhook_url.

[中文] ### 用途: - 抖音APP注册设备，获取设备信息以及设备的Cookie信息。 ### 参数: - proxy: 代理，要带http://或https://，仅支持http代理。 - 格式: username:password@ip:port ### 返回: - 设备信息以及设备的Cookie信息。 # [English] ### Purpose: - Register device in Douyin APP, retrieve device information and device cookies. ### Parameters: - proxy: Proxy, with http:// or https://, only supports http proxies. - Format: username:password@ip:port ### Return: - Device information and device cookies. # [示例/Example] proxy = "http://username:password@ip:port" # [响应/Response] ```json { "code": 200, "router": "/api/v1/douyin/app/v3/registerdevice", "params": { "proxy": "username:password@ip:port" }, "data": { "iid": "3631064037200330", "deviceid": "3631064037196234", "mssdktoken": "", "deviceplatform": "android", "channel": "xiaomi641775", "versioncode": 240900, "versionname": "24.9.0", "manifestversioncode": 240901, "updateversioncode": 24909900, "devicetype": "V1963A", "devicebrand": "vivo", "devicemodel": "V1963A", "openudid": "5d736335afc17aab", "osapi": 29, "osversion": "10", "resolution": "2400x1080", "dpi": 480, "hostabi": "arm64-v8a", "ua": "com.ss.android.ugc.aweme/240901 (Linux; U; Android 10; zhCN; V1963A; Build/compiler10301842;tt-ok/3.12.13.4-tiktok)", "cookies": { "installid": "3631064037200330", "odintt": "5ef413aaa319b3a4077814a1da3d3e1bcec3e8640ddc3ad30945a8518f59d1563d24c3b7a3c59d97fbd5344f13208a25cf143312acf4462b028e56cd0b611cc3fc2a64318f7375470d6db86440f92841", "dticket": "42186c5b0c54ea1a2a9e02d4e62bf6ab", "store-region": "cn-js", "store-region-src": "did", "multisids": "462868309327184:38167255076198698951907954929873", "passportcsrftoken": "6f75287240634ad1f51f3b3bdcdb5424", "passportcsrftokendefault": "6f75287240634ad1f51f3b3bdcdb5424", "ttreq": "1$7f616210b41fc044b1f164542ac4e064288b5163" }, "lanusk": "", "devicemanufacturer": "vivo", "uuid": "357125675341697", "cdid": "f64372bf-4d1d-4883-bc8a-d3d6fa87a9e3", "firstlaunchtimestamp": 1726970498636, "xtt_dt": "AAA2FGV24A2GAOHJJ3D3X

[中文] ### 用途: - 通过用户名获取用户账号国家地区 ### 参数: - username: 用户名，可以从用户主页链接中获取，例如：https://www.tiktok.com/@tiktok，用户名即为tiktok。 ### 返回: - 用户账号国家地区 # [English] ### Purpose: - Get user account country by username ### Parameters: - username: Username, which can be obtained from the user's homepage link, for example: https://www.tiktok.com/@tiktok, the username is tiktok. ### Return: - User account country # [示例/Example] username = "tiktok" # 响应示例/Response Example

[中文] ### 用途: - 获取TikTok Shop商品的详细信息 - 包含商品基本信息、价格、库存、评价、推荐商品等完整数据 - 某些特殊地区的商品可能无法获取到数据（如：泰国），如果遇到此情况请尝试使用 fetchproductdetailv3 接口 ### 参数: - sellerid: 卖家ID (可传空字符串) - productid: 商品ID (必填) - region: 地区代码 (US/GB/SG/MY/PH/TH/VN/ID) ### 重要提示: - 由于接口风控原因，请务必将请求timeout设置为30秒 - 如遇到400错误代码，请重试请求3次 ### 返回数据结构: # [English] ### Purpose: - Get detailed information of TikTok Shop products - Contains complete data including basic info, price, stock, reviews, recommendations - Some products from specific regions may not be accessible (e.g., Thailand); if so, try using fetchproductdetailv3 ### Parameters: - sellerid: Seller ID (can be empty string) - productid: Product ID (required) - region: Region code (US/GB/SG/MY/PH/TH/VN/ID) ### Important Notice: - Due to API rate limiting, please set request timeout to 30 seconds - If you encounter error code 400, please retry the request 3 times ### Response Structure: # [示例/Example] sellerid = "7494629757824764402" productid = "1729556436942358002" region = "MY"

Paid. Returns websites that use a given technology, with optional filters (country, spend, revenue, employees, other technologies). Validate a technology name for free first with the Trends API.

Access the asynchronous Taobao and Tmall product detail workflow from the Just One API dashboard Task Management page. Use it to submit and download product detail research tasks.

Create a new list

Search Minnesota businesses in the Secretary of State registry by name or file number. Returns matching entities with filing identifier, name, business status, business type and name type. Price: 5 credits per 500 results

Instagram Search Posts Price: 1 credit per 30 results

List public repositories owned by a GitHub user Price: 5 credits per 100 results

Search Product Hunt (producthunt.com) launches by keyword, optional topic and featured filters Price: 1 credit per 20 results

Twitter Search Tweets Price: 1 credit per 20 results

Twitter Search Users Price: 1 credit per 20 results

Instagram Web — get a post's comments by shortcode or URL (browser-faithful GraphQL) Price: 1 credit per 15 results

Instagram Web — get a user's posts by alias, URL or numeric ID (browser-faithful GraphQL) Price: 1 credit per 12 results

Instagram Web — get a user's reels by alias, URL or numeric ID Price: 1 credit per 12 results

Search patents by query and filters Price: 10 credits per 100 results

Linkedin Get Post Comments Price: 1 credit per 10 results

Linkedin Get Post Reactions Price: 1 credit per 10 results

Search Product Hunt (producthunt.com) products by keyword Price: 1 credit per 10 results

Search and browse the full TechCrunch archive back to 2005. Combine a full-text query with section, topic-tag, region, storyline and author filters, publish and update date ranges, an 'In Brief' short-news switch and the sort order. Each result carries headline, excerpt, publish and update timestamps, credited authors and the resolved taxonomy terms. Price: 10 credits per 100 results

Search X (Twitter) Ads Repository promoted tweets by advertiser, EU/EEA country and date range Price: 5 credits per 50 results

Get reviews written by a Google Maps contributor by contributor ID. Price: 3 credits per 20 results

List comments on a TikTok (tiktok.com) video by video ID or full video URL Price: 3 credits per 20 results

Search Google Play apps by query. Returns matching app cards with rating, installs and price. Price: 5 credits per 30 results

List issues of a GitHub repository by owner/name or repository URL Price: 20 credits per 100 results

Search everything The New York Times has published since 1851 — news and opinion articles, videos, interactives, slideshows, audio, recipes, The Athletic and Wirecutter pieces, paid posts and card decks. Filter by kind of item, section, publication day range and language edition, and order by relevance, newest or oldest. Each result carries headline, summary, kicker, authors, section, topic tags, lead image and publication times. Price: 20 credits per 100 results

Get Google Maps photos for a place by feature ID. Returns photo URLs, captions, dimensions. Price: 5 credits per 20 results

List TikTok Creative Center Top Ads (best-performing auction ads) with filters Price: 5 credits per 20 results

Starts a crawl job from a start URL. maxPages sets how many pages to crawl (up to 50, default 10). Priced per page crawled.

Create new scrape job

Starts a batch scrape job. Send urls (up to 100). Priced per page scraped.

Starts a crawl job that follows links from a start URL and returns each page's content in the formats you ask for. crawlOptions.maxPages caps the pages (up to 50, default 10). Priced per page crawled.

[中文] ### 用途: - 搜索抖音用户，支持抖音号和抖音昵称搜索 ### 参数: - username: 用户名 (支持抖音号和抖音昵称) - 抖音号: 如 "rmrbxmt" - 抖音昵称: 如 "Y"、"人民日报" ### 返回: - 最多返回20个匹配的用户信息 - 包含用户基本信息如头像、昵称、抖音号等 # [English] ### Purpose: - Search Douyin users by Douyin ID or nickname ### Parameters: - username: Username (supports Douyin ID and nickname) - Douyin ID: e.g., "rmrbxmt" - Nickname: e.g., "Y", "人民日报" ### Return: - Returns up to 20 matching user information - Contains basic user info like avatar, nickname, Douyin ID, etc.

生成短链接

[中文] ### 用途: - 主播搜索(抖音直播广场)，按关键词搜索抖音直播主播，支持完整筛选条件 - 价格：0.002$ / 次 ### 参数: - keyword: 搜索关键词，可为主播昵称、抖音号、星图ID或直播内容词 - page: 页码，默认1 - sortfield: 排序字段，默认score综合排序 - sorttype: 排序方式，1=升序，2=降序，默认2 - 合作诉求: taskcategory 合作对象、marketingtarget 营销目标、firstindustryid 适配行业 - 匹配度: tag 达人类型、personatags 达人人设/学历/认证/调性、gender 性别、fansmin/fansmax 粉丝数 - 性价比: expectedplaymin/expectedplaymax 预期播放量、 cpmmin/cpmmax 预期CPM、cpemin/cpemax 预期CPE、interactratemin/interactratemax 互动率、 playoverratemin/playoverratemax 完播率、bursttextratemin/bursttextratemax 爆文率 - 报价: pricetype 固定为 9（直播报价）；pricemin/pricemax 为主播报价区间， 提供任一边界时必须同时提供 pricetype - 主题推荐: authorlistid 达人清单ID - 画像筛选 extrafilter: 观众/粉丝画像、受众画像、所在地域、连接用户数等维度靠它筛选。 传 JSON 数组字符串，每个元素形如 {"fieldname":"字段名","fieldvalue":"值"}（可选 relid）， 常用字段： - 观众性别: watchergenderfemaleratev2ge(女性占比阈值,取值 0.5/0.6/0.7/0.8), 男性用 watchergendermaleratev2ge - 观众年龄: watcheragemostnew(观众年龄居多,值为编码数组,如 [22]=24-30岁居多) 示例: extrafilter=[{"fieldname":"watchergenderfemaleratev2_ge","fieldvalue":"0.5"}] - 说明: tag/personatags 的可选ID可通过getauthormarketfields获取；动态画像字段和编码 可通过getsearchfieldoptions获取；比率类参数为0-1小数(0.02=2%) ### 返回: - 主播搜索结果数据（含主播信息、直播报价、ACU/PCU、场均观看等） # [English] ### Purpose: - Search Douyin live-stream anchors in the live marketplace by keyword, with full filtering - Price: 0.002$ / time ### Parameters: - keyword: Search keyword: nickname, Douyin ID, Xingtu ID or live content word - page: Page number, default 1 - sortfield: Sort field, default score (comprehensive sort) - sorttype: Sort type, 1=asc, 2=desc, default 2 - Cooperation: taskcategory, marketingtarget, firstindustryid - Match: tag (category), personatags, gender, fansmin/fansmax - Cost-performance: expectedplaymin/max, cpmmin/max, cpemin/max, interactratemin/max, playoverratemin/max, bursttextratemin/max - Price: pricetype is fixed to 9 for live-stream pricing; pricemin/price_max define the anchor-price

[中文] ### 用途: - 获取音乐榜单（歌曲列表，结果在 musics[]），使用游标分页。 ### 参数: - tabid: 榜单 ID，100002=热歌榜（默认），100063=π计划推荐榜 - count: 每页数量，默认 20，范围 1-50 - pcursor: 分页游标，首次留空，翻页传上一页响应的 pcursor ### 返回: - 音乐榜单数据 # [English] ### Purpose: - Fetch music ranking (songs in musics[]), with cursor pagination. ### Parameters: - tabid: 100002=hot songs (default), 100063=Pi-plan ranking - count: Page size, default 20, range 1-50 - pcursor: Cursor, empty for first page ### Returns: - Music ranking data

[中文] ### 用途: - 话题标签聚合页：给定标签，返回标签信息(tagInfo) + 关联作品流(mixFeeds[])。hashtag 页有 4 个子 tab。 ### 参数: - generaltagid: 标签 ID。话题标签传标签名（如 "清纯甜美少女"）或 searchtag 的数字 id；声音标签传编码串 - tab: hashtag 子 tab —— hot(最热门) / latest(最新发布) / image(图片) / live(直播) - tagname: 标签显示名，话题标签建议传 - tagtype: 1=话题标签（默认），29=声音/音乐标签 - tagsource: 2=搜索进入话题页（默认），3=作品页声音标签 - fromphotoid: 进入标签页的源作品 photoId（可选） - pcursor: 分页游标，首次留空，翻页传上一页响应的 pcursor ### 返回: - 标签信息 + 作品流数据 # [English] ### Purpose: - Tag aggregation page: tagInfo + related feed (mixFeeds[]). Hashtag page has 4 sub tabs. ### Parameters: - generaltagid: Tag ID. Topic tag uses tag name or searchtag's numeric id; sound tag uses encoded id. - tab: hot / latest / image / live - tagname: Tag display name (recommended for topic tags) - tagtype: 1=topic tag, 29=sound/music tag - tagsource: 2=from search, 3=sound tag from photo page - fromphotoid: Source photoId (optional) - pcursor: Cursor, empty for first page ### Returns: - Tag info + feed data

[中文] ### 用途: - 通过邮件ID获取邮件数据 ### 参数: - token: 邮箱Bearer Token - messageid: 邮件ID ### 返回: - 邮件数据 # [English] ### Purpose: - Get email data by email ID ### Parameters: - token: Email Bearer Token - messageid: Email ID ### Returns: - Email data

[中文] ### 用途: - 获取邮件列表 ### 参数: - token: 邮箱Bearer Token ### 返回: - emails: 邮件列表 # [English] ### Purpose: - Get a list of emails ### Parameters: - token: Email Bearer Token ### Returns: - emails: List of emails

[中文] ### 用途: - 获取一个临时邮箱地址 - 用于注册或者接收邮件，该邮箱地址不会被删除，也不会被其他人使用。 - 该邮箱无法发送邮件，只能接收邮件。 - 请自行保存邮箱地址、用户名、密码、Bearer Token，我们无法帮助您找回这些关键信息。 ### 参数: - 无 ### 返回: - domain: 邮箱域名 - name: 邮箱用户名 - password: 邮箱密码 - emailaddress: 邮箱地址 - token: 邮箱Bearer Token # [English] ### Purpose: - Get a temporary email address - Used for registration or receiving emails, this email address will not be deleted or used by others. - This email cannot send emails, only receive emails. - Please save the email address, username, password, and Bearer Token yourself, we cannot help you retrieve this critical information. ### Parameters: - None ### Returns: - domain: Email domain - name: Email username - password: Email password - emailaddress: Email address - token: Email Bearer Token

[中文] ### 用途: - 获取推文下的评论 ### 参数: - tweetid: 推文ID - cursor: 游标，默认为None，用于翻页，后续从上一次请求的返回结果中获取 ### 返回: - 评论 # [English] ### Purpose: - Get comments under the tweet ### Parameters: - tweetid: Tweet ID - cursor: Cursor, default is None, used for paging, obtained from the last request ### Return: - Comments # [示例/Example] tweet_id = "1808168603721650364" cursor = None

[中文] ### 用途: - 搜索 ### 参数: - keyword: 搜索关键字 - searchtype: 搜索类型，默认为Top，其他可选值为Latest，Media，People, Lists - cursor: 游标，默认为None，用于翻页，后续从上一次请求的返回结果中获取 ### 返回: - 搜索结果 ### 关于搜索结果准确性的说明: - X 的搜索并不保证关键词或话题标签一定出现在推文正文（text 字段）中。 - 匹配范围远大于正文，还包括：被引用的推文、外链文章的元数据、媒体内容以及账号信号。 - 因此返回的推文完全可能是一条合法匹配，但关键词根本不在 text 字段里。 - 如果在结果上再做一次"正文必须包含关键词"的字面子串过滤，会丢弃掉很大一部分有效结果 （实测可达 94.6% 的丢弃率）。 - 若发现结果看起来"不准"，请优先检查是否在调用侧做了这类字面过滤。 # [English] ### Purpose: - Search ### Parameters: - keyword: Search keyword - searchtype: Search type, default is Top, other optional values are Latest, Media, People, Lists - cursor: Cursor, default is None, used for paging, obtained from the last request ### Return: - Search results ### Note on search result accuracy: - X's search does not guarantee the keyword or hashtag appears in the tweet text. - Matching happens against more than the caption — it can include the quoted tweet, linked article metadata, media, and account signals. - So a returned tweet can be a legitimate match with the term absent from the text field entirely. - Requiring a literal substring match in text will discard a large share of valid results, which is consistent with the 94.6% drop rate observed in practice. - If results look inaccurate, first check whether such a literal filter is being applied downstream. # [示例/Example] keyword = "Elon Musk" search_type = "Top" cursor = None

[中文] ### 用途: - 获取趋势 ### 参数: - country: 国家，默认为UnitedStates，其他可选值见下方 - China - India - Japan - Russia - Germany - Indonesia - Brazil - France - UnitedKingdom - Turkey - Italy - Mexico - SouthKorea - Canada - Spain - SaudiArabia - Egypt - Australia - Poland - Iran - Pakistan - Vietnam - Nigeria - Bangladesh - Netherlands - Argentina - Philippines - Malaysia - Colombia - UniteArabEmirates - Romania - Belgium - Switzerland - Singapore - Sweden - Norway - Austria - Kazakhstan - Algeria - Chile - Czechia - Peru - Iraq - Israel - Ukraine - Denmark - Portugal - Hungary - Greece - Finland - NewZealand - Belarus - Slovakia - Serbia - Lithuania - Luxembourg - Estonia ### 返回: - 趋势 # [English] ### Purpose: - Get Trending ### Parameters: - country: Country, default is UnitedStates, other optional values are as follows - China - India - Japan - Russia - Germany - Indonesia - Brazil - France - UnitedKingdom - Turkey - Italy - Mexico - SouthKorea - Canada - Spain - SaudiArabia - Egypt - Australia - Poland - Iran - Pakistan - Vietnam - Nigeria - Bangladesh - Netherlands - Argentina - Philippines - Malaysia - Colombia - UniteArabEmirates - Romania - Belgium - Switzerland - Singapore - Sweden - Norway - Austria - Kazakhstan - Algeria - Chile - Czechia - Peru ### Return: - Trending # [示例/Example] country = "UnitedStates"

[中文] ### 用途: - 搜索微博用户，支持多种筛选条件。 ### 参数: - query: 搜索关键词（可选） - page: 页码（默认1） - region: 地区编码，从/fetchcitylist获取（可选） - auth: 认证类型 orgvip/pervip/ord（可选） - gender: 性别 man/women（可选） - age: 年龄段 18y/22y/29y/39y/40y（可选） - nickname: 昵称筛选（可选） - tag: 标签筛选（可选） - school: 学校筛选（可选） - work: 公司筛选（可选） ### 返回: - 用户列表，包含uid、昵称、头像、粉丝数、主页链接 ### 注意: - 筛选参数过多可能导致无结果 # [English] ### Purpose: - Search Weibo users with multiple filter options. ### Parameters: - query: Search keyword (optional) - page: Page number (default 1) - region: Region code from /fetchcitylist (optional) - auth: Auth type orgvip/pervip/ord (optional) - gender: Gender man/women (optional) - age: Age bucket 18y/22y/29y/39y/40y (optional) - nickname: Nickname filter (optional) - tag: Tag filter (optional) - school: School filter (optional) - work: Company filter (optional) ### Return: - User list with uid, nickname, avatar, fans count, profile URL ### Note: - Too many filters may result in no results # [示例/Example] query = "yu7" page = 1

[中文] ### 用途: - 搜索视频 ### 参数: - keyword: 关键词 - offset: 偏移量，第一次请求传0，后续请求传上一次请求返回的offset - ordertype: 排序方式，为空时按照默认排序，以下为可选排序方式。 - 最新: publishtime - 最热: playcount - minduration: 最小时长，默认空，单位秒。 - maxduration: 最大时长，默认空，单位秒。 ### 返回: - 视频列表 # [English] ### Purpose: - Search video ### Parameters: - keyword: Keyword - offset: Offset, pass 0 for the first request, pass the offset returned by the previous request for subsequent requests - ordertype: Order type, empty for default sorting, the following are optional sorting methods. - Newest: publishtime - Hottest: playcount - minduration: Minimum duration, default empty, in seconds. - maxduration: Maximum duration, default empty, in seconds. ### Return: - Video list # [示例/Example] > 搜索关键字为“抖音”的视频，按照播放量排序，时长1-180秒(1-3分钟) > Search for videos with the keyword "抖音", sorted by play count, duration 1-180 seconds (1-3 minutes) keyword: "抖音" ordertype: "playcount" minduration: 1 maxduration: 180

[中文] ### 用途: - 搜索视频。 ### 参数: - searchquery: 搜索关键字。 - languagecode: 语言代码，默认为en。 - orderby: 排序方式，默认为thismonth，可选值为thisweek, thismonth, thisyear, lasthour, today。 - countrycode: 国家代码，默认为us。 - continuationtoken: 用于继续获取搜索结果的令牌。默认为None。 ### 返回: - 搜索结果。 # [English] ### Purpose: - Search video. ### Parameters: - searchquery: Search keyword. - languagecode: Language code, default is en. - orderby: Order by, default is thismonth, optional values are thisweek, thismonth, thisyear, lasthour, today. - countrycode: Country code, default is us. - continuationtoken: Token to continue fetching search results. Default is None. ### Returns: - Search results. # [示例/Example] search_query = "Minecraft"