Vimeo

Search Vimeo channels

Search Vimeo channels by term.

GET/v1/vimeo/channels/search
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
4
querystringrequiredquery

Search term, e.g. `cats`.

min 1 chars · max 200 chars

pageintegeroptionalquery

Page number, 1-20000. Default: 1. Use `page.nextCursor` to continue; a page past the last is an empty page.

≥ 1 · ≤ 20000

limitintegeroptionalquery

Rows per page, 1-100. Default: 25.

≥ 1 · ≤ 100

cursorstringoptionalquery

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.

min 1 chars · max 512 chars

Response fields
33

Endpoint-specific response payload.

Channels, in order.

datachannels[]id
integer

Channel id.

≥ 0

datachannels[]name
stringnullable

Channel name.

datachannels[]description
stringnullable

Description as plain text.

datachannels[]logo
stringnullable

Channel logo.

datachannels[]badge
stringnullable

Badge text; empty when the channel has none.

datachannels[]url
stringnullable

Channel page URL.

datachannels[]createdAt
stringnullable

When the channel was created, in UTC.

datachannels[]updatedAt
stringnullable

When the channel was last changed.

The user who created a channel or group.

datachannels[]creatorid
integernullable

Creator id.

≥ 0

datachannels[]creatorname
stringnullable

Creator display name.

datachannels[]creatorurl
stringnullable

Creator profile URL.

Counts for the channel.

datachannels[]countsvideos
integernullable

Videos in the channel.

≥ 0

datachannels[]countssubscribers
integernullable

Subscribers.

≥ 0

Tags on Vimeo.

datachannels[]tags[]
stringoptional

Vimeo category names.

datachannels[]categories[]
stringoptional
datatotal
integernullable

Total matches Vimeo reports, when it does.

≥ 0

Pagination state for the current page. A short page is not the end: hasMore says whether another page exists.

datapagepage
integer

Current page number (1-based).

≥ 0

datapageperPage
integernullable

Rows per page, when fixed; otherwise null.

≥ 0

datapagetotal
integernullable

How many rows match; null when no total is available. Vimeo's totals drift between pages.

≥ 0

datapagehasMore
boolean

Whether another page is available. A page can be shorter than `perPage` when a row is unavailable.

datapagenextCursor
stringnullable

Opaque cursor for the next request; null on the last page or an empty page.

datapagetruncated
booleanoptional

True when Vimeo stops this list before its end, so more rows exist beyond the last page.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/vimeo/channels/search?query=cats" \
  -H "x-api-key: YOUR_API_KEY"

Responses

A page of channel search results.