> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# PGY live blogger square

> PGY live blogger square

PGY live blogger square

**Pricing** — base \$0.029 per successful call (provider cost × 1.45; final charge scales by your plan multiplier). Charged only when the upstream response body `code` is `200`.

<Note>
  Response structure is not yet fully documented — **refer to the actual API response**.
</Note>

## Example

```bash theme={null}
curl -X POST "https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_live_blogger_list" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'  # see request schema below
```


## OpenAPI

````yaml openapi/tikhub-en.json POST /tikhub/xiaohongshu/pgy/get_live_blogger_list
openapi: 3.0.0
info:
  title: TikHub API
  description: >-
    Multi-platform social media data via TikHub — Douyin, TikTok, Bilibili,
    Kuaishou, Weibo, Xiaohongshu, Zhihu, and commercial
    (Xingtu/Huahuo/Billboard) endpoints.
  version: 1.0.0
servers:
  - url: https://api.aisa.one/apis/v1
security:
  - bearerAuth: []
paths:
  /tikhub/xiaohongshu/pgy/get_live_blogger_list:
    post:
      tags:
        - TikHub - Xiaohongshu
      summary: PGY live blogger square
      description: PGY live blogger square
      operationId: post_tikhub_xiaohongshu_pgy_get_live_blogger_list
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LiveBloggerReq'
        required: true
      responses:
        '200':
          description: >-
            Successful response. Response structure varies; refer to the actual
            API response.
