Social Fetch
Start for freeStart free
Vimeo hub

Vimeo Categories API

The catalog root: every top-level category with its slug and subcategories, ready to drive a browse menu.

GET /v1/vimeo/categories

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/vimeo/categories returns data.categories. Each category has id (the slug, such as animation), name, url, topLevel, deprecated, thumbnail, lastVideoFeaturedAt, parent, counts and subcategories. counts can carry videos, channels, groups and users; subcategories each have an id, name and URL.

There is no lookup status and no paging on this route: it returns the category list in one answer. A category that Vimeo marks deprecated is still returned with deprecated: true.

Vimeo Categories API FAQ

What can I build from this route?

A browse menu or a scheduled job that walks every category. Each category gives its slug, name, URL, subcategories and counts, so you don't need to hardcode slugs.

Why is a category deprecated?

deprecated is a flag Vimeo sets on the category. The category is still returned. Treat it as a signal to prefer another category for new work.

How many credits does the category list 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.

Other Vimeo endpoints