{ "openapi": "3.0.1", "info": { "title": "Likee Scraper", "description": "Extracts views, likes, comments, shares, captions, hashtags, music and author data from Likee videos and creator profiles. Accepts video links or creator IDs, returns clean JSON, CSV or Excel with direct video and thumbnail URLs.", "version": "1.0", "x-build-id": "51grxrsEuMZef3nlQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/innovatica-ai~likee-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-innovatica-ai-likee-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/innovatica-ai~likee-scraper/runs": { "post": { "operationId": "runs-sync-innovatica-ai-likee-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/innovatica-ai~likee-scraper/run-sync": { "post": { "operationId": "run-sync-innovatica-ai-likee-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": { "videoUrls": { "title": "Likee video URLs", "type": "array", "description": "Links to individual Likee videos, e.g. https://likee.video/v/GccqNJ. Both likee.video and l.likee.video links work. Returns full details including the direct MP4 URL.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "includeAuthorVideos": { "title": "Also collect each creator's other videos", "type": "boolean", "description": "For every video URL above, look up who posted it and collect that creator's whole feed. This is how you scrape a creator without knowing their numeric ID — just paste any one of their videos.", "default": false }, "uids": { "title": "Creator IDs", "type": "array", "description": "Numeric Likee creator IDs, e.g. 1274310780. Every result includes an 'authorUid' field, so scrape one video first if you don't know the ID. Likee profile handles (@username) cannot be looked up — see the README.", "items": { "type": "string" } }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Hard cap on how many videos this run returns in total, across every input. Controls your cost.", "default": 100 }, "maxVideosPerProfile": { "title": "Maximum videos per creator", "minimum": 1, "maximum": 5000, "type": "integer", "description": "How many videos to collect from each creator, newest first.", "default": 50 }, "maxConcurrency": { "title": "Concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many requests run in parallel. Lower this if you see failures.", "default": 5 }, "minViews": { "title": "Minimum views", "minimum": 0, "type": "integer", "description": "Skip videos below this view count." }, "minLikes": { "title": "Minimum likes", "minimum": 0, "type": "integer", "description": "Skip videos below this like count." }, "minComments": { "title": "Minimum comments", "minimum": 0, "type": "integer", "description": "Skip videos below this comment count." }, "minShares": { "title": "Minimum shares", "minimum": 0, "type": "integer", "description": "Skip videos below this share count." }, "minEngagementRate": { "title": "Minimum engagement rate", "minimum": 0, "maximum": 100, "type": "integer", "description": "Skip videos below this engagement rate, as a percentage of views. Engagement is likes + comments + shares." }, "publishedAfter": { "title": "Published after", "type": "string", "description": "Only keep videos posted on or after this date." }, "publishedBefore": { "title": "Published before", "type": "string", "description": "Only keep videos posted on or before this date." }, "onlyNewResults": { "title": "Only return videos not seen before", "type": "boolean", "description": "Remembers which videos previous runs returned and skips them. Use this for scheduled monitoring so you only pay for genuinely new content.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Likee blocks datacenter IPs on video pages, so RESIDENTIAL proxy is required when scraping video URLs. Creator-ID scraping works without a proxy and costs you nothing extra.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } }, "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 } } } } } } } } } }