v0.2.0-beta

OpenAPI 3.1.0

Tìm kiếm YouTube

Felo API Support

MIT

Máy chủ

https://openapi.felo.ai

Thư viện client

Shell Curl

YouTube Search

Search videos, channels and playlists.

YouTube Search Thao tác

get/v1/beta/youtube/search

Tìm kiếm YouTube

Tìm kiếm video, kênh và danh sách phát trên YouTube. engine=youtube và q là bắt buộc. Dùng gl và hl cho quốc gia và ngôn ngữ, hoặc sp cho phân trang và bộ lọc nâng cao.

Tham chiếu giá

Đo lường: Cơ sở chi phí cố định theo yêu cầu thành công.
Ước tính tham chiếu cho mỗi yêu cầu: USD 0.0029.
Hệ số khách hàng tham chiếu: 1.0. Không áp dụng lại cho số tiền khách hàng đã quyết toán.

Chỉ là siêu dữ liệu tham chiếu, không phải báo giá cho tài khoản, mức giá được bảo đảm hay hạn mức chi tiêu. Tín dụng tài nguyên không phải tín dụng Felo. Khoản phí cuối cùng tuân theo bản ghi thanh toán của Felo.

Tham số truy vấn

engine
enum
const:
youtube
bắt buộc

Mã định danh engine SearchApi. Dùng youtube cho endpoint YouTube này.
giá trị
- youtube
gl
Kiểu: string

Mã quốc gia (ví dụ us, jp)
hl
Kiểu: string

Ngôn ngữ giao diện
q
Kiểu: string
bắt buộc

Truy vấn tìm kiếm. Bắt buộc bởi runtime và SearchApi upstream.
sp
Kiểu: string

Token bộ lọc YouTube (phân trang hoặc bộ lọc nâng cao)

Phản hồi

200
Kiểu: object · ResponseFc5Af1Fcba22_SearchResponse

Phản hồi thành công
ads
Kiểu: array object[] · ResponseFc5Af1Fcba22_Ad[]

Kết quả quảng cáo

channel
Kiểu: object · ResponseFc5Af1Fcba22_AdChannel
id
Kiểu: string

ID kênh

link
Kiểu: string

Liên kết đến kênh

title
Kiểu: string

Tên kênh

description
Kiểu: string

Mô tả quảng cáo

id
Kiểu: string

ID video cho quảng cáo video

length
Kiểu: string

Thời lượng video cho quảng cáo video

link
Kiểu: string

Liên kết quảng cáo

position
Kiểu: integer

Vị trí trong kết quả tìm kiếm

thumbnail
Kiểu: string

URL hình thu nhỏ quảng cáo

title
Kiểu: string

Tiêu đề quảng cáo

website
Kiểu: string

URL trang web của nhà quảng cáo

channels
Kiểu: array object[] · ResponseFc5Af1Fcba22_Channel[]

Kết quả kênh YouTube

description
Kiểu: string

Mô tả kênh

id
Kiểu: string

ID kênh YouTube

is_verified
Kiểu: boolean

Kênh có được xác minh hay không

link
Kiểu: string

Liên kết đến kênh

position
Kiểu: integer

Vị trí trong kết quả tìm kiếm

subscribers
Kiểu: integer

Số người đăng ký

thumbnail
Kiểu: object · ResponseFc5Af1Fcba22_Thumbnail
rich
Kiểu: string

URL hình thu nhỏ động/phong phú

static
Kiểu: string

URL hình thu nhỏ tĩnh

title
Kiểu: string

Tên kênh

video_count
Kiểu: integer

Số video

error
Kiểu: string

Thông báo lỗi nếu tìm kiếm thất bại

featured_channel
Kiểu: object · ResponseFc5Af1Fcba22_FeaturedChannel
highlighted_video
Kiểu: object · ResponseFc5Af1Fcba22_HighlightedVideo
id
Kiểu: string

ID video

length
Kiểu: string

Thời lượng video

link
Kiểu: string

Liên kết đến video

subtitle
Kiểu: string

Phụ đề video

title
Kiểu: string

Tiêu đề video

id
Kiểu: string

ID kênh nổi bật

