Likee APIlikee.video ↗
Retrieve public engagement metrics for any Likee video: likes, views, comments, shares, post time, and creator info via a single URL input.
What is the Likee API?
The Likee Video Metrics API exposes 10 data fields per video through a single get_video_metrics endpoint, returning engagement counts and creator metadata for any public Likee video identified by its full URL. Pass a standard https://likee.video/@<likee_id>/video/<post_id> URL and get back likes, views, shares, comments, cover image, publish timestamp, and the creator's handle and display name in one call.
curl -X GET 'https://api.parse.bot/scraper/59850e96-8848-4312-9b13-67a63635fb6e/get_video_metrics?video_url=https%3A%2F%2Flikee.video%2F%40makayla_andrews%2Fvideo%2F7419433952441930327' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace likee-video-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Likee Video Metrics API — fetch engagement stats for a video."""
from parse_apis.likee_video_api import Likee, VideoNotFound
client = Likee()
# Look up a video's public metrics by its full URL.
video = client.videos.get(
video_url="https://likee.video/@makayla_andrews/video/7419433952441930327"
)
print(f"{video.nickname} — {video.description.strip()}")
print(f" views: {video.views} likes: {video.likes} comments: {video.comments} shares: {video.shares}")
print(f" music: {video.music_name}")
print(f" posted: {video.posted_at}")
# Gracefully handle a video that doesn't exist.
try:
client.videos.get(video_url="https://likee.video/@nobody/video/0000000000000000000")
except VideoNotFound:
print("Video not found — the account or video may not exist publicly.")
print("exercised: videos.get / VideoNotFound")
Returns the public metrics of one Likee video from its full web URL of the shape https://likee.video/@<likee_id>/video/<post_id>. The account segment may be the creator's Likee ID or their numeric user ID; both are accepted. The video is located by resolving the account and scanning its public video list from newest to oldest in pages of 50 (up to 1000 videos, so an older video on a very large account costs more round trips and may not be found). likes is the like count and views is the play count as published by Likee; post_time is a Unix timestamp in seconds. Returns a not-found input error when the account does not exist or the video is not among the account's public videos, and a format error for any other URL shape. Short share links of the form https://l.likee.video/v/<code> are NOT supported: the site currently redirects them straight to its homepage without revealing which video they point to, so they are rejected with a format error.
| Param | Type | Description |
|---|---|---|
| video_urlrequired | string | Full Likee video URL, e.g. https://likee.video/@<likee_id>/video/<post_id>. |
{
"type": "object",
"fields": {
"likes": "integer; number of likes",
"views": "integer; number of plays/views",
"shares": "integer; number of shares",
"post_id": "string; the video's numeric post ID as it appears in the URL",
"comments": "integer; number of comments",
"likee_id": "string; the creator's Likee ID (the @ handle)",
"nickname": "string; the creator's display name",
"cover_url": "string; URL of the video cover image",
"post_time": "integer; publish time as a Unix timestamp in seconds",
"video_url": "string; canonical full URL of the video",
"music_name": "string; name of the sound used",
"description": "string; the video caption including hashtags"
},
"sample": {
"data": {
"likes": 289,
"views": 10098,
"shares": 23,
"post_id": "7419433952441930327",
"comments": 28,
"likee_id": "makayla_andrews",
"nickname": "makayla_andrews",
"cover_url": "https://videosnap.like.video/na_live/3a4/2foQEk_4.jpg?wmk_sdk=1&type=8",
"post_time": 1727471582,
"video_url": "https://likee.video/@makayla_andrews/video/7419433952441930327",
"music_name": "Silent Sound",
"description": "Headbands anyone? #LifeUnfiltered #OOTD #Makaylaandrews "
},
"status": "success"
}
}About the Likee API
What the API Returns
The get_video_metrics endpoint accepts one required parameter — video_url — and resolves it to a full set of public engagement data for that Likee video. The response includes four engagement counters (likes, views, shares, comments), two creator identity fields (likee_id as the @ handle, nickname as the display name), a cover_url pointing to the video thumbnail, and post_time as a Unix timestamp in seconds. The post_id and canonical video_url are also echoed back for reference.
URL Format and ID Handling
The video_url input must be a full Likee web URL of the form https://likee.video/@<likee_id>/video/<post_id>. The account segment accepts either the creator's alphanumeric Likee ID or their numeric user ID — both resolve correctly. The post_id returned in the response is the numeric identifier as it appears in the URL path.
Data Scope and Freshness
All metrics reflect the public counts visible on the video's page. Because Likee updates engagement counts in near real-time on its platform, repeated calls to the same video_url at different times will capture metric changes over a video's lifecycle. There is no historical time-series storage in the API itself; each call returns the current snapshot at request time.
The Likee API is a managed, monitored endpoint for likee.video — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when likee.video changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official likee.video API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track likes, views, and shares growth on Likee videos over time by polling
get_video_metricsat regular intervals - Audit influencer deliverables by comparing reported engagement (likes, comments) against API-returned counts
- Collect
post_timeandviewsto analyze how quickly Likee videos accumulate plays after publication - Build creator dashboards that surface
nickname,likee_id, and all four engagement metrics in one data pull - Filter a content catalog by engagement threshold using
likesandcommentsreturned per video URL - Monitor cross-platform performance by correlating Likee
viewsandshareswith metrics from other platforms
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Likee have an official developer API?+
What exactly does `get_video_metrics` return beyond raw counts?+
likes, views, shares, comments), the response includes the creator's likee_id (@ handle) and nickname (display name), a cover_url for the video thumbnail, post_time as a Unix timestamp in seconds, and the canonical video_url and post_id. All fields come back in a single call.Can I retrieve metrics for private or login-gated Likee videos?+
Does the API support fetching a creator's full video list or profile-level statistics?+
Are comment contents or individual commenter data returned?+
comments count as an integer but does not expose comment text, commenter IDs, or timestamps. You can fork this API on Parse and revise it to add a comments detail endpoint.