tiktok/
search-photos

Busque carruseles de fotos de TikTok por palabra clave, sin videos, y obtenga cada imagen de las diapositivas junto con la descripción, los hashtags, el creador y los conteos de vistas, Me gusta, comentarios y veces compartido.

TikTok Photo Search API

Búsqueda por palabra clave
Solo publicaciones de fotos
Todas las imágenes del carrusel
0.6 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

TikTok Photo Search

Una publicación de fotos de TikTok es un conjunto de imágenes fijas que se desliza, publicado con una descripción, hashtags y un sonido, y que acumula los mismos contadores de vistas, Me gusta, comentarios y veces compartido que un video. Buscar solo en estas publicaciones muestra qué formatos visuales funcionan para un tema, desde cuadrículas de outfits y pasos de recetas hasta listas y recopilaciones de productos.

Funcionalidades de la TikTok Photo Search API

  • Solo publicaciones de fotosCada resultado es un carrusel de fotos y los videos quedan fuera, así que la búsqueda por palabra clave no se diluye con resultados de video.
  • Cada diapositiva con sus dimensionesmedia enumera cada imagen de la publicación en el orden de las diapositivas, con su type, url, width y height.
  • Interacción y contexto de la publicaciónmetrics informa Me gusta, comentarios, veces compartido, reproducciones y vistas, y cada publicación trae su descripción en texto, hashtags, menciones, el audio y los campos del perfil del creador.

Parámetros de la TikTok Photo Search API

ParámetrosObligatorioDescripción
queryObligatorioPalabra clave con la que se buscan publicaciones de fotos.
results_limitOpcionalCuántas publicaciones de fotos se devuelven, de 1 a 500. El valor predeterminado es 20.

Cómo usar la TikTok Photo Search API

Busque una palabra clave y recorra por páginas las publicaciones de fotos que coinciden.

  1. Envíe {"query": "outfit ideas", "results_limit": 20} por POST a /v1/tiktok/search-photos.
  2. Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
  3. Lea las publicaciones de fotos en results.items y devuelva results.next_cursor mientras has_more sea true.
curl -X POST "https://api.socq.ai/v1/tiktok/search-photos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"outfit ideas","results_limit":20}'

# media holds every image of each carousel, in slide order.

Casos de uso de la TikTok Photo Search API

  • Comparar formatos de carrusel: Compare la cantidad de imágenes de media con los Me gusta, comentarios, veces compartido y vistas de los carruseles de una palabra clave para ver qué longitudes obtienen respuesta.
  • Investigar descripciones y hashtags: Lea text y hashtags de las publicaciones de fotos más fuertes de una palabra clave para ver cómo redactan y etiquetan los creadores el contenido que rinde.
  • Tableros de tendencias visuales: Reúna las imágenes de las publicaciones principales de una palabra clave como outfit ideas para armar tableros de referencia de moda, comida o viajes.

Consejos de expertos para la TikTok Photo Search API

  • Ordene las publicaciones por la suma de Me gusta, comentarios y veces compartido dividida entre views_count y no por Me gusta brutos, para que una buena publicación de una cuenta pequeña no quede tapada por la de una cuenta grande; omita las publicaciones cuyo views_count esté vacío o sea cero.
  • Ejecute cada formulación de un tema como una consulta aparte, por ejemplo outfit ideas y ootd, y elimine duplicados por id al combinar los resultados, ya que un mismo carrusel puede coincidir con varias.
  • Descargue las imágenes de las diapositivas poco después de que termine la tarea si necesita los archivos, porque TikTok las sirve con enlaces firmados que vencen.
  • Agrupe las publicaciones por audio.id y no por audio.title, ya que muchas publicaciones de fotos llevan el sonido propio del creador, cuyo título es solo una etiqueta genérica de sonido original.

Además de la TikTok Photo Search API, use estas APIs cuando necesite otro tipo de datos públicos de TikTok.

  • TikTok Profiles API — Obtiene por nombre de usuario la identidad del perfil público, biografías, indicadores de cuenta y conteos de audiencia.
  • TikTok Hashtags API — Recolecta videos públicos, creadores, contenido multimedia, sonido e interacción de los hashtags indicados.
  • TikTok Comments API — Recolecta comentarios públicos de primer nivel, autores, interacción, menciones e indicadores de interacción del creador.
  • TikTok Search API — Busca videos públicos por palabra clave con filtros de orden y de publicación compatibles.
  • TikTok Live Room Info API — Consulta una transmisión en vivo conocida mediante el par de IDs de la sala y del propietario, y devuelve su estado, el contexto del propietario, la portada y los conteos de audiencia.
  • TikTok Comment Keywords API — Encuentra las palabras clave más frecuentes en los comentarios de un video, con los comentarios que las respaldan.

Explorar otras plataformas

Combine los datos de TikTok con datos públicos de otras plataformas sociales compatibles.

TikTok Photo Search API — FAQ

TikTok Photo Search API es una interfaz programática para buscar por palabra clave publicaciones de fotos en formato carrusel de TikTok. Devuelve todas las imágenes de cada publicación junto con la descripción, el creador, los hashtags y los conteos de vistas, Me gusta, comentarios y veces compartido.

Este endpoint devuelve únicamente carruseles de fotos, y los videos quedan fuera de los resultados.

En la práctica, sí. TikTok llama al formato publicaciones de fotos o modo foto, y los creadores lo llaman presentaciones o carruseles; cada resultado aquí es una publicación de ese tipo, con sus diapositivas en media.

Todas. media enumera cada imagen en el orden de las diapositivas, con su url, width y height.

No. Un resultado informa Me gusta, comentarios, veces compartido, reproducciones y vistas, pero no incluye un conteo de guardados.

Top Search devuelve mezclados los videos y los carruseles de fotos de una palabra clave, mientras que Photo Search conserva solo los carruseles, así que todos los resultados traen sus imágenes en media.

results_limit acepta de 1 a 500 y vale 20 por defecto. Cada publicación de fotos devuelta se factura a 0.6 créditos, y una búsqueda sin publicaciones de fotos que coincidan no cuesta nada.