{ "openapi": "3.0.1", "info": { "title": "Douyin Xingtu KOL Scraper 巨量星图 [From $4] Prices & Rankings", "description": "[From $4 per 1000 rows] Douyin influencer data from Xingtu (巨量星图): search creators by name or content with quoted video prices, expected plays, CPM, engagement and e-commerce ranges; brand-deal rankings by category; brands worked with. No login. Rankings $4, creators $10 per 1,000.", "version": "0.1", "x-build-id": "ItCTAFtmsv2phaStu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~douyin-xingtu-kol-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-douyin-xingtu-kol-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/memo23~douyin-xingtu-kol-scraper/runs": { "post": { "operationId": "runs-sync-memo23-douyin-xingtu-kol-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/memo23~douyin-xingtu-kol-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-douyin-xingtu-kol-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "keywords": { "title": "Creator search keywords", "type": "array", "description": "Find Xingtu creators by nickname, or by what their videos are about (see 'Search by'). Each result is a `kol` row with quoted prices, expected plays, CPM, engagement and e-commerce ranges.", "items": { "type": "string" } }, "searchBy": { "title": "Search by", "enum": [ "nickname", "content" ], "type": "string", "description": "What the keywords are matched against.", "default": "nickname" }, "browseWithFilters": { "title": "Browse by filters only", "type": "boolean", "description": "Also run one search with no keyword, using only the filters below (followers, gender, price). Ordered by Xingtu's score.", "default": false }, "gender": { "title": "Creator gender", "enum": [ "any", "male", "female" ], "type": "string", "description": "Filter for creator search.", "default": "any" }, "followersMin": { "title": "Followers from", "minimum": 0, "type": "integer", "description": "Filter for creator search: at least this many followers." }, "followersMax": { "title": "Followers up to", "minimum": 0, "type": "integer", "description": "Filter for creator search: at most this many followers." }, "priceTier": { "title": "Price applies to", "enum": [ "1-20s", "21-60s", "over60s" ], "type": "string", "description": "Which quoted price the two price filters below compare against.", "default": "21-60s" }, "priceMin": { "title": "Price from (CNY)", "minimum": 0, "type": "integer", "description": "Filter for creator search: quoted price at least this much, in Chinese yuan." }, "priceMax": { "title": "Price up to (CNY)", "minimum": 0, "type": "integer", "description": "Filter for creator search: quoted price at most this much, in Chinese yuan." }, "maxResultsPerKeyword": { "title": "Max creators per keyword", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Upper bound on creators per keyword. 20 arrive per page.", "default": 40 }, "rankings": { "title": "Rankings", "uniqueItems": true, "type": "array", "description": "Xingtu creator rankings. Each returns the newest edition, 100 creators per category, as `ranking-row` rows.", "items": { "type": "string", "enum": [ "brandPreferred", "a3Seeding", "searchAfterWatch", "ecommerce", "adFlow", "highPotential", "followerGrowth", "topPicks", "shortDramaActors" ], "enumTitles": [ "Brand preferred (品牌优选榜)", "A3 seeding (A3种草榜)", "Search after watch (看后搜榜)", "E-commerce (带货榜)", "Ad flow (投流榜)", "High potential (高潜榜)", "Follower growth dark horses (涨粉黑马榜)", "Top must-picks (头部必选榜)", "Short-drama actors (短剧演员榜)" ] } }, "rankingCategories": { "title": "Ranking categories", "type": "array", "description": "Category names in Chinese, as Xingtu lists them: `美妆`, `食品饮料`, `3C及电器`, `服装配饰`, `母婴宠物`, `日化`, `汽车`; the two content rankings also take `美食`, `旅行`, `时尚` and others. Empty: brand rankings return every category, content rankings their all-categories edition.", "items": { "type": "string" } }, "rankingPeriod": { "title": "Ranking period", "enum": [ "30", "7" ], "type": "string", "description": "Which edition of each ranking to return.", "default": "30" }, "maxItemsPerRanking": { "title": "Max creators per ranking", "minimum": 1, "maximum": 100, "type": "integer", "description": "Upper bound on rows per ranking and category.", "default": 100 }, "creators": { "title": "Creators", "type": "array", "description": "Douyin profile links (`https://www.douyin.com/user/MS4w…`), Douyin handles (抖音号) or Xingtu ids. Each returns a `kol-profile` row: quoted prices, expected plays and costs, six collaboration indices with the creator's standing, credit score, brands worked with, what the audience comments on, what the videos are about and the best and newest videos.", "items": { "type": "string" } }, "includeSimilar": { "title": "Similar creators", "type": "boolean", "description": "For each entry in Creators, add about 12 creators with similar content as `kol` rows with `source: \"similar\"`.", "default": false }, "videos": { "title": "Videos for a report", "type": "array", "description": "Douyin video links or ids. Each returns a `video-report` row: totals, completion rate, the daily curve, viewer retention and likes second by second, and top comments. Available for videos of creators who are on Xingtu.", "items": { "type": "string" } }, "liveStreamerKeywords": { "title": "Live streamer search keywords", "type": "array", "description": "Find Xingtu live streamers by nickname. Each result is a `live-streamer` row with live sessions, viewers, interaction rate and e-commerce ranges.", "items": { "type": "string" } }, "toutiaoKeywords": { "title": "Toutiao creator search keywords", "type": "array", "description": "Find Toutiao (今日头条) creators on Xingtu by nickname. Each result is a `toutiao-creator` row with followers, category and verification.", "items": { "type": "string" } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }