Proporcionado por TikHub
Datos de percentiles de anuncios de TikTok
Datos percentiles de anuncios de TikTok mediante TikHub. Una solicitud por llamada; TikHub factura la solicitud haya datos o no, 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/get_ad_percentile on Glasser.glasser run -p tikhub -e '/api/v1/tiktok/ads/get_ad_percentile' -i '{"material_id":"7182310470102122497"}' --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_ad_percentile","input":{"material_id":"7182310470102122497"},"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_ad_percentile 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": [
"material_id"
],
"properties": {
"metric": {
"type": "string",
"maxLength": 2048,
"minLength": 1,
"description": "Analysis metric, options: - ctr_percentile: CTR percentile (default) - time_attr_conversion_rate_percentile: Time-attributed conversion rate percentile - click_cnt_percentile: Click count percentile - time_attr_convert_cnt_percentile: Time-attributed conversion count percentile - show_cnt_percentile: Impression count percentile"
},
"material_id": {
"type": "string",
"maxLength": 2048,
"minLength": 1,
"description": "Ad material ID, required parameter"
},
"period_type": {
"type": "integer",
"description": "Time period in days, default 180"
}
},
"additionalProperties": false
}{
"material_id": "7182310470102122497"
}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 |