link
Kiểu: string

Liên kết đến kênh nổi bật

subtitle
Kiểu: string

Phụ đề kênh nổi bật

title
Kiểu: string

Tiêu đề kênh nổi bật

videos
Kiểu: array object[] · ResponseFc5Af1Fcba22_FeaturedVideo[]

Video của kênh nổi bật

channel
Kiểu: object · ResponseFc5Af1Fcba22_FeaturedVideoChannel
id
Kiểu: string

ID kênh

link
Kiểu: string

Liên kết đến kênh

title
Kiểu: string

Tên kênh

id
Kiểu: string

ID video

length
Kiểu: string

Thời lượng video

link
Kiểu: string

Liên kết đến video

subtitle
Kiểu: string

Phụ đề video

thumbnail
Kiểu: string

URL hình thu nhỏ video

title
Kiểu: string

Tiêu đề video

movies
Kiểu: array object[] · ResponseFc5Af1Fcba22_Movie[]

Kết quả phim

badges
Kiểu: array string[]

Huy hiệu phim

buttons
Kiểu: array string[]

Nút hành động

channel
Kiểu: object · ResponseFc5Af1Fcba22_MovieChannel
id
Kiểu: string

ID kênh

is_verified
Kiểu: boolean

Kênh có được xác minh hay không

link
Kiểu: string

Liên kết đến kênh

title
Kiểu: string

Tên kênh

description
Kiểu: string

Mô tả phim

id
Kiểu: string

ID video phim

length
Kiểu: string

Thời lượng phim

link
Kiểu: string

Liên kết đến phim

metadata_items
Kiểu: object · ResponseFc5Af1Fcba22_MetadataItems
bottom
Kiểu: array string[]

Các mục siêu dữ liệu dưới cùng

top
Kiểu: array string[]

Các mục siêu dữ liệu trên cùng

position
Kiểu: integer

Vị trí trong kết quả tìm kiếm

thumbnail
Kiểu: string

URL hình thu nhỏ phim

title
Kiểu: string

Tiêu đề phim

pagination
Kiểu: object · ResponseFc5Af1Fcba22_Pagination
next_page_token
Kiểu: string

Token để lấy trang kết quả tiếp theo

people_also_search_for
Kiểu: array object[] · ResponseFc5Af1Fcba22_PeopleAlsoSearchFor[]

Gợi ý tìm kiếm liên quan

link
Kiểu: string

Liên kết để thực hiện tìm kiếm

query
Kiểu: string

Truy vấn tìm kiếm được đề xuất

thumbnail
Kiểu: string

Hình thu nhỏ cho gợi ý

playlists
Kiểu: array object[] · ResponseFc5Af1Fcba22_Playlist[]

Kết quả danh sách phát

channel
Kiểu: object · ResponseFc5Af1Fcba22_PlaylistChannel
id
Kiểu: string

ID kênh

is_verified
Kiểu: boolean

Kênh có được xác minh hay không

link
Kiểu: string

Liên kết đến kênh

title
Kiểu: string

Tên kênh

id
Kiểu: string

ID danh sách phát

link
Kiểu: string

Liên kết đến danh sách phát

position
Kiểu: integer

Vị trí trong kết quả tìm kiếm

published_time
Kiểu: string

Thời gian kể từ khi xuất bản

thumbnail
Kiểu: string

URL hình thu nhỏ của danh sách phát

title
Kiểu: string

Tiêu đề danh sách phát

video_count
Kiểu: integer

Số video trong danh sách phát

videos
Kiểu: array object[] · ResponseFc5Af1Fcba22_PlaylistVideo[]

Video trong danh sách phát

id
Kiểu: string

ID video

length
Kiểu: string

Thời lượng video

link
Kiểu: string

Liên kết đến video

title
Kiểu: string

Tiêu đề video

posts
Kiểu: array object[] · ResponseFc5Af1Fcba22_Posts[]

Kết quả bài đăng cộng đồng

items
Kiểu: array object[] · ResponseFc5Af1Fcba22_Post[]

Bài đăng cộng đồng

channel
Kiểu: object · ResponseFc5Af1Fcba22_PostChannel
id
Kiểu: string

