Proporcionado por TikHub
Lista de contenido destacado de TikTok
Lista de contenidos principales de TikTok mediante TikHub. Una solicitud por llamada; TikHub cobra la solicitud tanto si se reciben datos como si no, y un contenedor de datos vacío se informa como ningún resultado.
Cómo ejecutarlo
Paso 1Configurar
Una vez: pega esto en el chat de tu agente. Skill instala el CLI e inicia sesión por sí solo. Si tu agente no puede usar un shell, conéctalo mediante MCP en su lugar.
set up https://glasser.ai/SKILL.md
Show me how to use the TikHub endpoint /api/v1/tiktok/ads/get_top_contents_list on Glasser.glasser run -p tikhub -e '/api/v1/tiktok/ads/get_top_contents_list' -i '{"period_end_timestamp":1788739200}' --endpoint-version 1Usa la versión de endpoint 1. Comprueba el precio actual antes de ejecutar. Instala e inicia sesión primero en Comenzar.
Una vez por Run:
IDEMPOTENCY_KEY=$(uuidgen)Ejecútalo y copia este mismo bloque para volver a enviarlo:
curl -X POST https://api.glasser.ai/v1/runs \
-H "Authorization: Bearer gl_..." \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-H "Content-Type: application/json" \
-d '{"provider":"tikhub","endpoint":"/api/v1/tiktok/ads/get_top_contents_list","input":{"period_end_timestamp":1788739200},"endpoint_version":1}'Reutiliza la misma Idempotency-Key para volver a enviarlo: el segundo envío es una lectura del primer Run. Una clave nueva crea un Run y un Charge nuevos. Usa la versión de endpoint 1; comprueba el precio actual antes de ejecutar.
Paso 2Prueba una tarea de ejemplo específica
Cuando necesites planificar los mensajes de una campaña, puedes investigar anuncios relevantes para encontrar enfoques que valga la pena considerar en tu briefing creativo.
Copia este prompt en tu agente para investigar enfoques de comunicación para tu campaña.
Use tikhub:/api/v1/tiktok/ads/get_top_contents_list on Glasser.
Find messaging angles in the returned ad data that relate to my campaign topic.Estructura del endpoint
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"period_end_timestamp"
],
"properties": {
"page": {
"type": "integer",
"description": "Page number, default 1"
},
"limit": {
"type": "integer",
"description": "Items per page, default 20, max 100"
},
"country_code": {
"type": "string",
"maxLength": 2048,
"minLength": 1,
"description": "Country code, default US, see /get_location_list for options"
},
"organic_only": {
"type": "boolean",
"description": "Only include organic content, default False"
},
"order_by_metric": {
"type": "integer",
"description": "Sorting metric, default 1 - `1`: By video views - `2`: By engagement rate - `3`: By 6-second view-through rate"
},
"period_dimension": {
"type": "integer",
"description": "Period, default 3 - `1`: Weekly ranking - `3`: Daily ranking - `5`: Long-period ranking (covers videos over a longer time span)"
},
"content_label_ids": {
"type": "string",
"maxLength": 2048,
"minLength": 1,
"description": "Content label IDs, comma separated (e.g. `11002,11015`), empty for all. Options: - `11001`: Nature & Animals - `11002`: Beauty & Care - `11003`: Fashion - `11004`: Music & Entertainment - `11005`: Games - `11006`: Education & Work - `11007`: Sports & Outdoor - `11008`: Creativity & Talent - `11009`: Family & Relationship - `11010`: Food & Beverage - `11011`: Vlog & Selfie - `11012`: Society - `11013`: Lifestyle & Leisure - `11014`: Vehicles & Transportation - `11015`: Technology & Finance"
},
"period_end_timestamp": {
"type": "integer",
"description": "Period end timestamp in seconds, required - Generate this value from the target ranking date; it is not returned by another endpoint - Example: `1785024000`; do not pass `0`, which returns an empty result - For period_dimension 1, pass a Sunday 00:00 UTC timestamp; other dates return no data - For period_dimension 3 or 5, any past date works"
}
},
"additionalProperties": false
}{
"period_end_timestamp": 1788739200
}Este endpoint no publica ningún esquema de salida. Recibes el cuerpo de respuesta propio del proveedor de datos, sin cambios — no garantizamos una estructura que no podemos asegurar.
Cómo funcionan los precios
| Datos devueltos o sin coincidencias | El mismo precio con o sin datos coincidentes. | $0.0015 |
|---|---|---|
| Error del proveedor de datos | El proveedor de datos no pudo responder. | $0.00 |
| Tiempo de espera agotado | El Run superó su límite de tiempo. | $0.00 |
| Error interno | Un error interno impidió completar la operación. | $0.00 |