components:
  schemas:
    LiveBloggerReq:
      properties:
        page_num:
          type: integer
          maximum: 250
          minimum: 1
          title: Page Num
          description: Page, 1-250
          default: 1
          example: 1
        page_size:
          type: integer
          maximum: 20
          minimum: 1
          title: Page Size
          description: Page size, 1-20 (web fixed at 20)
          default: 20
          example: 20
        seed:
          type: integer
          minimum: 0
          title: Seed
          description: Paging seed, echo back from previous page
          default: 0
          example: 0
        nick_name:
          type: string
          maxLength: 50
          title: Nick Name
          description: Search by nickname
          default: ''
          example: Li
        category:
          $ref: '#/components/schemas/CategoryFilter'
          description: Cooperation category filters
          nullable: true
        buyer:
          $ref: '#/components/schemas/BuyerFilter'
          description: Buyer group & persona filters
          nullable: true
        ecom:
          $ref: '#/components/schemas/EcomFilter'
          description: E-commerce conversion filters
          nullable: true
        live:
          $ref: '#/components/schemas/LiveFilter'
          description: Live activity & performance filters
          nullable: true
        fans:
          $ref: >-
            #/components/schemas/crawlers__xiaohongshu__pgy__pgy_live_filters__FansFilter
          description: Fans purchasing power filters
          nullable: true
        flags:
          $ref: '#/components/schemas/FlagFilter'
          description: Platform recommendation flags
          nullable: true
      additionalProperties: false
      type: object
      title: LiveBloggerReq
    CategoryFilter:
      properties:
        first:
          title: First
          description: >-
            Primary cooperation category, e.g. Women's Apparel / Women's
            Premium. Refer to the "Cooperation Category" on the Pugongying "Live
            Blogger Plaza" page. Passing only the primary level is sufficient.
          nullable: true
          items:
            type: string
            maxLength: 64
          type: array
          maxItems: 30
        second:
          title: Second
          description: >-
            Secondary cooperation category, e.g. Dress. May be left empty;
            filtering by primary level alone is also effective.
          nullable: true
          items:
            type: string
            maxLength: 64
          type: array
          maxItems: 200
      additionalProperties: false
      type: object
      title: CategoryFilter
      description: >-
        Web page "Cooperation Category" section (primary + secondary; secondary
        must match the selected primary).
    BuyerFilter:
      properties:
        group_tag:
          title: Group Tag
          description: >-
            Buyer group tag, e.g. Elegant Minimalist (leaf tags under style
            groups: Fashion Style / Body Type / Beauty & Skincare / Sports
            Enthusiast). Refer to the "Buyer Group" dropdown on the page for
            valid values.
          nullable: true
          items:
            type: string
            maxLength: 64
          type: array
          maxItems: 30
        persona_tag:
          title: Persona Tag
          description: >-
            Content persona tags, e.g. Model (leaf nodes from groups:
            Professional Identity / Family Role / Distinctive Background / Style
            / Lifestyle / Skin Type / Skincare / Body Type). Refer to the
            "Content Persona" dropdown on the page.
          nullable: true
          items:
            type: string
            maxLength: 64
          type: array
          maxItems: 30
      additionalProperties: false
      type: object
      title: BuyerFilter
      description: Web page "Top Buyer Squad" + "Content Persona" section.
    EcomFilter:
      properties:
        avg_gmv:
          $ref: >-
            #/components/schemas/crawlers__xiaohongshu__pgy__pgy_live_filters__RangeFilter
          description: Average sales per session (CNY)
          nullable: true
        brand_avg_gmv:
          $ref: >-
            #/components/schemas/crawlers__xiaohongshu__pgy__pgy_live_filters__RangeFilter
          description: Average sales per session for partnered brands (CNY)
          nullable: true
        atv:
          $ref: >-
            #/components/schemas/crawlers__xiaohongshu__pgy__pgy_live_filters__RangeFilter
          description: >-
            Average order value (CNY). Matched by tier (0-100 / 100-200 /
            200-500 ...). Any tier overlapping with the specified range will be
            included — e.g. passing 100-300 will also return buyers in the
            200-500 tier.
          nullable: true
      additionalProperties: false
      type: object
      title: EcomFilter
      description: Web page "E-commerce Conversion Power" section.
    LiveFilter:
      properties:
        has_plan:
          title: Has Plan
          description: Has live-stream plan
          nullable: true
          type: boolean
        plan_days:
          title: Plan Days
          description: >-
            Planned live stream date in YYYYMMDD; used with has_plan; leave
            empty for all dates
          nullable: true
          items:
            type: string
            pattern: ^\d{8}$
          type: array
          maxItems: 60
        avg_viewer:
          $ref: >-
            #/components/schemas/crawlers__xiaohongshu__pgy__pgy_live_filters__RangeFilter
          description: Average viewers per session
          nullable: true
        max_online:
          $ref: >-
            #/components/schemas/crawlers__xiaohongshu__pgy__pgy_live_filters__RangeFilter
          description: Peak concurrent viewers
          nullable: true
      additionalProperties: false
      type: object
      title: LiveFilter
      description: Web page "Live Stream Engagement" + "Live Stream Performance" section.
    crawlers__xiaohongshu__pgy__pgy_live_filters__FansFilter:
      properties:
        count:
          $ref: >-
            #/components/schemas/crawlers__xiaohongshu__pgy__pgy_live_filters__RangeFilter
          description: Follower count
          nullable: true
        age:
          title: Age
          description: >-
            Audience age (dominant group): 0=No limit, 1=Under 18, 2=18-24,
            3=25-34, 4=35-44, 5=Over 44
          nullable: true
          type: integer
          enum:
            - 0
            - 1
            - 2
            - 3
            - 4
            - 5
        gender:
          title: Gender
          description: >-
            Audience gender: 0=No limit, 1=Predominantly male, 2=Predominantly
            female
          nullable: true
          type: integer
          enum:
            - 0
            - 1
            - 2
        consumption:
          title: Consumption
          description: 'Audience purchasing power: high / middle / low'
          nullable: true
          items:
            type: string
            enum:
              - high
              - middle
              - low
          type: array
          maxItems: 3
      additionalProperties: false
      type: object
      title: FansFilter
      description: 'Audience purchasing power: follower count, age, gender, spending power.'
    FlagFilter:
      properties:
        actively_seeking:
          title: Actively Seeking
          description: Actively seeking collaborations
          nullable: true
          type: boolean
        high_reply_rate:
          title: High Reply Rate
          description: High invitation response rate
          nullable: true
          type: boolean
        contact_visible:
          title: Contact Visible
          description: Contact information viewable
          nullable: true
          type: boolean
        cooperated_before:
          title: Cooperated Before
          description: Has worked on commercial orders
          nullable: true
          type: boolean
        following:
          title: Following
          description: You follow them
          nullable: true
          type: boolean
        follower:
          title: Follower
          description: They follow you
          nullable: true
          type: boolean
        live_potential_high:
          title: Live Potential High
          description: High live streaming potential
          nullable: true
          type: boolean
        daily_buyer:
          title: Daily Buyer
          description: Daily live-stream buyer
          nullable: true
          type: boolean
        is_star:
          title: Is Star
          description: Celebrity
          nullable: true
          type: boolean
      additionalProperties: false
      type: object
      title: FlagFilter
      description: >-
        Web page "Platform Recommendations -> Featured Bloggers" section (all
        checkboxes).
    crawlers__xiaohongshu__pgy__pgy_live_filters__RangeFilter:
      properties:
        min:
          title: Min
          description: Minimum value (inclusive)
          nullable: true
          type: number
          maximum: 1000000000000
          minimum: 0
        max:
          title: Max
          description: Maximum value (inclusive); omit for no upper limit
          nullable: true
          type: number
          maximum: 1000000000000
          minimum: 0
      additionalProperties: false
      type: object
      title: RangeFilter
      description: >-
        Numeric range corresponding to the web filter tier or custom input box.
        Either bound may be omitted; at least one must be provided.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: AIsa API key. Get yours at https://aisa.one

````