Vimeo

Search Vimeo groups

Search Vimeo groups by term.

GET/v1/vimeo/groups/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.

Groups, in order.

datagroups[]id
integer

Group id.

≥ 0

datagroups[]name
stringnullable

Group name; null when empty.

datagroups[]description
stringnullable

Description as plain text.

datagroups[]url
stringnullable

Group page URL.

datagroups[]logo
stringnullable

Group logo.

datagroups[]thumbnail
stringnullable

Group thumbnail.

datagroups[]createdAt
stringnullable

When the group was created, in UTC.

datagroups[]updatedAt
stringnullable

When the group was last changed.

The user who created a channel or group.

datagroups[]creatorid
integernullable

Creator id.

≥ 0

datagroups[]creatorname
stringnullable

Creator display name.

datagroups[]creatorurl
stringnullable

Creator profile URL.

Counts for the group.

datagroups[]countsmembers
integernullable

Members.

≥ 0

datagroups[]countsvideos
integernullable

Videos.

≥ 0

Tags on Vimeo.

datagroups[]tags[]
stringoptional

Vimeo category names.

datagroups[]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/groups/search?query=cats" \
  -H "x-api-key: YOUR_API_KEY"

Responses

A page of group search results.