Pesquisa de vídeos

Introdução

Filtre vídeos por palavras-chave ou condições de filtro, com os seguintes recursos:

• Oferece suporte à pesquisa difusa
• Oferece suporte à configuração de parâmetros de filtro
• Oferece suporte à ordenação personalizada dos resultados

Endpoint da API

    POST /video/v1/search

Corpo da solicitação

Campo	Tipo	Obrigatório	Descrição
keywords	string	Não	Palavras-chave de pesquisa
filter	object	Não	Parâmetros de filtro
orderby	object	Não	Parâmetros de ordenação
page	integer	Não	Número da página, padrão: 1
pagesize	integer	Não	Itens por página, padrão: 10
lang	string	Não	Configurações de idioma, Inglês (padrão): EN_US, Chinês: ZH_CN

page * pagesize <= 5000

Intervalo de pagesize [1,100]

Detalhes de keywords

• Comprimento máximo: 120 caracteres
• Padrão: String vazia

Valores opcionais de filter (tipo object)

Campo	Tipo	Obrigatório	Descrição
region	string	Não	País/região
is_ecommerce	boolean	Não	Se é um vídeo de comércio eletrônico (1: Sim)
creator_category_id	integer	Não	ID da categoria do criador
product_category_id	integer	Não	ID da categoria l1 do produto
create_time_range	object	Sim	Intervalo de tempo de publicação
follower_count_range	object	Não	Intervalo do número de seguidores, por exemplo {'min': 100000, 'max': 500000}
play_count_range	object	Não	Intervalo do número de reproduções, por exemplo {'min': 100000, 'max': 500000}
digg_count_range	object	Não	Intervalo do número de curtidas, por exemplo {'min': 100000, 'max': 500000}
interact_rate_range	object	Não	Intervalo da taxa de engajamento, por exemplo {'min': 10, 'max': 20} (10%-20%)

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

Valores opcionais de orderby

Campo	Obrigatório	Descrição
follower_count	Não	Número de seguidores (decrescente)
create_time	Não	Data de publicação (decrescente)
play_count	Não	Número de reproduções (decrescente)
digg_count	Não	Número de curtidas (decrescente)
units_sold	Não	Unidades vendidas (decrescente)
interact_rate	Não	Taxa de engajamento (decrescente)

Exemplo de solicitação

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
}'

Corpo da resposta

data.total

Número total de resultados

data.list

Campo	Tipo	Descrição
video_id	integer	ID do vídeo
desc	string	Descrição do vídeo
uid	string	UID do criador
is_ad	integer	Sinalizador de anúncio, 1 para anúncio, 0 para não-anúncio
region	string	Código do país/região
publish_time	integer	Data de publicação do vídeo, timestamp (segundos)
comment_count	integer	Número de comentários
play_count	integer	Número de reproduções
digg_count	integer	Número de curtidas
share_count	integer	Número de compartilhamentos
forward_count	integer	Número de favoritos
duration	integer	Duração do vídeo (segundos)
cover	string	URL da capa do vídeo
interact_rate	float	Taxa de engajamento (por exemplo, 10 significa 10%) (obsoleto)
interact_rate_info	object	Detalhes da taxa de engajamento
is_ecommerce	integer	Sinalizador de vídeo de comércio eletrônico (1 para sim, 0 para não)
video_url	string	URL do vídeo no TikTok
units_sold	integer	Número de produtos vendidos
gmv	float	Valor de vendas
creator	object	Informações do criador
product_info	array[object]	Lista de produtos

data.list.creator Informações do criador

Campo	Tipo	Descrição
uid	integer	ID do criador
avatar	string	URL do avatar
unique_id	string	ID exclusivo do criador
nickname	string	Apelido
region	string	Código do país/região
category	object	Categoria do criador
follower_count	integer	Número de seguidores

data.list.product_info Lista de produtos

Campo	Tipo	Descrição
product_id	string	ID do produto
title	string	Nome do produto
cover	string	Imagem de capa do produto
region	string	Código do país/região do produto
currency	string	Código da moeda (por exemplo, USD)
price	string	Preço do produto
units_sold	integer	Volume de vendas do produto
gmv	float	Valor de vendas do produto
category	object	Categoria do produto {"l1":{"id": 12, "name": "Beauty"}}
source	string	Origem, atualmente apenas "TikTok Shop"
detail_url	string	URL da página de detalhes do produto

Exemplo de resposta

{
  "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"
}