# 趋势搜索词榜单 - 实时接口 ## OpenAPI Specification ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /api/v3/realtime/trending/keyword/ranking: get: summary: 趋势搜索词榜单 - 实时接口 deprecated: false description: >- **接口整体描述** 这是实时搜索关键词榜单接口，按 `tab` 和 `region` 拉榜单，重点反映的是用户正在搜索什么，而不是推荐流里在放什么。返回呈现的是搜索热词榜单本身，重点在“用户最近在搜什么”，适合拿来判断需求和兴趣入口，而不是内容消费结果。 **接口用途推荐** - 适合做搜索趋势监控 - 选题词库建设 - 命名和 SEO 方向判断、看用户当前主动搜索的热点词 **注意事项** - 榜单和趋势类返回波动很快，更适合连续轮询或定时快照，不建议把单次结果视为长期稳定结论 - 实时接口可能遇到风控，如果接口返回code=500，请继续重试（code=500不消耗当前调用额度） tags: - 数据洞察 parameters: - name: tab in: query description: 筛选分类，可选值：all, Fashion, Food, Sports, Tourism, Gaming, Science required: true example: all schema: type: string - name: region in: query description: '' required: true example: US schema: type: string - name: offset in: query description: 若返回结果中参数 has_more 的值为 1，则同时会携带游标值，用于获取下一组数据 required: false example: 0 schema: type: integer - name: count in: query description: '' required: false example: 10 schema: type: integer responses: '200': description: '' content: application/json: schema: type: object properties: {} example: code: 0 message: ok data: banners: conversion_bar_list: - item_link: >- https://activity.tiktokw.us/magic/eco/runtime/release/66581e19df4daf02866b5cc9?appType=muse&magic_page_no=1&lang=en®ion=Default&use_spark=1 item_text: Learn more event_banners: ecommerce_education: eligible: image_url: >- https://sf16-muse-va.ibytedtos.com/obj/search-static-maliva/maliva/6cjd5rh91716193010532 link: >- https://activity.tiktokw.us/magic/eco/runtime/release/664c4298f65e08d77319049b?appType=muse&magic_page_no=1&lang=en-US®ion=US&use_spark=1 text: >- Promote products people want to buy. Start earning now! enrolled: image_url: >- https://sf16-muse-va.ibytedtos.com/obj/search-static-maliva/maliva/b0fmjabl1716192964040 link: >- https://activity.tiktokw.us/magic/eco/runtime/release/6645db2e6f3a610291d0b0ac?appType=muse&magic_page_no=1&lang=en-US®ion=US&use_spark=1 text: >- Create shoppable videos with products people want to buy! non_eligible: image_url: >- https://sf16-muse-va.ibytedtos.com/obj/search-static-maliva/maliva/hdskk6yq1716193026366 link: >- https://activity.tiktokw.us/magic/eco/runtime/release/664c4c03f33586028244e7fb?appType=muse&magic_page_no=1&lang=en-US®ion=US&use_spark=1 text: Explore opportunities to earn with shopping insights home_page_banner: >- https://sf16-muse-va.ibytedtos.com/obj/search-static-maliva/maliva/q8hl7ump1713411026852 image_url: >- https://sf16-muse-va.ibytedtos.com/obj/search-static-maliva/maliva/r8z2ni6s1708410808360 image_url_dark: >- https://sf16-muse-va.ibytedtos.com/obj/search-static-maliva/maliva/a1av24511708410895413 loading_page_banner: >- https://p16-search-fe-static.tiktokcdn-us.com/tos-alisg-i-baf7wf9fmw-sg/e06d4221d05a4859be4def9f58c37540~tplv-baf7wf9fmw-image.image cost_tracker: es_cost: 74 fetch_cache_cost: 1 model_cost: 80 post_process_cost: 13 recall_cost: 64 total_cost: 172 cursor: 1 extra: latency: 172 logid: 20260709095948AA5ED2DACD338E021BF2 now: 1783591188597 vgeo: VGeo-US has_more: true inspiration_list: - business_types: - knowledge_campaign - knowledge_campaign cover_image: '' debug_info: creator_category: - reason: byFollowerCnt type: new_creator - type: csi_new_user creator_lang: infer_languages: - en use_mul_lang: false experiment: csi_add_token_id_recall: add_token_id_recall_v1 csi_csi_dynamic_tab: csi_dynamic_tab_v4 csi_csi_exp_base_trending: csi_exp_base_trending csi_csi_exp_group_ai_canvas: csi_exp_group_ai_canvas csi_csi_exp_group_multitasks_optimization_1: csi_iter12c2_dcn64_drop02_r1424319_0-v1 csi_csi_exp_group_name_3: involve_photomode_topic csi_csi_exp_group_token_rerank: token_id_demote_boost_0.8 csi_csi_useful_exp_gen: csi_useful_exp_gen_v1 csi_csi_v1_video_quality_multitask_dcn_compress128_v99864_c918020_r1415463_0: >- csi_v1_video_quality_multitask_dcn_compress128_v99864_c918020_r1415463_0_v1 csi_csi_v39_r1416848_0: csi_v39_r1416848_0_v4 csi_csi_video_agg_score: csi_video_agg_score_v1 csi_useful_exp_video: useful_exp_video_v1 language: en recall_scores: - 0 recall_source: - FromEsTrending rough_score: 0 score: 0.003297393675893545 target_score: all_boost: 1 before_boost: 0.003297393675893545 multitasks_click_score: 0.050494253635406494 multitasks_collection_score: 0.006874978542327881 multitasks_info_collection_score: 0.017928212881088257 multitasks_info_shoot_score: 0.16852256655693054 multitasks_shoot_score: 0.0066616833209991455 multitasks_strict_publish_score: 0.005584627389907837 rank_relevance_score: 0.017495840787887573 recall_relevance_score: 0.49265429377555847 video_quality_publish_score: 0.004371076822280884 video_quality_strict_search_vv_score: 0.17344708740711212 dislike_option_enabled: false entity_id: 0 favorited_updated_at: 0 inspiration_types: - search is_favorited: false order_popularity_seq: [] popularity: 100 popularity_updated_at: 1783589424 popularity_v2: 62483047 query_id: 7625132574976885000 query_id_str: '7625132574976884756' query_labels: [] query_text: Video Editing Tips for Beginners rewrite_version: '' show_ai_canvas_entry: false sug_id_str: '0' textnet: layer1: Science and Technology layer2: Software layer3: '' layer4: '' trending_seq: - 96 - 98 - 96 - 97 - 96 - 97 - 99 trending_seq_v2: - 64360859 - 63815713 - 64954000 - 63623833 - 62052390 - 63541841 - 62483047 use_csi_api_for_related_videos: false user_avatars: [] video_num: 0 status_code: 0 status_msg: '' requestId: 38042626-65a1-456a-af96-3be09500a373 headers: {} x-apifox-name: 成功 security: - basic: [] x-apifox-folder: 数据洞察 x-apifox-status: released x-run-in-apifox: https://app.apifox.com/web/project/7319100/apis/api-484910160-run components: schemas: {} securitySchemes: basic: type: http scheme: basic servers: - url: '' description: 正式环境 security: [] ```