ID kênh

is_verified
Kiểu: boolean

Kênh có được xác minh hay không

link
Kiểu: string

Liên kết đến kênh

thumbnail
Kiểu: string

URL hình thu nhỏ của kênh

title
Kiểu: string

Tên kênh

comments
Kiểu: string

Số bình luận dạng văn bản

extracted_comments
Kiểu: integer

Số bình luận dạng số nguyên

extracted_likes
Kiểu: integer

Số lượt thích dạng số nguyên

id
Kiểu: string

ID bài đăng

likes
Kiểu: string

Số lượt thích dạng văn bản

link
Kiểu: string

Liên kết đến bài đăng

position
Kiểu: integer

Vị trí trong phần bài đăng

published_time
Kiểu: string

Thời gian kể từ khi xuất bản

text
Kiểu: string

Nội dung văn bản của bài đăng

thumbnail
Kiểu: string

URL hình thu nhỏ của bài đăng

position
Kiểu: integer

Vị trí trong kết quả tìm kiếm

section_title
Kiểu: string

Tiêu đề phần cho bài đăng

search_information
Kiểu: object · ResponseFc5Af1Fcba22_SearchInformation
corrected_query
Kiểu: string

Truy vấn đã sửa nếu áp dụng chỉnh lỗi chính tả

original_query
Kiểu: string

Truy vấn gốc trước khi sửa

original_query_sp
Kiểu: string

Tham số SP cho truy vấn gốc

state
Kiểu: string

Trạng thái sửa truy vấn nếu có

total_results
Kiểu: integer

Tổng số kết quả tìm thấy

search_metadata
Kiểu: object · ResponseFc5Af1Fcba22_SearchMetadata
created_at
Kiểu: string Định dạng: date-time
bắt buộc

Dấu thời gian khi tìm kiếm được tạo

id
Kiểu: string
bắt buộc

Mã định danh duy nhất cho yêu cầu tìm kiếm

status
Kiểu: string
bắt buộc

Trạng thái của yêu cầu tìm kiếm

html_url
Kiểu: string

URL để xem kết quả HTML

json_url
Kiểu: string

URL để xem kết quả JSON

parsing_time_taken
Kiểu: number

Thời gian phân tích kết quả tính bằng giây

request_time_taken
Kiểu: number

Thời gian thực hiện yêu cầu tính bằng giây

request_url
Kiểu: string

URL YouTube cho tìm kiếm này

total_time_taken
Kiểu: number

Tổng thời gian thực hiện tìm kiếm tính bằng giây

search_parameters
Kiểu: object · ResponseFc5Af1Fcba22_SearchParameters
engine
Kiểu: string

Công cụ tìm kiếm đã sử dụng

gl
Kiểu: string

Mã quốc gia đã sử dụng

hl
Kiểu: string

Ngôn ngữ giao diện đã sử dụng

q
Kiểu: string

Truy vấn tìm kiếm đã sử dụng

sp
Kiểu: string

Tham số lọc/phân trang đã sử dụng

sections
Kiểu: array object[] · ResponseFc5Af1Fcba22_Section[]

Kết quả theo phần

items
Kiểu: array object[] · ResponseFc5Af1Fcba22_SectionItem[]

Các mục trong phần

channel
Kiểu: object · ResponseFc5Af1Fcba22_SectionChannel
id
Kiểu: string

ID kênh

link
Kiểu: string

Liên kết đến kênh

title
Kiểu: string

Tên kênh

id
Kiểu: string

ID mục

length
Kiểu: string

Thời lượng mục

link
Kiểu: string

Liên kết đến mục

published_time
Kiểu: string

Thời gian kể từ khi xuất bản

thumbnail
Kiểu: string

URL hình thu nhỏ của mục

title
Kiểu: string

Tiêu đề mục

views
Kiểu: integer

Số lượt xem

position
Kiểu: integer

Vị trí trong kết quả tìm kiếm

section_title
Kiểu: string

Tiêu đề phần

shorts
Kiểu: array object[] · ResponseFc5Af1Fcba22_Shorts[]

Kết quả YouTube Shorts

items
Kiểu: array object[] · ResponseFc5Af1Fcba22_Short[]

Video ngắn

duration
Kiểu: string

Thời lượng video ngắn

id
Kiểu: string

ID video ngắn

link
Kiểu: string

Liên kết đến video ngắn

position
Kiểu: integer

Vị trí trong phần video ngắn

thumbnail
Kiểu: string

URL hình thu nhỏ của video ngắn

title
Kiểu: string

Tiêu đề video ngắn

views
Kiểu: integer

Số lượt xem

position
Kiểu: integer

Vị trí trong kết quả tìm kiếm

section_title
Kiểu: string

Tiêu đề phần cho video ngắn

suggestions
Kiểu: array string[]

Gợi ý truy vấn tìm kiếm

videos
Kiểu: array object[] · ResponseFc5Af1Fcba22_Video[]

Kết quả tìm kiếm video

badges
Kiểu: array string[]

Huy hiệu video

channel
Kiểu: object · ResponseFc5Af1Fcba22_VideoChannel
id
Kiểu: string

ID kênh

is_verified
Kiểu: boolean

Kênh có được xác minh hay không

link
Kiểu: string

Liên kết đến kênh

thumbnail
Kiểu: string

URL hình thu nhỏ của kênh

title
Kiểu: string

Tên kênh

description
Kiểu: string

Đoạn trích mô tả video

id
Kiểu: string

ID video YouTube

is_live
Kiểu: boolean

Video có đang phát trực tiếp hay không

key_moments
Kiểu: array object[] · ResponseFc5Af1Fcba22_KeyMoment[]

Các khoảnh khắc chính trong video

start_seconds
Kiểu: integer

Thời điểm bắt đầu của khoảnh khắc tính bằng giây

thumbnail
Kiểu: string

URL hình thu nhỏ của khoảnh khắc chính

title
Kiểu: string

Tiêu đề khoảnh khắc chính

length
Kiểu: string

Thời lượng video

link
Kiểu: string

Liên kết đến video

position
Kiểu: integer

Vị trí trong kết quả tìm kiếm

published_time
Kiểu: string

Thời gian kể từ khi xuất bản

thumbnail
Kiểu: object · ResponseFc5Af1Fcba22_Thumbnail
rich
Kiểu: string

URL hình thu nhỏ động/phong phú

static
Kiểu: string

URL hình thu nhỏ tĩnh

title
Kiểu: string

Tiêu đề video

views
Kiểu: integer

Số lượt xem
application/json
400

Không thể xử lý yêu cầu. Hãy kiểm tra các tham số yêu cầu.
401

Cần có khóa API Felo hợp lệ.
402

Không thể tiếp tục yêu cầu vì chưa đáp ứng yêu cầu thanh toán.
403

Tài khoản không được phép thực hiện thao tác này.
429

Đã đạt giới hạn yêu cầu hoặc giới hạn chi tiêu.
502

Dịch vụ không thể hoàn tất yêu cầu.
503

API hoặc dịch vụ thanh toán tạm thời không khả dụng.
504

Dịch vụ đã hết thời gian chờ khi xử lý yêu cầu.
default

Phản hồi lỗi; phản hồi chuyển tiếp từ thượng nguồn có thể dùng định dạng của nhà cung cấp

application/json

get/v1/beta/youtube/search

curl 'https://openapi.felo.ai/v1/beta/youtube/search?engine=youtube&q=' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Hiện schema

{
  "search_metadata": {
    "id": "string",
    "status": "string",
    "created_at": "2026-10-26T08:08:16.607Z",
    "request_time_taken": 1,
    "parsing_time_taken": 1,
    "total_time_taken": 1,
    "request_url": "string",
    "html_url": "string",
    "json_url": "string"
  },
  "search_parameters": {
    "engine": "string",
    "q": "string",
    "sp": "string",
    "hl": "string",
    "gl": "string"
  },
  "search_information": {
    "total_results": 1,
    "state": "string",
    "original_query": "string",
    "original_query_sp": "string",
    "corrected_query": "string"
  },
  "suggestions": [
    "string"
  ],
  "ads": [
    {
      "position": 1,
      "id": "string",
      "title": "string",
      "link": "string",
      "description": "string",
      "website": "string",
      "channel": {
        "id": "string",
        "title": "string",
        "link": "string"
      },
      "length": "string",
      "thumbnail": "string"
    }
  ],
  "channels": [
    {
      "position": 1,
      "id": "string",
      "title": "string",
      "link": "string",
      "description": "string",
      "is_verified": true,
      "video_count": 1,
      "subscribers": 1,
      "thumbnail": {
        "static": "string",
        "rich": "string"
      }
    }
  ],
  "movies": [
    {
      "position": 1,
      "id": "string",
      "title": "string",
      "link": "string",
      "description": "string",
      "channel": {
        "id": "string",
        "title": "string",
        "link": "string",
        "is_verified": true
      },
      "length": "string",
      "metadata_items": {
        "top": [
          "string"
        ],
        "bottom": [
          "string"
        ]
      },
      "badges": [
        "string"
      ],
      "buttons": [
        "string"
      ],
      "thumbnail": "string"
    }
  ],
  "videos": [
    {
      "position": 1,
      "id": "string",
      "title": "string",
      "link": "string",
      "description": "string",
      "views": 1,
      "is_live": true,
      "channel": {
        "id": "string",
        "title": "string",
        "link": "string",
        "is_verified": true,
        "thumbnail": "string"
      },
      "length": "string",
      "published_time": "string",
      "badges": [
        "string"
      ],
      "thumbnail": {
        "static": "string",
        "rich": "string"
      },
      "key_moments": [
        {
          "title": "string",
          "start_seconds": 1,
          "thumbnail": "string"
        }
      ]
    }
  ],
  "playlists": [
    {
      "position": 1,
      "id": "string",
      "title": "string",
      "link": "string",
      "video_count": 1,
      "channel": {
        "id": "string",
        "title": "string",
        "is_verified": true,
        "link": "string"
      },
      "published_time": "string",
      "videos": [
        {
          "id": "string",
          "title": "string",
          "link": "string",
          "length": "string"
        }
      ],
      "thumbnail": "string"
    }
  ],
  "sections": [
    {
      "section_title": "string",
      "position": 1,
      "items": [
        {
          "id": "string",
          "title": "string",
          "link": "string",
          "channel": {
            "id": "string",
            "title": "string",
            "link": "string"
          },
          "views": 1,
          "published_time": "string",
          "length": "string",
          "thumbnail": "string"
        }
      ]
    }
  ],
  "shorts": [
    {
      "section_title": "string",
      "position": 1,
      "items": [
        {
          "position": 1,
          "id": "string",
          "title": "string",
          "link": "string",
          "duration": "string",
          "views": 1,
          "thumbnail": "string"
        }
      ]
    }
  ],
  "posts": [
    {
      "section_title": "string",
      "position": 1,
      "items": [
        {
          "position": 1,
          "id": "string",
          "link": "string",
          "text": "string",
          "likes": "string",
          "extracted_likes": 1,
          "comments": "string",
          "extracted_comments": 1,
          "channel": {
            "id": "string",
            "title": "string",
            "link": "string",
            "is_verified": true,
            "thumbnail": "string"
          },
          "published_time": "string",
          "thumbnail": "string"
        }
      ]
    }
  ],
  "people_also_search_for": [
    {
      "query": "string",
      "link": "string",
      "thumbnail": "string"
    }
  ],
  "featured_channel": {
    "id": "string",
    "title": "string",
    "subtitle": "string",
    "link": "string",
    "highlighted_video": {
      "id": "string",
      "title": "string",
      "subtitle": "string",
      "link": "string",
      "length": "string"
    },
    "videos": [
      {
        "id": "string",
        "title": "string",
        "subtitle": "string",
        "link": "string",
        "length": "string",
        "channel": {
          "id": "string",
          "title": "string",
          "link": "string"
        },
        "thumbnail": "string"
      }
    ]
  },
  "pagination": {
    "next_page_token": "string"
  },
  "error": "string"
}

Phản hồi thành công

Tìm kiếm YouTube

Xác thựcRequired

YouTube Search

Tìm kiếm YouTube

Tham chiếu giá