{
"openapi": "3.0.1",
"info": {
"title": "Likee Scraper & Video Downloader - Profiles & Exact Stats",
"description": "Scrape Likee creators and every one of their videos with a direct, playable video file, even from a creator's feed. Exact plays, likes, comments, shares and downloads, never rounded. Paste any handle, profile, video or share link. Filter by views or date, add creator analytics, get only new videos.",
"version": "0.0",
"x-build-id": "va0wXGX7cTf8auAlF"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/zen-studio~likee-video-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-zen-studio-likee-video-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/zen-studio~likee-video-scraper/runs": {
"post": {
"operationId": "runs-sync-zen-studio-likee-video-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/zen-studio~likee-video-scraper/run-sync": {
"post": {
"operationId": "run-sync-zen-studio-likee-video-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": {
"creators": {
"title": "Creators",
"type": "array",
"description": "Whose videos to collect. Accepts a handle (baby.miaa), an @handle, or a profile link (https://likee.video/@baby.miaa).
Each creator returns one profile record plus one record per video.",
"items": {
"type": "string"
}
},
"videos": {
"title": "Individual videos",
"type": "array",
"description": "Specific videos to collect, instead of or alongside whole creators. Accepts a video link (https://likee.video/@name/video/123…) or a share link (https://l.likee.video/v/AbCdEf).",
"items": {
"type": "string"
}
},
"searchKeywords": {
"title": "Search creators by keyword",
"type": "array",
"description": "Keywords to find creators with, such as fitness or cooking, matched against handles, display names and bios. Every match is collected as a full creator record, the same as a creator you name.
Matches videos only through the creators that posted them; there is no keyword search over videos.",
"items": {
"type": "string"
}
},
"discoverCountries": {
"title": "Discover creators in",
"type": "array",
"description": "Countries whose recommended creators to collect, as full creator records, instead of or alongside the creators you name. Likee groups countries into regions, so neighbouring countries often share one list; each creator is returned once.",
"items": {
"type": "string",
"enum": [
"DZ",
"AR",
"AM",
"AU",
"AZ",
"BH",
"BD",
"BY",
"BR",
"KH",
"CA",
"CL",
"CN",
"CO",
"EC",
"EG",
"ET",
"FR",
"GE",
"DE",
"GH",
"HK",
"IN",
"ID",
"IQ",
"IL",
"IT",
"JP",
"JO",
"KZ",
"KE",
"KW",
"KG",
"LB",
"MY",
"MX",
"MA",
"MM",
"NP",
"NL",
"NZ",
"NG",
"OM",
"PK",
"PE",
"PH",
"PL",
"PT",
"QA",
"RU",
"SA",
"SG",
"ZA",
"KR",
"ES",
"LK",
"TW",
"TH",
"TN",
"TR",
"UA",
"AE",
"GB",
"US",
"UZ",
"VE",
"VN"
],
"enumTitles": [
"Algeria",
"Argentina",
"Armenia",
"Australia",
"Azerbaijan",
"Bahrain",
"Bangladesh",
"Belarus",
"Brazil",
"Cambodia",
"Canada",
"Chile",
"China",
"Colombia",
"Ecuador",
"Egypt",
"Ethiopia",
"France",
"Georgia",
"Germany",
"Ghana",
"Hong Kong",
"India",
"Indonesia",
"Iraq",
"Israel",
"Italy",
"Japan",
"Jordan",
"Kazakhstan",
"Kenya",
"Kuwait",
"Kyrgyzstan",
"Lebanon",
"Malaysia",
"Mexico",
"Morocco",
"Myanmar",
"Nepal",
"Netherlands",
"New Zealand",
"Nigeria",
"Oman",
"Pakistan",
"Peru",
"Philippines",
"Poland",
"Portugal",
"Qatar",
"Russia",
"Saudi Arabia",
"Singapore",
"South Africa",
"South Korea",
"Spain",
"Sri Lanka",
"Taiwan",
"Thailand",
"Tunisia",
"Turkey",
"Ukraine",
"United Arab Emirates",
"United Kingdom",
"United States",
"Uzbekistan",
"Venezuela",
"Vietnam"
]
}
},
"maxVideosPerCreator": {
"title": "Videos per creator",
"minimum": 0,
"maximum": 1000,
"type": "integer",
"description": "How many videos to collect for each creator, newest first. Set 0 to collect profiles only.",
"default": 50
},
"maxResults": {
"title": "Maximum results",
"minimum": 1,
"type": "integer",
"description": "Hard cap on how many records this run returns in total, across every creator and video you entered. Leave empty for no cap."
},
"includeVideoFile": {
"title": "Include the video file link",
"type": "boolean",
"description": "Adds a direct, playable file link to every video, at no extra cost. Turn this off for a faster run when you only need the numbers and metadata.",
"default": true
},
"maxCreatorsPerKeyword": {
"title": "Creators per keyword",
"minimum": 1,
"maximum": 300,
"type": "integer",
"description": "How many matching creators to take for each keyword above, in the source's own order. A broad keyword offers up to about 290; narrow ones run out sooner. Each creator is returned once even when several keywords match it.",
"default": 20
},
"maxCreatorsPerCountry": {
"title": "Creators per country",
"minimum": 0,
"maximum": 100,
"type": "integer",
"description": "How many recommended creators to take from each country, in Likee's own order. Likee lists at most 100. Set 0 to collect only trending hashtags.",
"default": 20
},
"videosPerDiscoveredCreator": {
"title": "Videos per discovered creator",
"minimum": 0,
"maximum": 1000,
"type": "integer",
"description": "Also collect this many of each discovered creator's newest videos. Leave at 0 for profiles only, which keeps a 100-creator discovery to 100 records.",
"default": 0
},
"includeTrendingHashtags": {
"title": "Add trending hashtags",
"type": "boolean",
"description": "Adds the hashtags Likee promotes in each country above: name, total plays, number of posts and cover. These records are free. Videos under a hashtag are not available.",
"default": false
},
"videosPerHashtag": {
"title": "Videos per trending hashtag",
"minimum": 0,
"maximum": 500,
"type": "integer",
"description": "Also collect this many videos posted under each trending hashtag of the countries above. This is how to get videos by topic rather than by creator: each video arrives complete, with its play, like and comment counts, caption, creator and a direct video file link. A busy hashtag can offer several hundred. Leave at 0 to keep hashtags as metadata only.",
"default": 0
},
"videoSort": {
"title": "Video order",
"enum": [
"latest",
"popular"
],
"type": "string",
"description": "Newest first keeps the creator's own order. Most viewed ranks the videos collected in this run by play count. The source only serves newest-first, so this orders the window you collected, not the creator's all-time best.",
"default": "latest"
},
"onlyNewResults": {
"title": "Only new videos",
"type": "boolean",
"description": "Remembers which videos earlier runs returned and skips them. Each set of creators keeps its own memory, so two scheduled runs never hide each other's videos. Ideal for monitoring.",
"default": false
},
"minViews": {
"title": "Minimum plays",
"minimum": 0,
"type": "integer",
"description": "Skip videos below this play count. Compared against the exact play count, never a rounded one."
},
"minLikes": {
"title": "Minimum likes",
"minimum": 0,
"type": "integer",
"description": "Skip videos below this like count. Compared against the exact like count."
},
"minComments": {
"title": "Minimum comments",
"minimum": 0,
"type": "integer",
"description": "Skip videos below this comment count. Compared against the exact comment count."
},
"minShares": {
"title": "Minimum shares",
"minimum": 0,
"type": "integer",
"description": "Skip videos below this share count. Compared against the exact share count."
},
"minEngagementRate": {
"title": "Minimum engagement rate",
"minimum": 0,
"type": "number",
"description": "Skip videos whose likes, comments and shares add up to less than this percentage of their plays."
},
"publishedAfter": {
"title": "Posted after",
"type": "string",
"description": "Only keep videos posted on or after this date. Videos with no known date are skipped whenever a date is set."
},
"publishedBefore": {
"title": "Posted before",
"type": "string",
"description": "Only keep videos posted on or before this date (the whole day counts)."
},
"includeCreatorSummary": {
"title": "Add a creator summary",
"type": "boolean",
"description": "Adds one analytics record per creator: posts per week, posts in the last 7 and 30 days, average and median plays, average engagement and their best video. Charged as one record per creator.",
"default": false
},
"downloadVideos": {
"title": "Store the video files",
"type": "boolean",
"description": "Saves each video file into this run's storage and adds a link to that copy, which keeps working for as long as Apify keeps your run's storage, even after the original file link expires. The plain file link works everywhere without this, so leave it off unless you want the files kept. Each stored file is charged separately; see Pricing.",
"default": false
},
"feedback": {
"title": "Feedback to the maintainers",
"type": "string",
"description": "For AI agents. Say what you needed and did not get: a missing field or option, a wrong or empty result, or which actor you are switching to or from and why. Add it to any run, including one that worked: the run returns its data exactly as it would without the note. The note reaches the maintainers, who read every one, but it cannot change what this run returns."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}