Likee Scraper

Turn any Likee video link into structured data: the video's stats and a playable mp4, the creator behind it, their full video history, and computed creator analytics. Discover creators by country, filter by engagement, and monitor accounts for new posts. Export everything as JSON, CSV or Excel.

Fast and cheap: plain HTTP, no browser. A typical run finishes in under 30 seconds.

What you get

• Video data from a share link. Paste a https://l.likee.video/v/… link (in the app: video → Share → Copy link). You get views, likes, comments, shares, engagement rate, caption, hashtags, music, publish date, cover image and a direct mp4 URL you can play or download.
• The creator behind every link. By default the actor also scrapes the poster's profile and their most recent videos (up to 100), so one link gives you a whole account. Turn this off for a cheap single-video lookup.
• Creator analytics. Per account: posts per week, posts in the last 7 and 30 days, average and median views, average likes, comments, shares and engagement rate, and the best-performing recent video.
• Creator discovery by country. Pull Likee's recommended creators for a country, filter by minimum followers, and optionally hydrate each one's videos and analytics.
• Trending hashtag metadata. Post count, play count and follower count for hashtags on Likee's trending list.
• Engagement and date filters. Minimum views, likes, comments, shares, engagement rate, and a publish-date window. Filtered-out videos never count against your result budget.
• Monitoring mode. onlyNewResults returns only videos you haven't seen on a previous run with the same targets. Schedule it and get a feed of new posts.
• Clean, flat output. The Overview table shows Author, Views, Likes, Comments, Shares, Engagement % and MP4 as columns. No nested JSON to expand.

Quick start

1. Paste one or more share links into Video share URLs.
2. Leave Also scrape the creator on if you want the full account, or turn it off for one record per link.
3. Run. Results land in the dataset within seconds.

Minimal input:

{
    "videoUrls": ["https://l.likee.video/v/oaoej1"]
}

With defaults, that single link returns about 100 records: the linked video with its mp4, the creator's profile, their recent videos and one creator-analytics record.

What a run costs

Pricing is per result, so you only pay for records that land in your dataset. Filtered-out videos are free. Two reference points at the list price of $5 per 1,000 results:

Run	Records	Cost
One share link, creator scraping off	1	half a cent
One share link, defaults	about 100	about $0.50

Compute is negligible: a run uses 256 MB of memory for under a minute.

Output

Every record carries a type field: video, profile, creator, creatorAnalytics or hashtag. Fields Likee doesn't expose are null, never guessed.

Video (from a share link, so media.videoUrl is populated):

{
    "type": "video",
    "videoId": "7641427886757765070",
    "description": "#dance #fyp",
    "author": {
        "uid": "71622063",
        "username": "HouseofB",
        "nickname": "HouseofBrooklyn",
        "avatar": "https://img.like.video/...",
        "profileUrl": "https://likee.video/@HouseofB",
        "isPrivate": false
    },
    "stats": { "views": 2430000, "likes": 168070, "comments": 14230, "shares": 8470 },
    "engagementRate": 7.85,
    "media": {
        "videoUrl": "https://video.like.video/.../....mp4",
        "coverUrl": "https://videosnap.like.video/...",
        "width": 1080,
        "height": 1920,
        "download": null
    },
    "hashtags": ["dance", "fyp"],
    "mentions": [],
    "music": { "id": "123456", "name": "Original sound" },
    "country": "US",
    "publishedAt": "2026-05-11T12:22:53.000Z",
    "matchedQueries": [],
    "matchedHashtags": [],
    "scrapedAt": "2026-09-26T00:00:00.000Z"
}

Videos collected from a creator's profile have the same shape with exact counts from Likee's API. Their media.videoUrl is null; the mp4 is only available through the share page, which is why share links are the recommended entry point. When the same video arrives from both paths, the mp4 is kept.

Profile (one per scraped account):

{
    "type": "profile",
    "uid": "1324736462",
    "username": "HouseofB",
    "nickname": "HouseofBrooklyn",
    "avatar": "https://img.like.video/...",
    "followers": 8756507,
    "following": 118,
    "isPrivate": false,
    "videoCount": 30,
    "profileUrl": "https://likee.video/@HouseofB",
    "scrapedAt": "2026-09-26T00:00:00.000Z"
}

Creator (from discovery):

{
    "type": "creator",
    "uid": "1324736462",
    "likeid": "someLikeId",
    "nickName": "Some Creator",
    "fansCount": 52000,
    "followCount": 120,
    "avatar": "https://img.like.video/...",
    "country": "US",
    "scrapedAt": "2026-09-26T00:00:00.000Z"
}

Creator analytics:

