# Weibo User Album API

> Returns the photo and media album content of a specified Weibo user. Supports cursor-based pagination using the since_id parameter.

Source: https://www.sandbase.ai/apis/weibo/app/user-album
API reference: https://www.sandbase.ai/apis/weibo/app/user-album/docs

## Facts

- Provider: Weibo
- Type: Data API
- Endpoint: `POST https://api.sandbase.ai/v1/api/weibo/app/user-album`
- Price: $0.0015 per call
- Free allowance: 100 calls per organization per UTC day, shared across eligible APIs
- Capabilities: api, weibo
- Billing: pay per use from one SandBase balance; no provider account or subscription needed

## Call it

`POST https://api.sandbase.ai/v1/api/weibo/app/user-album` with `Authorization: Bearer $SANDBASE_API_KEY` and the parameters as a JSON body.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `uid` | string | yes |  |
| `since_id` | any | no |  |

## FAQ

### How do I use the Weibo User Album API?

Send a POST request to https://api.sandbase.ai/v1/api/weibo/app/user-album 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 Weibo User Album API cost?

$0.0015 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.

### What parameters does the Weibo User Album API accept?

Required: uid (string). Optional: since_id (any). The Parameters table and the Playground on this page list every field.

### What does the Weibo User Album API return?

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

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

No. Weibo User Album 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 Weibo API access separately.

## README

### Weibo User Album API

Retrieve album media content for a specific Weibo account using `uid`. Supports cursor-based pagination via `since_id` to cycle through pages.

#### Use cases

- Inspect photo and media albums belonging to a specified Weibo user.
- Extract media assets from a creator profile for digital archiving.
- Browse historical profile images chronologically using cursor pagination.

#### Request

```bash
curl -X POST "https://api.sandbase.ai/v1/api/weibo/app/user-album" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"uid": "<uid>"}'
```

#### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `uid` | string | Yes | User ID (required) |
| `since_id` | string | No | Pagination cursor, don't pass for first request, use returned since_id for subsequent requests |

#### Notes

- Requires `uid` to identify the target Weibo account.
- Do not pass `since_id` on the initial request; use the returned value for subsequent requests.

#### Related APIs

- [Weibo App AI Smart Search](/model/weibo/app/ai-smart-search): Returns AI smart search channel results and feed metadata from Weibo for a specified keyword query, with optional page-based pagination.
- [Weibo Home Recommend Feed](/model/weibo/app/home-recommend-feed): Returns recommended feed items from the Weibo app homepage, with options to paginate and specify the number of items per request.
- [Weibo Hot Search Rankings](/model/weibo/app/hot-search): Returns current Weibo hot search rankings across various categories.
