# Weibo Search

## Overview

| Property | Value |
|----------|-------|
| **Status** | degraded |
| **Method** | `GET` |
| **Endpoint** | `/v2/weibo/search` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/weibo-search |

## Description

Search Weibo using a mobile search URL to retrieve posts, users, and content matching a keyword or hashtag.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/weibo/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Search Weibo for a hashtag

```json
{
  "response": [
    {
      "card_type": 11,
      "show_type": 0,
      "card_group": [
        {
          "users": [
            {
              "id": 1783643950,
              "gender": "f",
              "verified": false,
              "profile_url": "https://m.weibo.cn/u/1783643950?",
              "screen_name": "E米1",
              "follow_count": 361,
              "statuses_count": 1829,
              "followers_count": "238",
              "profile_image_url": "https://tvax4.sinaimg.cn/crop.0.0.996.996.180/6a503f2ely8g94d5s1tifj20ro0rotbg.jpg"
            }
          ]
        }
      ]
    }
  ]
}
```

## Documentation

## Overview
The Weibo Search endpoint retrieves search results from Weibo's mobile platform for keywords, hashtags, or topics.

## Quickstart
```
GET https://api.piloterr.com/v2/weibo/search?query=https://m.weibo.cn/search?containerid=...&page=1
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Weibo search URL |
| `page` | integer | no | Page number (default: 1) |

## Response fields
| Field | Type | Description |
|---|---|---|
| `response` | array | Card objects from search results |
| Users | object | User profiles with follower counts |

## Notes
- Generate search URLs from m.weibo.cn.
- Use `page` for pagination.
- Currently degraded.

## Main use cases
- Monitor brand mentions and hashtags on Weibo
- Track Chinese influencer activity and growth
- Build Chinese social listening tools
- Track consumer sentiment on Weibo