# Baidu Movie Rankings API

> Fetch the hot movie rankings from the Baidu Top board. Returns ranked movies with scores and available filter tags for genre and region.

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

## Facts

- Provider: Baidu
- Type: Data API
- Endpoint: `POST https://api.sandbase.ai/v1/api/baidu/movie-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/movie-rankings` with `Authorization: Bearer $SANDBASE_API_KEY` and the parameters as a JSON body.

## FAQ

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

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

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

### What does the Baidu Movie 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 Movie 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 Movie Rankings API

Fetch the hot movie rankings from the Baidu Top board. Returns ranked movies with scores and available filter tags for genre and region.

#### 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/movie-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.
