Demostración de integración de la API de TikTok — conceive_plus
conceive_plus — Demo de integración con la API de TikTok
SASMAR, INC. — Demo de solicitud de acceso estándar
Acerca de conceive_plus
conceive_plus es una herramienta interna creada por SASMAR, INC. para gestionar la presencia oficial de Conceive Plus en TikTok. Conceive Plus es una marca global de fertilidad confiada por parejas en más de 70 países.
La aplicación se conecta a la API de TikTok para publicar contenido educativo sobre fertilidad, monitorear el rendimiento de videos y gestionar campañas publicitarias en nuestras dos cuentas de anuncios de TikTok.
1
Autenticación — Flujo OAuth 2.0
conceive_plus se autentica usando el flujo estándar OAuth 2.0 de TikTok. La aplicación solicita solo los alcances necesarios para sus funciones específicas.
Flujo de autorización OAuth 2.0
① Usuario hace clic
Conectar TikTok
→
Conectar TikTok
② Redirigir a
Inicio de sesión en TikTok
→
Inicio de sesión en TikTok
③ Usuario aprueba
alcances
→
alcances
④ URL de devolución de llamada
recibe código
→
recibe código
⑤ Token emitido
✓ Conectado
✓ Conectado
URL de autorización:
https://www.tiktok.com/v2/auth/authorize/?client_key=sbaw5sn6ibwqhd42&scope=video.publish,video.list,research.adlib.basic&response_type=code&redirect_uri=https://conceiveplus.com/pages/tiktok-callback&state=secure_random_state
https://www.tiktok.com/v2/auth/authorize/?client_key=sbaw5sn6ibwqhd42&scope=video.publish,video.list,research.adlib.basic&response_type=code&redirect_uri=https://conceiveplus.com/pages/tiktok-callback&state=secure_random_state
URL de devolución de llamada (en vivo en conceiveplus.com/pages/tiktok-callback):
https://conceiveplus.com/pages/tiktok-callback?code=auth_code_here&state=secure_random_state
→ La aplicación intercambia el código por un token de acceso mediante POST a https://open.tiktokapis.com/v2/oauth/token/
https://conceiveplus.com/pages/tiktok-callback?code=auth_code_here&state=secure_random_state
→ La aplicación intercambia el código por un token de acceso mediante POST a https://open.tiktokapis.com/v2/oauth/token/
✅ Alcances solicitados:
| Alcance | Propósito |
|---|---|
| video.publish | Publicar videos educativos sobre fertilidad en la cuenta de TikTok @conceiveplus |
| video.list | Recuperar lista de videos publicados y monitorear rendimiento |
| research.adlib.basic | Acceder a datos de campañas publicitarias de las cuentas publicitarias de SASMAR INC y SASMAR LIMITED |
2
Publicación de videos — alcance video.publish
La aplicación publica videos educativos sobre fertilidad de Conceive Plus directamente en TikTok. El contenido incluye guías de productos, consejos de fertilidad e historias de éxito de clientes.
📦 Demo Sandbox — Flujo de carga de video
// Paso 1: Inicializar carga
POST https://open.tiktokapis.com/v2/post/publish/inbox/video/init/
Autorización: Bearer {sandbox_token}
{
"source_info": { "source": "FILE_UPLOAD", "video_size": 12500000, "chunk_size": 12500000, "total_chunk_count": 1 }
}
→ Respuesta: { "publish_id": "v_sandbox_pub_123", "upload_url": "https://..." }
// Paso 2: Subir archivo de video a la URL proporcionada
PUT {upload_url}
Content-Range: bytes 0-12499999/12500000
[video binary data]
// Paso 3: Publicar con metadatos
POST https://open.tiktokapis.com/v2/post/publish/video/init/
{
"post_info": {
"title": "Soporte de ovulación Conceive Plus — ¿Qué es el Mio-Inositol?",
"privacy_level": "PUBLIC_TO_EVERYONE",
"disable_comment": false
},
"source_info": { "source": "FILE_UPLOAD", "video_size": 12500000 }
}
→ Devuelve: { "publish_id": "v_pub_456", "status": "PUBLISHED" } ✅
POST https://open.tiktokapis.com/v2/post/publish/inbox/video/init/
Autorización: Bearer {sandbox_token}
{
"source_info": { "source": "FILE_UPLOAD", "video_size": 12500000, "chunk_size": 12500000, "total_chunk_count": 1 }
}
→ Respuesta: { "publish_id": "v_sandbox_pub_123", "upload_url": "https://..." }
// Paso 2: Subir archivo de video a la URL proporcionada
PUT {upload_url}
Content-Range: bytes 0-12499999/12500000
[video binary data]
// Paso 3: Publicar con metadatos
POST https://open.tiktokapis.com/v2/post/publish/video/init/
{
"post_info": {
"title": "Soporte de ovulación Conceive Plus — ¿Qué es el Mio-Inositol?",
"privacy_level": "PUBLIC_TO_EVERYONE",
"disable_comment": false
},
"source_info": { "source": "FILE_UPLOAD", "video_size": 12500000 }
}
→ Devuelve: { "publish_id": "v_pub_456", "status": "PUBLISHED" } ✅
✅ Caso de uso: Publicar videos educativos semanales sobre fertilidad para aumentar la audiencia de @conceiveplus en TikTok y dirigir tráfico a conceiveplus.com
3
Análisis de video — alcance video.list
La aplicación recupera datos de videos publicados para monitorear el rendimiento e informar la estrategia de contenido.
Solicitud API:
POST https://open.tiktokapis.com/v2/video/list/
fields=id,title,create_time,view_count,like_count,comment_count,share_count
Respuesta del entorno de pruebas:
{
"videos": [
{ "id": "v123", "title": "Soporte de ovulación Conceive Plus", "view_count": 8420, "like_count": 312, "share_count": 89 },
{ "id": "v124", "title": "PCOS y consejos de fertilidad", "view_count": 12300, "like_count": 541, "share_count": 203 }
]
}
POST https://open.tiktokapis.com/v2/video/list/
fields=id,title,create_time,view_count,like_count,comment_count,share_count
Respuesta del entorno de pruebas:
{
"videos": [
{ "id": "v123", "title": "Soporte de ovulación Conceive Plus", "view_count": 8420, "like_count": 312, "share_count": 89 },
{ "id": "v124", "title": "PCOS y consejos de fertilidad", "view_count": 12300, "like_count": 541, "share_count": 203 }
]
}
✅ Caso de uso: Monitorear el rendimiento de videos para identificar el contenido más exitoso y optimizar la estrategia de publicación futura
4
Datos de campaña publicitaria — alcance research.adlib.basic
La aplicación accede a datos publicitarios de las dos cuentas de anuncios de Conceive Plus en TikTok para monitorear el rendimiento de las campañas y el retorno de inversión.
Cuentas publicitarias conectadas:
• SASMAR INC (USD) — ID de anunciante: 7226731490892070913
• SASMAR LIMITED (EUR) — ID de anunciante: 7275832885129740290
Solicitud API:
GET https://business-api.tiktok.com/open_api/v1.3/report/integrated/get/
?advertiser_id=7226731490892070913&report_type=BASIC&dimensions=["campaign_id"]
&metrics=["spend","impressions","clicks","conversions"]&start_date=2026-06-01&end_date=2026-06-02
Respuesta del entorno de pruebas:
{
"data": {
"list": [
{ "campaign_id": "c001", "spend": "450.00", "impressions": 89000, "clicks": 1240, "conversions": 18 }
]
}
}
• SASMAR INC (USD) — ID de anunciante: 7226731490892070913
• SASMAR LIMITED (EUR) — ID de anunciante: 7275832885129740290
Solicitud API:
GET https://business-api.tiktok.com/open_api/v1.3/report/integrated/get/
?advertiser_id=7226731490892070913&report_type=BASIC&dimensions=["campaign_id"]
&metrics=["spend","impressions","clicks","conversions"]&start_date=2026-06-01&end_date=2026-06-02
Respuesta del entorno de pruebas:
{
"data": {
"list": [
{ "campaign_id": "c001", "spend": "450.00", "impressions": 89000, "clicks": 1240, "conversions": 18 }
]
}
}
✅ Caso de uso: Extraer datos diarios de rendimiento de anuncios para medir gasto vs ingresos y optimizar automáticamente los presupuestos de campaña
Uso de datos y cumplimiento
Todos los datos de la API de TikTok se usan exclusivamente para operaciones internas de marketing de Conceive Plus.
No se comparte ningún dato de usuario de TikTok con terceros ni se utiliza para ningún propósito más allá de lo descrito anteriormente.
Política de privacidad de conceive_plus | Términos de servicio de conceive_plus