> ## 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.

# General search (raw data, recommend V2)

> General search (raw data, recommend V2)

General search (raw data, recommend V2)

**Pricing** — base \$0.00145 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 "https://api.aisa.one/apis/v1/tikhub/youtube/web_v2/get_general_search?search_query=Python" \
  -H "Authorization: Bearer YOUR_API_KEY"
```


## OpenAPI

````yaml openapi/tikhub-en.json GET /tikhub/youtube/web_v2/get_general_search
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/youtube/web_v2/get_general_search:
    get:
      tags:
        - TikHub - Youtube
      summary: General search (raw data, recommend V2)
      description: General search (raw data, recommend V2)
      operationId: get_tikhub_youtube_web_v2_get_general_search
      parameters:
        - name: search_query
          in: query
          required: true
          schema:
            type: string
            maxLength: 200
            description: Search keyword
            title: Search Query
          description: Search keyword
          example: Python
        - name: language_code
          in: query
          required: false
          schema:
            type: string
            description: Language code
            default: zh-CN
            title: Language Code
          description: Language code
        - name: country_code
          in: query
          required: false
          schema:
            type: string
            title: Country Code
            description: Country code
            default: US
          description: Country code
        - name: time_zone
          in: query
          required: false
          schema:
            type: string
            description: Time zone
            default: America/Los_Angeles
            title: Time Zone
          description: Time zone
        - name: upload_time
          in: query
          required: false
          schema:
            $ref: '#/components/schemas/YouTubeUploadTimeAPI'
            description: Upload time filter
            examples:
              hour:
                summary: '1'
                value: hour
              today:
                summary: See API documentation
                value: today
              week:
                summary: See API documentation
                value: week
              month:
                summary: See API documentation
                value: month
              year:
                summary: See API documentation
                value: year
            title: Upload Time
            nullable: true
          description: Upload time filter
        - name: duration
          in: query
          required: false
          schema:
            $ref: '#/components/schemas/YouTubeDurationAPI'
            description: Duration filter
            examples:
              short:
                summary: <4
                value: short
              medium:
                summary: 4-20
                value: medium
              long:
                summary: '>20'
                value: long
            title: Duration
            nullable: true
          description: Duration filter
        - name: content_type
          in: query
          required: false
          schema:
            $ref: '#/components/schemas/YouTubeContentTypeAPI'
            description: Content type filter
            examples:
              video:
                summary: See API documentation
                value: video
              channel:
                summary: See API documentation
                value: channel
              playlist:
                summary: See API documentation
                value: playlist
              movie:
                summary: See API documentation
                value: movie
            title: Content Type
            nullable: true
          description: Content type filter
        - name: feature
          in: query
          required: false
          schema:
            $ref: '#/components/schemas/YouTubeFeatureAPI'
            description: Feature filter
            examples:
              '360':
                summary: '360'
                value: '360'
              hd:
                summary: See API documentation
                value: hd
              4k:
                summary: 4K
                value: 4k
              subtitles:
                summary: See API documentation
                value: subtitles
              live:
                summary: See API documentation
                value: live
              creative_commons:
                summary: See API documentation
                value: creative_commons
              vr180:
                summary: VR180
                value: vr180
              3d:
                summary: 3D
                value: 3d
              hdr:
                summary: HDR
                value: hdr
              location:
                summary: See API documentation
                value: location
              purchased:
                summary: See API documentation
                value: purchased
            title: Feature
            nullable: true
          description: Feature filter
        - name: sort_by
          in: query
          required: false
          schema:
            $ref: '#/components/schemas/YouTubeSearchSortAPI'
            description: Sort by
            examples:
              relevance:
                summary: See API documentation
                value: relevance
              upload_date:
                summary: See API documentation
                value: upload_date
              view_count:
                summary: See API documentation
                value: view_count
              rating:
                summary: See API documentation
                value: rating
            title: Sort By
            nullable: true
          description: Sort by
        - name: continuation_token
          in: query
          required: false
          schema:
            description: Pagination token
            title: Continuation Token
            nullable: true
            type: string
          description: Pagination token
      responses:
        '200':
          description: >-
            Successful response. Response structure varies; refer to the actual
            API response.
components:
  schemas:
    YouTubeUploadTimeAPI:
      type: string
      enum:
        - hour
        - today
        - week
        - month
        - year
      title: YouTubeUploadTimeAPI
      description: YouTube - API
    YouTubeDurationAPI:
      type: string
      enum:
        - short
        - medium
        - long
      title: YouTubeDurationAPI
      description: YouTube - API
    YouTubeContentTypeAPI:
      type: string
      enum:
        - video
        - channel
        - playlist
        - movie
      title: YouTubeContentTypeAPI
      description: YouTube - API
    YouTubeFeatureAPI:
      type: string
      enum:
        - live
        - 4k
        - hd
        - subtitles
        - creative_commons
        - '360'
        - vr180
        - 3d
        - hdr
        - location
        - purchased
      title: YouTubeFeatureAPI
      description: YouTube - API
    YouTubeSearchSortAPI:
      type: string
      enum:
        - relevance
        - upload_date
        - view_count
        - rating
      title: YouTubeSearchSortAPI
      description: YouTube - API
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: AIsa API key. Get yours at https://aisa.one

````