{ "openapi": "3.0.1", "info": { "title": "Likee Scraper - Creators by Country, Video Views & Likes", "description": "Scrape Likee profiles and videos: a creator's followers, total likes and bio, and each video's views, likes, comments, shares, caption and hashtags, from a Likee ID, @handle or profile URL. Plus top creators by country and trending hashtags. No login. $8 per 1,000 creators or videos; failures free.", "version": "1.0", "x-build-id": "oVRStl6YvmUmZIrRy" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tenfoldfleet~likee-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tenfoldfleet-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/tenfoldfleet~likee-scraper/runs": { "post": { "operationId": "runs-sync-tenfoldfleet-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/tenfoldfleet~likee-scraper/run-sync": { "post": { "operationId": "run-sync-tenfoldfleet-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": { "profiles": { "title": "Profiles (Likee ID, @handle or URL)", "type": "array", "description": "Likee creators to scrape: a Likee ID (theAINA), an @handle (@theAINA) or a profile link (https://likee.video/@theAINA). Case does not matter. Numeric Likee IDs work too; to look up an internal user id instead, write uid:1329716493. Each creator returns one profile row plus up to \"Max videos per creator\" videos. Free Apify plan: runs return at most 50 results.", "items": { "type": "string" } }, "maxVideosPerCreator": { "title": "Max videos per creator", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Newest videos to return per creator, with views, likes, comments, shares, caption, hashtags and music. 0 = profile row only.", "default": 30 }, "topCreatorsCountries": { "title": "Top creators: country codes", "type": "array", "description": "Two-letter ISO country codes (RU, ID, SA, EG, MX, BR, GB, US...); UK is read as GB. Returns Likee's top creators for that country's region, up to 100, with followers and total likes. Likee shares one list across several countries (US and IN get the same list, SA and EG too), so creators are listed once with every requested country they appear for.", "items": { "type": "string" } }, "maxTopCreatorsPerCountry": { "title": "Max top creators per country", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many creators to take from each country's top list (Likee's lists hold up to 100).", "default": 100 }, "includeTopCreatorVideos": { "title": "Also get the top creators' videos", "type": "boolean", "description": "Also return up to \"Max videos per creator\" videos of each top creator (billed per video).", "default": false }, "trendingHashtagsCountries": { "title": "Trending hashtags: country codes", "type": "array", "description": "Two-letter country codes. Returns the hashtags Likee recommends in that country, with total views and post counts. Lists are short for most countries (RU has about 80, US about 8, ID none); a country without a list is free.", "items": { "type": "string" } }, "maxHashtagsPerCountry": { "title": "Max hashtags per country", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many hashtags to take from each country's list.", "default": 100 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many creators to scrape in parallel.", "default": 5 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify datacenter proxy by default, which works for Likee. Residential proxy is not needed.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }