> ## 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 content square leaderboards

> PGY content square leaderboards

PGY content square leaderboards

**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_content_square" \
  -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_content_square
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_content_square:
    post:
      tags:
        - TikHub - Xiaohongshu
      summary: PGY content square leaderboards
      description: PGY content square leaderboards
      operationId: post_tikhub_xiaohongshu_pgy_get_content_square
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ContentSquareReq'
        required: true
      responses:
        '200':
          description: >-
            Successful response. Response structure varies; refer to the actual
            API response.
components:
  schemas:
    ContentSquareReq:
      properties:
        biz_type:
          type: integer
          enum:
            - 1
            - 2
            - 3
            - 4
            - 5
            - 6
            - 7
            - 8
          title: Biz Type
          description: >-
            Leaderboard: 1=Xiaohongshu Popular, 2=Product Seeding, 3=E-commerce
            Promotion, 4=Dandelion Collaboration, 5=Lead Collection,
            6=E-commerce Hot, 7=Direct Seeding, 8=App Promotion
          example: 1
        page_num:
          type: integer
          maximum: 100
          minimum: 1
          title: Page Num
          description: Page; each board has only 100 items
          default: 1
          example: 1
        page_size:
          type: integer
          maximum: 34
          minimum: 1
          title: Page Size
          description: Page size, 1-34 (web fixed at 34)
          default: 34
          example: 34
        search_word:
          type: string
          maxLength: 100
          title: Search Word
          description: >-
            Keyword; leave empty to view the full chart; supports
            comma-separated batch search
          default: ''
          example: Face Mask
        order_by:
          type: string
          maxLength: 64
          title: Order By
          description: Sort field, empty=board default
          default: ''
          example: premium_imp_num
        date_range:
          type: integer
          enum:
            - 3
            - 7
            - 14
            - 30
          title: Date Range
          description: Date window in days
          default: 7
          example: 7
        sub_biz_type:
          title: Sub Biz Type
          description: >-
            Board 8 only: 1=app download, 2=mini-program promotion, 3=app
            re-engagement (default)
          example: 3
          nullable: true
          type: integer
          enum:
            - 1
            - 2
            - 3
        category:
          title: Category
          description: >-
            Category (board 1 only), format: "level1#level2", e.g. "Content
            Category#Beauty"
          example: 'Content category: Beauty'
          nullable: true
          type: string
          maxLength: 64
        industry:
          title: Industry
          description: Industry name (boards 2/3/4/5/6/7/8); valid values differ per board
          example: Parenting & Baby
          nullable: true
          type: string
          maxLength: 64
        note_type:
          title: Note Type
          description: 'Content type: 1=Image+text, 2=Video'
          example: 2
          nullable: true
          type: integer
          enum:
            - 1
            - 2
        content_type:
          title: Content Type
          description: >-
            Content source: 1=Blogger partnership, 2=Celebrity partnership,
            3=Employee, 5=Buyer, 6=Professional account, 11=Director, -1=User
          example: 1
          nullable: true
          type: integer
          enum:
            - 1
            - 2
            - 3
            - 5
            - 6
            - 11
            - -1
        theme:
          title: Theme
          description: Theme name (boards 2/4/5/7/8)
          example: Unboxing
          nullable: true
          type: string
          maxLength: 64
        author_type:
          title: Author Type
          description: 'Board 4 only: 1=Dandelion creator, 2=celebrity'
          example: 1
          nullable: true
          type: integer
          enum:
            - 1
            - 2
        placement:
          title: Placement
          description: >-
            Traffic placement (boards 2/3/5/7/8): 1=Discover feed, 2=Search,
            3=In-video traffic
          example: 1
          nullable: true
          type: integer
          enum:
            - 1
            - 2
            - 3
        marketing_target:
          title: Marketing Target
          description: 'Board 3 only: 3=product promotion, 8=live stream promotion'
          example: 3
          nullable: true
          type: integer
          enum:
            - 3
            - 8
        price:
          $ref: '#/components/schemas/PriceFilter'
          description: Creator price (board 4 only)
          nullable: true
        fans:
          $ref: >-
            #/components/schemas/crawlers__xiaohongshu__pgy__pgy_content_filters__RangeFilter
          description: Creator follower count range (board 4 only)
          nullable: true
      additionalProperties: false
      type: object
      required:
        - biz_type
      title: ContentSquareReq
    PriceFilter:
      properties:
        kind:
          type: integer
          enum:
            - 1
            - 2
          title: Kind
          description: 'Quote type: 1=image-text note, 2=video note'
        range:
          $ref: >-
            #/components/schemas/crawlers__xiaohongshu__pgy__pgy_content_filters__RangeFilter
          description: Quote range (CNY)
      additionalProperties: false
      type: object
      required:
        - kind
        - range
      title: PriceFilter
      description: >-
        Web page "Creator Pricing": image-text and video are two independent
        channels; one must be selected first.
    crawlers__xiaohongshu__pgy__pgy_content_filters__RangeFilter:
      properties:
        min:
          title: Min
          description: Minimum value (inclusive)
          nullable: true
          type: integer
          maximum: 9999999
          minimum: 0
        max:
          title: Max
          description: Maximum value (inclusive); omit for no upper limit
          nullable: true
          type: integer
          maximum: 9999999
          minimum: 0
      additionalProperties: false
      type: object
      title: RangeFilter
      description: >-
        Numeric range. 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

````