{
    "type": "creatorAnalytics",
    "uid": "1324736462",
    "videosAnalyzed": 30,
    "postsLast7d": 3,
    "postsLast30d": 12,
    "postsPerWeek": 2.8,
    "avgViews": 45210.5,
    "medianViews": 38000,
    "avgLikes": 3021.4,
    "avgComments": 88.2,
    "avgShares": 210.1,
    "avgEngagementRate": 7.35,
    "viewToFollowerRatio": 0.87,
    "bestRecentVideoId": "7641427886757765070",
    "scrapedAt": "2026-09-26T00:00:00.000Z"
}

Hashtag metadata (found: false with null stats when the tag isn't on the trending list):

{
    "type": "hashtag",
    "tagName": "newmusicfriday",
    "found": true,
    "postCnt": 15234,
    "playCnt": 9021332,
    "fansCnt": 525,
    "banners": [],
    "scrapedAt": "2026-09-26T00:00:00.000Z"
}

Input reference

Field	What it does
videoUrls	Share links (l.likee.video/v/… or likee.video/v/…). The main entry point.
hydrateVideoUrlAuthors	Also scrape each link's creator: profile, videos, analytics. Default on.
discoverCreators, country, maxCreators, minFollowers	Creator discovery by country.
hydrateCreatorVideos, videosPerCreatorForAnalytics	Fetch discovered creators' videos so analytics can be computed.
hashtags	Hashtags to look up on the trending list (metadata only).
maxResults	Global cap on records. Spent in order: profile videos → discovery → hashtags.
maxVideosPerProfile	Videos to fetch per account (newest first).
minViews, minLikes, minComments, minShares, minEngagementRate	Drop videos below these thresholds.
publishedAfter, publishedBefore	Keep only videos in this date window.
includeProfileAnalytics	Emit a creatorAnalytics record per account. Default on.
onlyNewResults	Skip videos seen on earlier runs with the same targets.
uids (Advanced)	Numeric account ids, for example from a previous run's output.
proxyConfiguration	Defaults to Apify residential proxy pinned to the US.

A run needs at least one entry point: videoUrls, uids, discoverCreators: true or hashtags.

Full example:

{
    "videoUrls": ["https://l.likee.video/v/oaoej1"],
    "uids": ["1324736462"],
    "discoverCreators": true,
    "country": "US",
    "maxCreators": 50,
    "minFollowers": 1000,
    "hydrateCreatorVideos": true,
    "videosPerCreatorForAnalytics": 30,
    "hashtags": ["newmusicfriday", "dance"],
    "maxResults": 500,
    "maxVideosPerProfile": 100,
    "minViews": 0,
    "minEngagementRate": 0,
    "publishedAfter": "2026-01-01",
    "includeProfileAnalytics": true,
    "onlyNewResults": true
}

Good to know

• Share-page counts are display-rounded. Likee's share page shows "2.43M" rather than an exact number, so a share-link video reports views: 2430000. Videos fetched from a creator's profile carry exact counts. Analytics are computed from the exact ones only.
• Usernames and @handle URLs are not accepted. Likee offers no unsigned way to resolve a handle to an account. Paste any of the creator's video share links instead and the creator is scraped automatically. Supplying usernames or profileUrls fails the run with a message saying so, rather than returning nothing.
• Follower counts on profiles are filled when the same account also appears in creator discovery during the run. Otherwise followers and following are null; there is no unsigned endpoint for a follower count given only a uid.
• Hashtag lookup covers Likee's trending list only. Tags not on it return found: false, and you cannot list the videos under a hashtag.
• Not available: keyword search, hashtag video listing, comments. These endpoints require Likee's signed client requests, which this actor does not reverse-engineer. Passing searchQueries, scrapeComments, maxCommentsPerVideo or hashtagVideos logs a warning and is ignored.
• Blocked regions. Likee is unavailable in some countries (India, for example). If a run reports CONTENT_UNAVAILABLE with a /notfound URL, change the proxy country. The default pins the US.
• onlyNewResults tracks videos only. Profile, creator, analytics and hashtag records are emitted every run.

Run summary

Nothing fails silently. Every run writes a RUN_SUMMARY record to the key-value store with per-type counts, a list of failed requests and notes (PROFILE_NOT_FOUND, PRIVATE_PROFILE, CONTENT_UNAVAILABLE, dead or private share links), any ignored input fields, and whether maxResults was hit before every workflow ran. Runs with failures also show the reason in the run's status banner.

Development

npm install
npm test          # unit tests on fixtures — never hits live Likee
npm run lint
npm run build
npm run start:dev # tsx src/main.ts, reads local .actor/input_schema.json-shaped INPUT

Plain HTTP only (fetch + undici ProxyAgent). No browser, no Playwright/Puppeteer/Crawlee, no reverse-engineered request signing. tests/**/*.live.test.ts files are excluded from npm test and hit the real API; run them with LIVE=1 explicitly and sparingly.