Búsqueda de vídeos

Introducción

Filtra vídeos por palabras clave o condiciones de filtrado, con las siguientes funciones:

• Admite búsqueda aproximada
• Admite configurar parámetros de filtrado
• Admite ordenación personalizada de resultados

Punto de acceso de la API

    POST /video/v1/search

Cuerpo de la solicitud

Campo	Tipo	Obligatorio	Descripción
keywords	string	No	Palabras clave de búsqueda
filter	object	No	Parámetros de filtro
orderby	object	No	Parámetros de ordenación
page	integer	No	Número de página, predeterminado: 1
pagesize	integer	No	Elementos por página, predeterminado: 10
lang	string	No	Configuración de idioma, inglés (predeterminado): EN_US, chino: ZH_CN

page * pagesize <= 5000

pagesize Rango: [1,100]

Detalles de keywords

• Longitud máxima: 120 caracteres
• Predeterminado: cadena vacía

Valores opcionales de filter (tipo object)

Campo	Tipo	Obligatorio	Descripción
region	string	No	País/Región
is_ecommerce	boolean	No	Indica si es un vídeo de comercio electrónico (1: Sí)
creator_category_id	integer	No	ID de categoría del creador
product_category_id	integer	No	ID de categoría l1 del producto
create_time_range	object	Sí	Rango de hora de publicación
follower_count_range	object	No	Rango de número de seguidores, p. ej., {'min': 100000, 'max': 500000}
play_count_range	object	No	Rango de número de reproducciones, p. ej., {'min': 100000, 'max': 500000}
digg_count_range	object	No	Rango de número de me gusta, p. ej., {'min': 100000, 'max': 500000}
interact_rate_range	object	No	Rango de tasa de interacción, p. ej., {'min': 10, 'max': 20} (10%-20%)

Rango de region: ['US','GB','MX','ES','DE','IT','FR','PT','NL','BE','AT','PL','ID','VN','MY','TH','PH','BR','JP','SG']

orderby Valores opcionales

Campo	Obligatorio	Descripción
follower_count	No	Número de seguidores (descendente)
create_time	No	Hora de publicación (descendente)
play_count	No	Número de reproducciones (descendente)
digg_count	No	Número de me gusta (descendente)
units_sold	No	Unidades vendidas (descendente)
interact_rate	No	Tasa de interacción (descendente)

Solicitud Ejemplo

curl 'https://openapi.fastmoss.com/video/v1/search' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer xxxxxxxxxx' \
--data '{
    # "keywords": "test",
    "filter": {
        "region": "US",
        "is_ecommerce": 1,
        "creator_category_id": 4,
        "product_category_id": 12,
        "follower_count_range": {"min": 1000, "max": 100000},
        # "create_time_range": {"min": 1678092800, "max": 1678697600},
        # "interact_rate_range": {"min": 10, "max": 20},
    },
    "orderby": [{"field":"follower_count", "order":"desc"}],
    # "orderby": [{"field":"create_time", "order":"desc"}],
    # "orderby": [{"field":"interact_rate", "order":"desc"}],
    # "orderby": [{"field":"play_count", "order":"desc"}],
    # "orderby": [{"field":"digg_count", "order":"desc"}],
    # "orderby": [{"field":"units_sold", "order":"desc"}],
    "page": 1,
    "pagesize": 10
}'

Cuerpo de la respuesta

data.total

Número total de resultados

data.list

Campo	Tipo	Descripción
video_id	integer	Vídeo ID
desc	string	Descripción del vídeo
uid	string	UID del creador
is_ad	integer	Indicador de anuncio, 1 para anuncio, 0 para no anuncio
region	string	Código de país/región
publish_time	integer	Hora de publicación del vídeo, marca de tiempo (segundos)
comment_count	integer	Número de comentarios
play_count	integer	Número de reproducciones
digg_count	integer	Número de me gusta
share_count	integer	Número de compartidos
forward_count	integer	Número de favoritos
duration	integer	Duración del vídeo (segundos)
cover	string	URL de portada del vídeo
interact_rate	float	Tasa de interacción (p. ej., 10 significa 10%) (obsoleto)
interact_rate_info	object	Detalles de la tasa de interacción
is_ecommerce	integer	Indicador de vídeo de comercio electrónico (1 para sí, 0 para no)
video_url	string	URL del vídeo en TikTok
units_sold	integer	Número de productos vendidos
gmv	float	Monto de ventas
creator	object	Información del creador
product_info	array[object]	Lista de productos

data.list.creator Información del creador

Campo	Tipo	Descripción
uid	integer	ID de creador
avatar	string	URL del avatar
unique_id	string	ID único del creador
nickname	string	Apodo
region	string	Código de país/región
category	object	Categoría del creador
follower_count	integer	Número de seguidores

data.list.product_info Lista de productos

Campo	Tipo	Descripción
product_id	string	ID de producto
title	string	Nombre del producto
cover	string	Imagen de portada del producto
region	string	Código de país/región del producto
currency	string	Código de moneda (p. ej., USD)
price	string	Precio del producto
units_sold	integer	Volumen de ventas del producto
gmv	float	Monto de ventas del producto
category	object	Categoría del producto {"l1":{"id": 12, "name": "Beauty"}}
source	string	Origen, actualmente solo "TikTok Tienda"
detail_url	string	URL de la página de detalle del producto

Respuesta Ejemplo

{
  "code": 0,
  "data": {
    "total": 2437,
    "list": [
      {
        "video_id": "7517469614079610142",
        "desc": "#fyp #foryou #relatable #xyzbca #blowthisup ",
        "uid": "6764812635147207685",
        "is_ad": 0,
        "cover": "https://s.500fd.com/tt_video/ogoJVwT1ZBfI2AFR9EkI8uLCpUE9AHfturaDEt~tplv-tiktokx-cropcenter-q:300:400:q72.jpeg",
        "region": "US",
        "publish_time": 1750297310,
        "duration": 5,
        "play_count": 20600000,
        "share_count": 378200,
        "digg_count": 3800000,
        "comment_count": 16400,
        "forward_count": 264159,
        "interact_rate": 20.36, // deprecated
        "interact_rate_info": {
          "rate": 20.36,
          "unit": "%"
        },
        "is_ecommerce": 1,
        "video_url": "https://www.tiktok.com/@seenontiktokltd/video/7516849526523858199",
        "creator": {
          "uid": "6764812635147207685",
          "avatar": "https://s.500fd.com/tt_author/d19f10b759f11d0043878ed0acbeae7f~tplv-tiktokx-cropcenter:1080:1080.jpeg",
          "nickname": "Julz",
          "unique_id": "julzgeekin",
          "region": "US",
          "category_id": 6,
          "category_name": "Fashion",
          "follower_count": 28188
        },
        "units_sold": 2,
        "gmv": 103,
        "product_info": [
          {
            "product_id": "1730186290864034458",
            "title": "Pacsun Men's Escape Reality Zip Up Hoodie",
            "cover": "https://s.500fd.com/tt_product/97468f66b806475a9a16bcfc03826bc1~tplv-omjb5zjo8w-crop-webp:500:500.webp",
            "region": "US",
            "currency": "USD",
            "price": "$51.96",
            "units_sold": 2,
            "gmv": 103.92,
            "category": {
              "l1": {
                "id": 3,
                "name": "Men's Clothing"
              }
            },
            "source": "TikTok Shop",
            "detail_url": "https://shop.tiktok.com/view/product/1730186290864034458?region=US&local=en"
          }
        ]
      }
    ]
  },
  "message": "",
  "timestamp": 1750745256,
  "request_id": "7885f669-27e0-bdb2-1140-b6742978f5f1"
}