# Social Fetch API - Vimeo endpoints # Base URL: https://api.socialfetch.dev # Auth: x-api-key header (sfk_...) # Full catalog: https://www.socialfetch.dev/llms-endpoints.txt | JSON: https://www.socialfetch.dev/llms.json # Docs hub: https://www.socialfetch.dev/docs/api | OpenAPI: https://www.socialfetch.dev/openapi.json 31 documented Vimeo operations. Do not invent paths - only the routes below (and their linked markdown pages) are supported. ## GET /v1/vimeo/videos/{videoId} Get Vimeo video Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/vimeo/videos/videoid/get.mdx SDK: client.vimeo.getVideo({ videoId: "76979871" }) Parameters: - videoId (required, string) - Vimeo video id, e.g. `76979871`. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/vimeo/videos/76979871" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/vimeo/videos/{videoId}/embed Get Vimeo embed Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/vimeo/videos/videoid/embed/get.mdx SDK: client.vimeo.getVideoEmbed({ videoId: "76979871" }) Parameters: - videoId (required, string) - Vimeo video id, e.g. `76979871`. - maxWidth (optional, integer) - Maximum width of the embed, in pixels. - maxHeight (optional, integer) - Maximum height of the embed, in pixels. - width (optional, integer) - Fixed width of the embed, in pixels. - hash (optional, string) - Unlisted-video hash, when the video was shared with one. - responsive (optional, boolean) - Ask for responsive iframe markup. - autoplay (optional, boolean) - Ask for autoplay. - dnt (optional, boolean) - Do-not-track, as the embed parameter spells it. - byline (optional, boolean) - Show the uploader byline in the player. - portrait (optional, boolean) - Show the uploader portrait in the player. - title (optional, boolean) - Show the title in the player. - color (optional, string) - Player colour as six hex digits, e.g. `00adef`. Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted` curl "https://api.socialfetch.dev/v1/vimeo/videos/76979871/embed" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/vimeo/videos/{videoId}/captions Get Vimeo video captions Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/vimeo/videos/videoid/captions/get.mdx SDK: client.vimeo.getVideoCaptions({ videoId: "76979871" }) Parameters: - videoId (required, string) - Vimeo video id, e.g. `76979871`. - language (optional, string) - Only return tracks in this language, e.g. `en` or `en-x-autogen`. Matching is case-insensitive, and `en` also matches `en-x-autogen`. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/vimeo/videos/76979871/captions" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/vimeo/videos/browse List Vimeo user or tag videos Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/vimeo/videos/browse/get.mdx SDK: client.vimeo.browseVideos({ tag: "cats" }) Parameters: - tag (optional, string) - Browse videos carrying this tag. - user (optional, string) - Browse a user's videos (handle, numeric id or `user`). - sort (optional, string, enum: date | alphabetical | duration | plays | likes) - Order of the list. Default: date. - page (optional, integer) - Page number, 1-based. Default: 1. - cursor (optional, string) - Opaque cursor, 1 to 512 characters. Pass `page.nextCursor` from the previous response to get the next page; omit it to start at the first page. It is tied to the other filters. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/vimeo/videos/browse?tag=cats" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/vimeo/videos/{videoId}/comments List Vimeo video comments Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/vimeo/videos/videoid/comments/get.mdx SDK: client.vimeo.listVideoComments({ videoId: "76979871", limit: 25 }) Parameters: - videoId (required, string) - Vimeo video id, e.g. `76979871`. - page (optional, integer) - Page number, 1-20000. Default: 1. Use `page.nextCursor` to continue; a page past the last is an empty page. - limit (optional, integer) - Rows per page, 1-100. Default: 25. - cursor (optional, string) - Opaque cursor, 1 to 512 characters. Pass `page.nextCursor` from the previous response to get the next page; omit it to start at the first page. It is tied to the other filters. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/vimeo/videos/76979871/comments?limit=25" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/vimeo/videos/{videoId}/credits List Vimeo video credits Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/vimeo/videos/videoid/credits/get.mdx SDK: client.vimeo.listVideoCredits({ videoId: "76979871" }) Parameters: - videoId (required, string) - Vimeo video id, e.g. `76979871`. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/vimeo/videos/76979871/credits" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/vimeo/videos/{videoId}/likes List Vimeo video likes Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/vimeo/videos/videoid/likes/get.mdx SDK: client.vimeo.listVideoLikes({ videoId: "76979871", limit: 25 }) Parameters: - videoId (required, string) - Vimeo video id, e.g. `76979871`. - page (optional, integer) - Page number, 1-20000. Default: 1. Use `page.nextCursor` to continue; a page past the last is an empty page. - limit (optional, integer) - Rows per page, 1-100. Default: 25. - cursor (optional, string) - Opaque cursor, 1 to 512 characters. Pass `page.nextCursor` from the previous response to get the next page; omit it to start at the first page. It is tied to the other filters. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/vimeo/videos/76979871/likes?limit=25" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/vimeo/users/{user} Get Vimeo user Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/vimeo/users/user/get.mdx SDK: client.vimeo.getUser({ user: "staff" }) Parameters: - user (required, string) - Vimeo user: a vanity handle (`staff`), a numeric id (`152184`), or `user` (`user185091330`). Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/vimeo/users/staff" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/vimeo/users/{user}/videos List Vimeo user videos Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/vimeo/users/user/videos/get.mdx SDK: client.vimeo.listUserVideos({ user: "staff" }) Parameters: - user (required, string) - Vimeo user: a vanity handle (`staff`), a numeric id (`152184`), or `user` (`user185091330`). - sort (optional, string, enum: date | alphabetical | plays | likes | duration | modified_time) - Order of the videos. One of: date, alphabetical, plays, likes, duration, modified_time. - direction (optional, string, enum: desc | asc) - Direction of the sort: `desc` or `asc`. Default: `asc` for `sort=alphabetical`, otherwise `desc`; also applied when `sort` is omitted. - page (optional, integer) - Page number, 1-20000. Default: 1. Use `page.nextCursor` to continue; a page past the last is an empty page. - limit (optional, integer) - Rows per page, 1-100. Default: 25. - cursor (optional, string) - Opaque cursor, 1 to 512 characters. Pass `page.nextCursor` from the previous response to get the next page; omit it to start at the first page. It is tied to the other filters. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/vimeo/users/staff/videos" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/vimeo/users/{user}/likes List Vimeo user likes Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/vimeo/users/user/likes/get.mdx SDK: client.vimeo.listUserLikes({ user: "staff" }) Parameters: - user (required, string) - Vimeo user: a vanity handle (`staff`), a numeric id (`152184`), or `user` (`user185091330`). - page (optional, integer) - Page number, 1-20000. Default: 1. Use `page.nextCursor` to continue; a page past the last is an empty page. - limit (optional, integer) - Rows per page, 1-100. Default: 25. - cursor (optional, string) - Opaque cursor, 1 to 512 characters. Pass `page.nextCursor` from the previous response to get the next page; omit it to start at the first page. It is tied to the other filters. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/vimeo/users/staff/likes" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/vimeo/users/{user}/appearances List videos a Vimeo user appears in Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/vimeo/users/user/appearances/get.mdx SDK: client.vimeo.listUserAppearances({ user: "staff" }) Parameters: - user (required, string) - Vimeo user: a vanity handle (`staff`), a numeric id (`152184`), or `user` (`user185091330`). - page (optional, integer) - Page number, 1-20000. Default: 1. Use `page.nextCursor` to continue; a page past the last is an empty page. - limit (optional, integer) - Rows per page, 1-100. Default: 25. - cursor (optional, string) - Opaque cursor, 1 to 512 characters. Pass `page.nextCursor` from the previous response to get the next page; omit it to start at the first page. It is tied to the other filters. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/vimeo/users/staff/appearances" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/vimeo/users/{user}/showcases List Vimeo user showcases Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/vimeo/users/user/showcases/get.mdx SDK: client.vimeo.listUserShowcases({ user: "staff" }) Parameters: - user (required, string) - Vimeo user: a vanity handle (`staff`), a numeric id (`152184`), or `user` (`user185091330`). - page (optional, integer) - Page number, 1-20000. Default: 1. Use `page.nextCursor` to continue; a page past the last is an empty page. - limit (optional, integer) - Rows per page, 1-100. Default: 25. - cursor (optional, string) - Opaque cursor, 1 to 512 characters. Pass `page.nextCursor` from the previous response to get the next page; omit it to start at the first page. It is tied to the other filters. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/vimeo/users/staff/showcases" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/vimeo/users/{user}/channels List Vimeo user channels Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/vimeo/users/user/channels/get.mdx SDK: client.vimeo.listUserChannels({ user: "staff" }) Parameters: - user (required, string) - Vimeo user: a vanity handle (`staff`), a numeric id (`152184`), or `user` (`user185091330`). - page (optional, integer) - Page number, 1-20000. Default: 1. Use `page.nextCursor` to continue; a page past the last is an empty page. - limit (optional, integer) - Rows per page, 1-100. Default: 25. - cursor (optional, string) - Opaque cursor, 1 to 512 characters. Pass `page.nextCursor` from the previous response to get the next page; omit it to start at the first page. It is tied to the other filters. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/vimeo/users/staff/channels" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/vimeo/users/{user}/groups List Vimeo user groups Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/vimeo/users/user/groups/get.mdx SDK: client.vimeo.listUserGroups({ user: "staff" }) Parameters: - user (required, string) - Vimeo user: a vanity handle (`staff`), a numeric id (`152184`), or `user` (`user185091330`). - page (optional, integer) - Page number, 1-20000. Default: 1. Use `page.nextCursor` to continue; a page past the last is an empty page. - limit (optional, integer) - Rows per page, 1-100. Default: 25. - cursor (optional, string) - Opaque cursor, 1 to 512 characters. Pass `page.nextCursor` from the previous response to get the next page; omit it to start at the first page. It is tied to the other filters. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/vimeo/users/staff/groups" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/vimeo/users/{user}/followers List Vimeo user followers Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/vimeo/users/user/followers/get.mdx SDK: client.vimeo.listUserFollowers({ user: "staff", limit: 25 }) Parameters: - user (required, string) - Vimeo user: a vanity handle (`staff`), a numeric id (`152184`), or `user` (`user185091330`). - page (optional, integer) - Page number, 1-400. Default: 1. Use `page.nextCursor` to continue; a page past the last is an empty page. - limit (optional, integer) - Rows per page, 1-100. Default: 25. - cursor (optional, string) - Opaque cursor, 1 to 512 characters. Pass `page.nextCursor` from the previous response to get the next page; omit it to start at the first page. It is tied to the other filters. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/vimeo/users/staff/followers?limit=25" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/vimeo/users/{user}/following List Vimeo user following Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/vimeo/users/user/following/get.mdx SDK: client.vimeo.listUserFollowing({ user: "staff", limit: 25 }) Parameters: - user (required, string) - Vimeo user: a vanity handle (`staff`), a numeric id (`152184`), or `user` (`user185091330`). - page (optional, integer) - Page number, 1-20000. Default: 1. Use `page.nextCursor` to continue; a page past the last is an empty page. - limit (optional, integer) - Rows per page, 1-100. Default: 25. - cursor (optional, string) - Opaque cursor, 1 to 512 characters. Pass `page.nextCursor` from the previous response to get the next page; omit it to start at the first page. It is tied to the other filters. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/vimeo/users/staff/following?limit=25" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/vimeo/channels/{channel} Get Vimeo channel Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/vimeo/channels/channel/get.mdx SDK: client.vimeo.getChannel({ channel: "staffpicks" }) Parameters: - channel (required, string) - Vimeo channel slug or numeric id, e.g. `staffpicks` or `927`. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/vimeo/channels/staffpicks" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/vimeo/channels/{channel}/videos List Vimeo channel videos Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/vimeo/channels/channel/videos/get.mdx SDK: client.vimeo.listChannelVideos({ channel: "staffpicks" }) Parameters: - channel (required, string) - Vimeo channel slug or numeric id, e.g. `staffpicks` or `927`. - sort (optional, string, enum: added | date | plays | likes | comments | duration | alphabetical | manual) - Order of the videos. One of: added, date, plays, likes, comments, duration, alphabetical, manual. - direction (optional, string, enum: desc | asc) - Direction of the sort: `desc` or `asc`. Default: `asc` for `sort=alphabetical`, otherwise `desc`; also applied when `sort` is omitted. - page (optional, integer) - Page number, 1-20000. Default: 1. Use `page.nextCursor` to continue; a page past the last is an empty page. - limit (optional, integer) - Rows per page, 1-100. Default: 25. - cursor (optional, string) - Opaque cursor, 1 to 512 characters. Pass `page.nextCursor` from the previous response to get the next page; omit it to start at the first page. It is tied to the other filters. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/vimeo/channels/staffpicks/videos" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/vimeo/channels/{channel}/subscribers List Vimeo channel subscribers Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/vimeo/channels/channel/subscribers/get.mdx SDK: client.vimeo.listChannelSubscribers({ channel: "staffpicks", limit: 25 }) Parameters: - channel (required, string) - Vimeo channel slug or numeric id, e.g. `staffpicks` or `927`. - page (optional, integer) - Page number, 1-20000. Default: 1. Use `page.nextCursor` to continue; a page past the last is an empty page. - limit (optional, integer) - Rows per page, 1-100. Default: 25. - cursor (optional, string) - Opaque cursor, 1 to 512 characters. Pass `page.nextCursor` from the previous response to get the next page; omit it to start at the first page. It is tied to the other filters. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/vimeo/channels/staffpicks/subscribers?limit=25" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/vimeo/groups/{group} Get Vimeo group Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/vimeo/groups/group/get.mdx SDK: client.vimeo.getGroup({ group: "creativeapps" }) Parameters: - group (required, string) - Vimeo group slug or numeric id, e.g. `creativeapps` or `18850`. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/vimeo/groups/creativeapps" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/vimeo/groups/{group}/videos List Vimeo group videos Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/vimeo/groups/group/videos/get.mdx SDK: client.vimeo.listGroupVideos({ group: "creativeapps" }) Parameters: - group (required, string) - Vimeo group slug or numeric id, e.g. `creativeapps` or `18850`. - page (optional, integer) - Page number, 1-20000. Default: 1. Use `page.nextCursor` to continue; a page past the last is an empty page. - limit (optional, integer) - Rows per page, 1-100. Default: 25. - cursor (optional, string) - Opaque cursor, 1 to 512 characters. Pass `page.nextCursor` from the previous response to get the next page; omit it to start at the first page. It is tied to the other filters. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/vimeo/groups/creativeapps/videos" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/vimeo/groups/{group}/members List Vimeo group members Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/vimeo/groups/group/members/get.mdx SDK: client.vimeo.listGroupMembers({ group: "creativeapps" }) Parameters: - group (required, string) - Vimeo group slug or numeric id, e.g. `creativeapps` or `18850`. - page (optional, integer) - Page number, 1-20000. Default: 1. Use `page.nextCursor` to continue; a page past the last is an empty page. - limit (optional, integer) - Rows per page, 1-100. Default: 25. - cursor (optional, string) - Opaque cursor, 1 to 512 characters. Pass `page.nextCursor` from the previous response to get the next page; omit it to start at the first page. It is tied to the other filters. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/vimeo/groups/creativeapps/members" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/vimeo/showcases/{showcaseId} Get Vimeo showcase Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/vimeo/showcases/showcaseid/get.mdx SDK: client.vimeo.getShowcase({ showcaseId: "11959649" }) Parameters: - showcaseId (required, string) - Vimeo showcase (album) id, e.g. `11959649`. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/vimeo/showcases/11959649" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/vimeo/showcases/{showcaseId}/videos List Vimeo showcase videos Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/vimeo/showcases/showcaseid/videos/get.mdx SDK: client.vimeo.listShowcaseVideos({ showcaseId: "11959649" }) Parameters: - showcaseId (required, string) - Vimeo showcase (album) id, e.g. `11959649`. - page (optional, integer) - Page number, 1-20000. Default: 1. Use `page.nextCursor` to continue; a page past the last is an empty page. - limit (optional, integer) - Rows per page, 1-100. Default: 25. - cursor (optional, string) - Opaque cursor, 1 to 512 characters. Pass `page.nextCursor` from the previous response to get the next page; omit it to start at the first page. It is tied to the other filters. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/vimeo/showcases/11959649/videos" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/vimeo/videos/search Search Vimeo videos Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/vimeo/videos/search/get.mdx SDK: client.vimeo.searchVideos({ query: "cats", limit: 25 }) Parameters: - query (optional, string) - Search term, e.g. `cats`. Required unless `trending=true`; ignored with `trending=true`. - sort (optional, string, enum: relevant | date | alphabetical | plays | likes | comments | duration) - Order of the results. Ignored with `trending=true`. One of: relevant, date, alphabetical, plays, likes, comments, duration. - license (optional, string, enum: CC | CC-BY) - Creative Commons filter: `CC` (any) or `CC-BY`. - trending (optional, boolean) - Return the trending videos instead of a query match. `query` and `sort` are ignored. Cannot be combined with `license`. - page (optional, integer) - Page number, 1-400. Default: 1. Use `page.nextCursor` to continue; a page past the last is an empty page. - limit (optional, integer) - Rows per page, 1-100. Default: 25. - cursor (optional, string) - Opaque cursor, 1 to 512 characters. Pass `page.nextCursor` from the previous response to get the next page; omit it to start at the first page. It is tied to the other filters. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. curl "https://api.socialfetch.dev/v1/vimeo/videos/search?query=cats&limit=25" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/vimeo/users/search Search Vimeo users Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/vimeo/users/search/get.mdx SDK: client.vimeo.searchUsers({ query: "cats", limit: 25 }) Parameters: - query (required, string) - Search term, e.g. `cats`. - sort (optional, string, enum: followers) - Order of the users. One of: followers. - page (optional, integer) - Page number, 1-400. Default: 1. Use `page.nextCursor` to continue; a page past the last is an empty page. - limit (optional, integer) - Rows per page, 1-100. Default: 25. - cursor (optional, string) - Opaque cursor, 1 to 512 characters. Pass `page.nextCursor` from the previous response to get the next page; omit it to start at the first page. It is tied to the other filters. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. curl "https://api.socialfetch.dev/v1/vimeo/users/search?query=cats" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/vimeo/channels/search Search Vimeo channels Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/vimeo/channels/search/get.mdx SDK: client.vimeo.searchChannels({ query: "cats", limit: 25 }) Parameters: - query (required, string) - Search term, e.g. `cats`. - page (optional, integer) - Page number, 1-20000. Default: 1. Use `page.nextCursor` to continue; a page past the last is an empty page. - limit (optional, integer) - Rows per page, 1-100. Default: 25. - cursor (optional, string) - Opaque cursor, 1 to 512 characters. Pass `page.nextCursor` from the previous response to get the next page; omit it to start at the first page. It is tied to the other filters. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. curl "https://api.socialfetch.dev/v1/vimeo/channels/search?query=cats" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/vimeo/groups/search Search Vimeo groups Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/vimeo/groups/search/get.mdx SDK: client.vimeo.searchGroups({ query: "cats", limit: 25 }) Parameters: - query (required, string) - Search term, e.g. `cats`. - page (optional, integer) - Page number, 1-20000. Default: 1. Use `page.nextCursor` to continue; a page past the last is an empty page. - limit (optional, integer) - Rows per page, 1-100. Default: 25. - cursor (optional, string) - Opaque cursor, 1 to 512 characters. Pass `page.nextCursor` from the previous response to get the next page; omit it to start at the first page. It is tied to the other filters. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. curl "https://api.socialfetch.dev/v1/vimeo/groups/search?query=cats" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/vimeo/categories List Vimeo categories Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/vimeo/categories/get.mdx SDK: client.vimeo.listCategories() curl "https://api.socialfetch.dev/v1/vimeo/categories" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/vimeo/tags/{tag}/videos List videos carrying a Vimeo tag Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/vimeo/tags/tag/videos/get.mdx SDK: client.vimeo.listTagVideos({ tag: "cats", limit: 25 }) Parameters: - tag (required, string) - Vimeo tag, in any script, e.g. `cats` or `猫`. - sort (optional, string, enum: plays) - Order of the videos. One of: plays. - page (optional, integer) - Page number, 1-20000. Default: 1. Use `page.nextCursor` to continue; a page past the last is an empty page. - limit (optional, integer) - Rows per page, 1-100. Default: 25. - cursor (optional, string) - Opaque cursor, 1 to 512 characters. Pass `page.nextCursor` from the previous response to get the next page; omit it to start at the first page. It is tied to the other filters. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/vimeo/tags/cats/videos?limit=25" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/vimeo/ondemand/{slug} Get Vimeo On Demand title Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/vimeo/ondemand/slug/get.mdx SDK: client.vimeo.getOnDemand({ slug: "pariah" }) Parameters: - slug (required, string) - Vimeo On Demand slug or numeric id, e.g. `pariah`. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/vimeo/ondemand/pariah" \ -H "x-api-key: YOUR_API_KEY"