# Popular Sharelists

`GET` `/v1/sharelists/popular`

Get popular/trending sharelists from the community.

## Parameters

### Query Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `count` | integer | No | Maximum number of results, default 20 |

## Request Example

```bash
curl --request GET \
  --url 'https://openapi.longbridge.com/v1/sharelists/popular' \
  --header 'Authorization: Bearer <access_token>'
```

## Response

### Response Properties

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `sharelists` | object[] | No | User's own sharelists |
| `└ id` | string | No | Sharelist ID |
| `└ subscribers_count` | integer | No | Number of subscribers |
| `└ stocks_count` | integer | No | Number of securities in the list. |
| `└ name` | string | No | Security name. |
| `└ description` | string | No | Description |
| `└ cover` | string | No | Cover image URL |
| `└ created_at` | string | No | Unix timestamp (seconds) when the topic was created |
| `└ this_year_chg` | string | No | Year-to-date change percentage |
| `└ status` | integer | No | Final run status: `succeeded` / `interrupted` / `failed` / `stopped` |
| `└ edited_at` | string | No | Last edit time. |
| `└ digest` | string | No | Short description / digest. |
| `└ creator` | object | No | Creator user name. |
| `└ ∟ id` | string | No | Sharelist ID |
| `└ ∟ name` | string | No | Security name. |
| `└ ∟ avatar` | string | No | Author avatar URL |
| `└ ∟ member_id` | string | No | Author member ID |
| `└ ∟ scopes` | object | No | Subscription scope info |
| `└ ∟ ∟ followed` | boolean | No | Whether the current user follows this list. |
| `└ ∟ ∟ following` | boolean | No | Whether following the creator. |
| `└ ∟ ∟ self` | boolean | No | Whether the list belongs to the current user. |
| `└ ∟ ∟ blocked` | boolean | No | Whether blocked by the current user. |
| `└ ∟ ∟ special_following` | boolean | No | Whether specially followed. |
| `└ ∟ ∟ be_blocked` | boolean | No | Whether the current user is blocked. |
| `└ ∟ ∟ trade_following` | boolean | No | Whether copy-trade following. |
| `└ ∟ profile_id` | string | No | Profile ID. |
| `└ ∟ group_scopes` | object | No | Group permission scopes. |
| `└ ∟ ∟ joined` | boolean | No | Whether the user has joined. |
| `└ ∟ group_member` | string | No | Whether a group member. |
| `└ ∟ description` | string | No | Description |
| `└ ∟ invite_code` | string | No | Invitation code. |
| `└ ∟ cert_scopes` | object | No | Certification scopes. |
| `└ ∟ ∟ official` | boolean | No | Whether an official list. |
| `└ ∟ ∟ cert_Info` | object | No | Certification info. |
| `└ ∟ ∟ ∟ label` | string | No | Label. |
| `└ ∟ ∟ ∟ name` | string | No | Security name. |
| `└ ∟ ∟ ∟ desc` | string | No | Description of current valuation |
| `└ ∟ ∟ ∟ icon` | string | No | Icon URL |
| `└ ∟ ∟ security_live_info` | string | No | Security live-stream info. |
| `└ ∟ certification` | boolean | No | Certification. |
| `└ stocks` | array | No | Constituent stocks |
| `└ subscribed` | boolean | No | Whether the current user is subscribed |
| `└ stock_group_id` | string | No | Stock-group ID. |
| `└ last_read_log_id` | string | No | Last-read change-log ID. |
| `└ chg` | string | No | Day change percentage |
| `└ group_id` | string | No | Group ID. |
| `└ sharelist_type` | integer | No | Type: `0`=regular, `3`=official, `4`=industry |
| `└ industry_code` | string | No | Industry code (for industry sharelists) |

### Response JSON Example

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "list": [
      {
        "id": 123,
        "name": "AI Picks",
        "description": "Top AI infrastructure stocks"
      },
      {
        "id": 456,
        "name": "EV Leaders",
        "description": "Electric vehicle sector leaders"
      }
    ]
  }
}
```
