pageinteger
Page number for pagination.
Default: 1
Ximalaya Category Albums
https://api.sandbase.ai/v1/api/ximalaya/category-albumsList albums within a category, sorted by popularity. Category is identified by its pinyin name (from get_categories). Paginates via page number; each page returns up to page_size albums with play counts, track counts, and anchor info.
- Price
- $0.03USD / call
- Method
- POST
- Response
- JSON
- Parameters
- 0 required · 3 optional
Playground
Input
Page number for pagination.
Number of albums per page.
Category pinyin name from get_categories (e.g. youshengshu, yinyue, ertong, xiangsheng, comic, finance, culture, kid, entertainment, train).
OutputReady
Your output will appear here
Complete the inputs, then click Run.
API README
Ximalaya Category Albums API
List albums within a category, sorted by popularity. Category is identified by its pinyin name (from get_categories). Paginates via page number; each page returns up to page_size albums with play counts, track counts, and anchor info.
Request
curl -X POST "https://api.sandbase.ai/v1/run" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "ximalaya/category-albums", "page": 1, "page_size": 10, "category_name": "yinyue"}'
The result is returned in outputs[0].data.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
category_name | string | No | Category pinyin name from get_categories (e.g. youshengshu, yinyue, ertong, xiangsheng, comic, finance, culture, kid, entertainment, train). One of: yinyue, youshengshu, ertong, xiangsheng, comic, finance, `c |
page | integer | No | Page number for pagination. |
page_size | integer | No | Number of albums per page. |
Pricing
Flat $0.03 per call. Failed calls are not charged.
Start building
Send your first request
Platform API endpoint with unified authentication and usage tracking.
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
-X POST "https://api.sandbase.ai/v1/api/ximalaya/category-albums" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'SANDBASE_JSON'
{
"page": 1,
"page_size": 10,
"category_name": "yinyue"
}
SANDBASE_JSON
)
printf '%s\n' "$result"2. Authentication
Set your SandBase API key in your server environment. Requests use Bearer authentication.
export SANDBASE_API_KEY="YOUR_API_KEY"Keep your key on the server. Do not expose it in browser code.
3. Parameters
page_sizeinteger
Number of albums per page.
Default: 30
category_namestring
Category pinyin name from get_categories (e.g. youshengshu, yinyue, ertong, xiangsheng, comic, finance, culture, kid, entertainment, train).
Default: "youshengshu"
Possible values: yinyue, youshengshu, ertong, xiangsheng, comic, finance, culture
4. Response
Saved example response for this API; no live request is made when viewing it.
No saved response has been published. Run the API in Playground to inspect its response.
Explore more
Related APIs
| API | Price | Response |
|---|---|---|
Ximalaya Category AlbumsThis API Ximalaya | $0.03 per call | JSON |
Ximalaya | $0.03 per call | JSON |
Ximalaya | $0.03 per call | JSON |
Ximalaya | $0.03 per call | JSON |
Ximalaya | $0.03 per call | JSON |
Ximalaya | $0.03 per call | JSON |
Questions
FAQ
How do I use the Ximalaya Category Albums API?
Send a POST request to https://api.sandbase.ai/v1/api/ximalaya/category-albums with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.
How much does the Ximalaya Category Albums API cost?
$0.03 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.
What parameters does the Ximalaya Category Albums API accept?
No parameters are required. Optional: page (integer), page_size (integer) and category_name (one of yinyue, youshengshu, ertong, xiangsheng, comic, finance, culture). The Parameters table and the Playground on this page list every field.
What does the Ximalaya Category Albums API return?
A JSON response returned in the same HTTP request (synchronous).
Do I need a Ximalaya developer account or API key?
No. Ximalaya Category Albums runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Ximalaya API access separately.