# Baidu Novel Rankings API

> Fetch the hot novel rankings from the Baidu Top board. Returns all novels currently ranked with their scores, along with available genre filter tags that can be used with get_novel_rankings_by_genre or get_board_by_tab.

Source: https://www.sandbase.ai/apis/baidu/novel-rankings
API reference: https://www.sandbase.ai/apis/baidu/novel-rankings#api

## Facts

- Provider: Baidu
- Type: Data API
- Endpoint: `POST https://api.sandbase.ai/v1/api/baidu/novel-rankings`
- Price: $0.03 per call
- Capabilities: api, baidu, trending, china
- Billing: pay per use from one SandBase balance; no provider account or subscription needed

## Call it

`POST https://api.sandbase.ai/v1/api/baidu/novel-rankings` with `Authorization: Bearer $SANDBASE_API_KEY` and the parameters as a JSON body.

## FAQ

### How do I use the Baidu Novel Rankings API?

Send a POST request to https://api.sandbase.ai/v1/api/baidu/novel-rankings 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 Baidu Novel Rankings 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 Baidu Novel Rankings API accept?

Baidu Novel Rankings takes no input parameters; send an empty JSON body.

### What does the Baidu Novel Rankings API return?

A JSON response returned in the same HTTP request (synchronous).

### Do I need a Baidu developer account or API key?

No. Baidu Novel Rankings 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 Baidu API access separately.

## README

### Baidu Novel Rankings API

Fetch the hot novel rankings from the Baidu Top board. Returns all novels currently ranked with their scores, along with available genre filter tags that can be used with get_novel_rankings_by_genre or get_board_by_tab.

#### Request

```bash
curl -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "baidu/novel-rankings"}'
```

The result is returned in `outputs[0].data`.

#### Parameters

| Name | Type | Required | Description |
|---|---|---|---|

#### Pricing

Flat $0.03 per call. Failed calls are not charged.