{ "openapi": "3.0.1", "info": { "title": "Likee Scraper | Profile URLs, Video Stats & Growth", "description": "Scrape Likee videos from public profile URLs, handles or creator UIDs. Export exact views, likes, comments and shares, track growth between runs, and return only new or changed videos. Bulk profiles, filters, creator summaries and CSV. No login or API key.", "version": "0.1", "x-build-id": "hePfb2CCBGu5LIB6c" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/cauldo~likee-creator-video-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-cauldo-likee-creator-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/cauldo~likee-creator-video-scraper/runs": { "post": { "operationId": "runs-sync-cauldo-likee-creator-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/cauldo~likee-creator-video-scraper/run-sync": { "post": { "operationId": "run-sync-cauldo-likee-creator-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": { "profiles": { "title": "Likee profiles or handles", "type": "array", "description": "Public profile URLs (https://likee.video/@theAINA), @handles, or visible numeric Likee IDs. Handles resolve automatically; internal creator UIDs go in Creator UIDs below.", "items": { "type": "string" } }, "creatorUids": { "title": "Creator UIDs (optional)", "type": "array", "description": "Internal numeric posterUid/creatorUid values from a previous result. These are different from the visible Likee ID.", "default": [], "items": { "type": "string" } }, "maxResults": { "title": "Maximum videos returned", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Global maximum across profiles. Only videos saved to the dataset are charged. The run charge limit can reduce this further.", "default": 100 }, "maxVideosPerProfile": { "title": "Maximum videos inspected per profile", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Newest-first source window before filters. Limits work even if filters or monitoring return no rows. A limited window is not a complete archive.", "default": 100 }, "mode": { "title": "Output mode", "enum": [ "snapshot", "new", "changed" ], "type": "string", "description": "Monitoring uses the named monitor below. First run returns a baseline. Changed mode compares views, likes, comments and shares. Unchanged videos are free.", "default": "snapshot" }, "monitorName": { "title": "Monitor name (optional for snapshot)", "type": "string", "description": "Reuse a unique name across scheduled runs to retain history and calculate growth. Required for new/changed mode. Letters, digits and hyphens, max 50. Use one non-overlapping schedule per name; storage is in your own Apify account." }, "minViews": { "title": "Minimum views", "minimum": 0, "type": "integer", "description": "Videos below the threshold are skipped before charging.", "default": 0 }, "minEngagementRate": { "title": "Minimum engagement rate (%)", "minimum": 0, "maximum": 100000, "type": "number", "description": "100 × (likes + comments + shares) / views. Videos with unavailable counts or zero views cannot pass a positive threshold.", "default": 0 }, "publishedAfter": { "title": "Published on or after (UTC)", "type": "string", "description": "Optional YYYY-MM-DD, inclusive." }, "publishedBefore": { "title": "Published on or before (UTC)", "type": "string", "description": "Optional YYYY-MM-DD, inclusive." }, "captionContains": { "title": "Caption contains (optional)", "type": "string", "description": "Case-insensitive literal text filter on the public video caption." }, "proxyConfiguration": { "title": "Optional proxy", "type": "object", "description": "Direct public API requests work in our tests. Enable your Apify proxy only if your region needs it. Custom proxy-provider costs are outside the Actor price.", "default": { "useApifyProxy": 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 } } } } } } } } } }