---
title: "Get trending"
method: GET
path: "/api/trending"
tags: ["models", "spaces", "datasets"]
---

# Get trending

`GET /api/trending`

Get the trending repositories

## Query parameters

- `type` 'all' | 'dataset' | 'model' | 'space'
- `limit` integer

## Response `200`

Trending repos

- object
  - `recentlyTrending` union[], required
    - union
      - object
        - `repoType` 'dataset', required
        - `repoData` object, required
          - `author` string, required
          - `id` string, required
          - `isLikedByUser` boolean, required
          - `likes` number, required
          - `datasetsServerInfo` object
            - `viewer` 'preview' | 'viewer-partial' | 'viewer', required
            - `numRows` number, nullable, required
            - `libraries` string[], required
            - `formats` string[], required
            - `modalities` string[], required
          - `private` boolean, required
          - `repoType` 'dataset', required
          - `downloads` number, required
          - `gated` union, required
            - unknown
            - 'auto' | 'manual'
          - `lastModified` string, date-time, required
          - `resourceGroup` object
            - `id` string, required
            - `name` string, required
            - `numUsers` number
          - `isBenchmark` boolean
          - `isTraces` boolean
      - object
        - `repoType` 'model', required
        - `repoData` object, required
          - `author` string, required
          - `downloads` number, required
          - `id` string, required
          - `availableInferenceProviders` object[], required
            - `provider` 'baseten' | 'cerebras' | 'cohere' | 'deepinfra' | 'fal-ai' | 'featherless-ai' | 'fireworks-ai' | 'groq' | 'hf-inference' | 'novita' | 'nscale' | 'openai' | 'ovhcloud' | 'publicai' | 'replicate' | 'scaleway' | 'together' | 'wavespeed' | 'zai-org', required
            - `providerStatus` 'live' | 'staging' | 'error', required
            - `modelStatus` 'live' | 'staging' | 'error', required
            - `providerId` string, required
            - `task` 'text-classification' | 'token-classification' | 'table-question-answering' | 'question-answering' | 'zero-shot-classification' | 'translation' | 'summarization' | 'feature-extraction' | 'text-generation' | 'fill-mask' | 'sentence-similarity' | 'text-to-speech' | 'text-to-audio' | 'automatic-speech-recognition' | 'audio-to-audio' | 'audio-classification' | 'audio-text-to-text' | 'voice-activity-detection' | 'depth-estimation' | 'image-classification' | 'object-detection' | 'image-segmentation' | 'text-to-image' | 'image-to-text' | 'image-to-image' | 'image-to-video' | 'unconditional-image-generation' | 'video-classification' | 'reinforcement-learning' | 'robotics' | 'tabular-classification' | 'tabular-regression' | 'tabular-to-text' | 'table-to-text' | 'multiple-choice' | 'text-ranking' | 'text-retrieval' | 'time-series-forecasting' | 'text-to-video' | 'image-text-to-text' | 'image-text-to-image' | 'image-text-to-video' | 'visual-question-answering' | 'document-question-answering' | 'zero-shot-image-classification' | 'graph-ml' | 'mask-generation' | 'zero-shot-object-detection' | 'text-to-3d' | 'image-to-3d' | 'image-feature-extraction' | 'video-text-to-text' | 'keypoint-detection' | 'visual-document-retrieval' | 'any-to-any' | 'video-to-video' | 'other' | 'conversational', required
            - `adapterType` 'lora'
            - `adapterWeightsPath` string
            - `features` object
              - …
            - `isCheapestPricingOutput` boolean, required
            - `isFastestThroughput` boolean, required
            - `isModelAuthor` boolean, required
            - `tokensPerSecond` number
            - `pricingOutput` number
            - `freeUntil` string, date-time
          - `isLikedByUser` boolean, required
          - `lastModified` string, date-time, required
          - `likes` number, required
          - `pipeline_tag` string
          - `private` boolean, required
          - `repoType` 'model', required
          - `gated` union, required
            - unknown
            - 'auto' | 'manual'
          - `resourceGroup` object
            - `id` string, required
            - `name` string, required
            - `numUsers` number
          - `numParameters` number
          - `authorData` union
            - object
              - …
            - object
              - …
          - `widgetOutputUrls` string[]
          - `isPreRelease` unknown
      - object
        - `repoType` 'space', required
        - `repoData` object, required
          - `author` string, required
          - `colorFrom` string, required
          - `colorTo` string, required
          - `createdAt` string, date-time, required
          - `emoji` string, required
          - `id` string, required
          - `isLikedByUser` boolean, required
          - `lastModified` string, date-time, required
          - `likes` number, required
          - `pinned` boolean, required
          - `private` boolean, required
          - `repoType` 'space', required
          - `title` string, required
          - `sdk` 'gradio' | 'docker' | 'static' | 'streamlit'
          - `runtime` object, required
            - `stage` 'NO_APP_FILE' | 'CONFIG_ERROR' | 'BUILDING' | 'BUILD_ERROR' | 'APP_STARTING' | 'RUNNING' | 'RUNNING_BUILDING' | 'RUNNING_APP_STARTING' | 'RUNTIME_ERROR' | 'DELETING' | 'STOPPED' | 'PAUSED' | 'SLEEPING', required
            - `hardware` object, required
              - …
            - `errorMessage` string
            - `gcTimeout` number, nullable
            - `replicas` object, required
              - …
            - `devMode` boolean
            - `domains` object[]
              - …
            - `sha` string
            - `hotReloading` object
              - …
          - `disabled` boolean, required
          - `originRepo` object
            - `author` union, required
              - …
            - `name` string, required
          - `ai_short_description` string
          - `ai_category` string
          - `trendingScore` number
          - `resourceGroup` object
            - `id` string, required
            - `name` string, required
            - `numUsers` number
          - `tags` string[], required
          - `authorData` union
            - object
              - …
            - object
              - …
          - `shortDescription` string
          - `semanticRelevancyScore` number
          - `featured` boolean, required
          - `visibility` 'public' | 'private' | 'protected', required

---

[API](https://skmtc.net/huggingface/apis/hub-api-endpoints.md) · [All operations](https://skmtc.net/huggingface/apis/hub-api-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/huggingface/hub-api-endpoints/versions/dae0cc3790f0/schema)