> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/vimeo/videos-videoid-likes>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/vimeo/videos-videoid-likes.mdx>

---

# Vimeo Video Likers API

The users behind a video's likes, as compact records you can store and join by id.

`GET /v1/vimeo/videos/{videoId}/likes` returns `data.users`, a page of the users who liked the video. Each row carries id, name, handle and url; profile fields such as bio, location, counts and avatar sizes are null on this list. Use `users/{user}` for the full record. `data.total` is the like count Vimeo reports, and `data.page` carries the usual `page`, `perPage`, `total`, `hasMore` and `nextCursor`.

Use `limit` up to 100 and follow `page.nextCursor` while `hasMore` is true. A video that is gone or private reads `lookupStatus: not_found`. The route reports likers; the like count on the video itself lives in `data.video.stats.likes` on the video route.

## Request

- **Endpoint:** `GET /v1/vimeo/videos/{videoId}/likes`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by video id
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/vimeo/videos/videoid/likes/get)
- **Platform page:** [/platforms/vimeo](https://www.socialfetch.dev/platforms/vimeo)

## FAQ

### What does each liker include?

id, name, handle and url. Profile fields such as bio, location, counts and avatar sizes are null here; use users/{user} for the full record. The page block has page, perPage, total, hasMore and nextCursor.

### How do I get more likers?

Set limit up to 100 and pass page.nextCursor as cursor while hasMore is true. The cursor is tied to this video and these filters.

### Can I tell hidden likes from zero likes?

On the video route, stats.likes is null when the uploader hides counts, not zero. Here, total is the number Vimeo reports for the list, and an empty page with found is a real list with no rows on that page.

### How many credits does a likers page cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.