Proporcionado por TikHub
Anuncios de búsqueda de TikTok
Buscar anuncios de TikTok mediante TikHub. Una solicitud por llamada; TikHub cobra la solicitud independientemente de si se devuelven datos, y un sobre de datos vacío se informa como ausencia de resultados.
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/search_ads on Glasser.glasser run -p tikhub -e '/api/v1/tiktok/ads/search_ads' -i '{}' --endpoint-version 2Usa la versión de endpoint 2. 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/search_ads","input":{},"endpoint_version":2}'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 2; 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/search_ads 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#",
"properties": {
"like": {
"type": "string",
"maxLength": 2048,
"minLength": 1,
"description": "Optional performance percentile; omit it to include all percentiles"
},
"page": {
"type": "integer",
"description": "Page number, default 1"
},
"limit": {
"type": "integer",
"description": "Items per page, default 20, max 50"
},
"period": {
"type": "integer",
"description": "Time period in days, e.g., 7, 30, 120, 180 days"
},
"keyword": {
"type": "string",
"maxLength": 2048,
"minLength": 1,
"description": "Search keyword, optional, returns all ads if empty"
},
"duration": {
"type": "string",
"maxLength": 2048,
"minLength": 1,
"description": "Optional video duration filter value"
},
"industry": {
"type": "string",
"maxLength": 2048,
"minLength": 1,
"description": "Industry ID list, multiple IDs separated by commas. Full industry ID list: https://github.com/TikHub/TikTok-Ads-Industry-Code"
},
"order_by": {
"type": "string",
"maxLength": 2048,
"minLength": 1,
"description": "Sort method, \"for_you\"=Recommended, \"likes\"=Sort by likes"
},
"ad_format": {
"type": "string",
"maxLength": 2048,
"minLength": 1,
"description": "Optional ad format; 1=Spark Ads, 2=Non-Spark Ads"
},
"objective": {
"type": "string",
"maxLength": 2048,
"minLength": 1,
"description": "Optional ad objective; omit it to include all objectives"
},
"search_id": {
"type": "string",
"maxLength": 2048,
"minLength": 1,
"description": "搜索ID（可选）/Search ID (optional)"
},
"ad_language": {
"type": "string",
"maxLength": 2048,
"minLength": 1,
"description": "Optional ad language code, e.g., en, zh-Hant"
},
"country_code": {
"type": "string",
"maxLength": 2048,
"minLength": 1,
"description": "Country code, e.g., US, UK, JP"
},
"pattern_label": {
"type": "string",
"maxLength": 2048,
"minLength": 1,
"description": "Optional creative pattern label"
}
},
"additionalProperties": false
}{}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.001 |
|---|---|---|
| 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 |