modelscope.cn APImodelscope.cn ↗
Access top trending AI models and paginated dataset listings from ModelScope.cn, including download counts, publisher info, licenses, and task types.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/060da0cc-cb57-4a06-bd6e-6f5d2b9f5e3a/get_top_ten_models' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve the top ten trending models on ModelScope.cn. Returns model name, publisher info, release date, engagement metrics, and associated tasks.
No input parameters required.
{
"type": "object",
"fields": {
"models": "array of objects containing model_name, publisher (object with name and full_name), release_date, metrics (object with downloads and likes), and tasks (array of task name strings)"
},
"sample": {
"data": {
"models": [
{
"tasks": [
"text-generation"
],
"metrics": {
"likes": 234,
"downloads": 151637
},
"publisher": {
"name": "deepseek-ai",
"full_name": "DeepSeek"
},
"model_name": "deepseek-ai/DeepSeek-V4-Pro",
"release_date": "2026.04.27"
}
]
},
"status": "success"
}
}About the modelscope.cn API
The ModelScope.cn API exposes 2 endpoints for retrieving AI model and dataset data from China's largest open-source model community. The get_top_ten_models endpoint returns the current top ten trending models with publisher details, release dates, download metrics, and associated ML tasks. The list_datasets endpoint supports pagination to browse available datasets with license and download count data.
Trending Models
The get_top_ten_models endpoint returns an array of up to ten model objects ranked by current popularity on ModelScope.cn. Each object includes model_name, a publisher object with both name and full_name fields, a release_date, and a metrics object that surfaces download counts. Models are also tagged with their associated ML tasks, which is useful for filtering results programmatically on the consumer side.
Dataset Listings
The list_datasets endpoint returns a paginated list of datasets hosted on ModelScope. Each dataset entry includes a name field formatted as namespace/dataset, a publisher, a license string, and a downloads integer. Pagination is controlled via the page and page_size query parameters, both optional integers, allowing you to iterate through the full catalog or fetch a targeted slice.
Data Coverage
Both endpoints reflect data from ModelScope.cn, which hosts a large volume of Chinese-language and multilingual AI models and datasets. The trending model list is a snapshot of current popularity rather than a historical ranking. Dataset records expose license type directly, which is useful when assessing permissive vs. restricted use before pulling training data.
- Monitor which AI models are gaining traction on ModelScope to inform research or competitive analysis.
- Build a dataset discovery tool that filters ModelScope listings by license type before ingestion.
- Track publisher activity by aggregating model and dataset entries from specific namespace/publisher combinations.
- Compare download counts across top-trending models to identify adoption patterns in the Chinese AI ecosystem.
- Populate an internal model registry by syncing the top ten trending models with their task tags and release dates.
- Generate reports on open-source dataset availability, segmented by license, using paginated dataset records.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does ModelScope.cn have an official developer API?+
What does the `get_top_ten_models` endpoint actually return per model?+
model_name, a publisher object with name and full_name, a release_date, a metrics object containing download counts, and an array of associated ML tasks. The list represents the current top ten trending models at query time, not a historical top list.Does the `list_datasets` endpoint support filtering by license or task type?+
name, publisher, license, and downloads per dataset and accepts only page and page_size for pagination — there are no server-side filter parameters. You can fork this API on Parse and revise it to add filtering by license or task type as an additional endpoint.Is model-level detail — such as model card content, tags, or file listings — available through this API?+
How fresh is the trending model data?+
get_top_ten_models endpoint reflects the trending state at the time of the request. ModelScope updates its trending rankings continuously, so results may shift between calls made minutes apart. There is no timestamp field on the response indicating when the ranking was last computed.