{ "openapi": "3.0.1", "info": { "title": "Xiaohongshu Influencer Finder - RedNote 蒲公英 Rates & Audience", "description": "Find Xiaohongshu (RedNote) influencers on Pugongying with official post rates, median reads and engagement, CPM, follower growth and audience demographics.", "version": "1.0", "x-build-id": "CYSwOaFxPqKN8TLpQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/seemuapps~xiaohongshu-influencer-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-seemuapps-xiaohongshu-influencer-finder", "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/seemuapps~xiaohongshu-influencer-finder/runs": { "post": { "operationId": "runs-sync-seemuapps-xiaohongshu-influencer-finder", "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/seemuapps~xiaohongshu-influencer-finder/run-sync": { "post": { "operationId": "run-sync-seemuapps-xiaohongshu-influencer-finder", "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": "Search keywords", "type": "array", "description": "Topics to find creators for (e.g. 护肤 skincare, 露营 camping, 咖啡 coffee), or creator nicknames when Search by is set to Nickname. Each keyword is a separate search.", "items": { "type": "string" } }, "searchBy": { "title": "Search by", "enum": [ "content", "nickname" ], "type": "string", "description": "Content finds creators whose notes match the keyword. Nickname looks the keyword up as a creator name.", "default": "content" }, "similarToProfiles": { "title": "Find creators similar to", "type": "array", "description": "RedNote profile links (xiaohongshu.com/user/profile/…) or user IDs. Returns creators similar to each one, combined with the filters below. Each profile is a separate search.", "items": { "type": "string" } }, "categories": { "title": "Creator categories", "type": "array", "description": "Only creators in these Pugongying categories, in Chinese, e.g. 美妆, 护肤, 母婴, 时尚, 美食, 家居家装, 运动健身, 宠物, 出行旅游, 科技数码, 汽车, 教育, 职场. Subcategories like 面部保养 also work. Names must match exactly.", "items": { "type": "string" } }, "locations": { "title": "Creator location", "type": "array", "description": "Only creators based in these provinces or cities, in Chinese, e.g. 上海, 杭州, 广东.", "items": { "type": "string" } }, "minFollowers": { "title": "Min followers", "minimum": 0, "type": "integer", "description": "Only creators with at least this many followers." }, "maxFollowers": { "title": "Max followers", "minimum": 0, "type": "integer", "description": "Only creators with at most this many followers." }, "gender": { "title": "Creator gender", "enum": [ "any", "female", "male" ], "type": "string", "description": "Only creators of this gender.", "default": "any" }, "priceFormat": { "title": "Price filter applies to", "enum": [ "video", "picture" ], "type": "string", "description": "Which official rate the min and max price filters check.", "default": "video" }, "minPriceCny": { "title": "Min price (CNY)", "minimum": 0, "type": "integer", "description": "Only creators whose official rate for one sponsored note is at least this much, in Chinese yuan." }, "maxPriceCny": { "title": "Max price (CNY)", "minimum": 0, "type": "integer", "description": "Only creators whose official rate for one sponsored note is at most this much, in Chinese yuan." }, "noteType": { "title": "Main content format", "enum": [ "any", "picture", "video" ], "type": "string", "description": "Only creators who mostly post picture notes or mostly post videos.", "default": "any" }, "audienceGender": { "title": "Audience gender", "enum": [ "any", "mostlyFemale", "mostlyMale" ], "type": "string", "description": "Only creators whose followers are mostly this gender.", "default": "any" }, "audienceAge": { "title": "Audience age", "enum": [ "any", "under18", "18to24", "25to34", "35to44", "over44" ], "type": "string", "description": "Only creators whose followers are mostly in this age group.", "default": "any" }, "excludeInactive": { "title": "Exclude inactive creators", "type": "boolean", "description": "Skip creators Pugongying flags as low-activity.", "default": false }, "excludeLosingFollowers": { "title": "Exclude creators losing followers", "type": "boolean", "description": "Skip creators whose follower count is falling.", "default": false }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "followers", "price", "medianEngagement", "medianReads", "thousandLikeRate", "followerGrowth", "videoCompletion", "replyRate" ], "type": "string", "description": "How results are ordered (highest first).", "default": "relevance" }, "maxCreatorsPerSearch": { "title": "Max creators per search", "minimum": 10, "maximum": 5000, "type": "integer", "description": "How many creators to collect for each keyword or similar-creator search.", "default": 50 }, "includeAudience": { "title": "Include audience demographics", "type": "boolean", "description": "Also get each creator's follower breakdown by gender, age, interests, province, city and phone brand. Charged as an extra audience-details event per creator.", "default": false } } }, "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 } } } } } } } } } }