Mediahub Rest API
  1. TikTok
Mediahub Rest API
  • Introdução
  • API Reference
    • Facebook Ads
      • Accounts
      • Ads [Ad Level]
      • Ads Config [Ad Level]
      • Ads [Adset Level]
      • Ads Config [Adset Level]
      • Ads [Campaign Level]
      • Ads Config [Campaign Level]
      • Ads Actions
      • Ads Gender/Age
      • Ads Region
      • Ads Platform
      • Creatives [Deprecated]
      • Creatives with Ad
    • Google Ads
      • Accounts
      • Ads Conversions
      • Ads [Ad Group]
      • Ads [Conversion Segmented Ad Group]
      • Ads [Ad Group Ads]
      • Ads Criterion [Ad Group Ads]
      • Ads [Conversion Segmented Ad Group Ads]
      • Ads [Campaigns]
      • Ads Criterion [Campaigns]
      • Ads [Conversion Segmented Campaigns]
      • Ads Age Dimension
      • Ads Gender Dimension
      • Ads Geographic Dimension
      • Ads Keywords Dimension
    • Google Analytics
      • Google Analytics Customers
      • Google Analytics Custom Events
      • Google Analytics Events
      • Google Analytics Products
      • Google Analytics Sessions
      • Google Analytics Transactions
    • Instagram Insights
      • Instagram Age Insights
      • Instagram City Insights
      • Instagram Gender Insights
      • instagram Media Details
      • Instagram Media Insights
      • Instagram Profile
      • Instagram Profile Insights
    • TikTok
      • TikTok Budget
        GET
      • TikTok Demographic
        GET
      • TikTok Group Budget
        GET
      • TikTok Info
        GET
      • TikTok Region
        GET
    • Linkedin
      • Linkedin Statistics
      • Linkedin Accounts Campaigns
      • Linkedin Conversions Tracking
    • Bitrix
      • Bitrix Contacts
      • Bitrix Deals
      • Bitrix Won Deals
      • Bitrix Leads History
    • Kommo
      • Kommo Contacts
      • Kommo Leads
      • Kommo Pipelines
      • Kommo Users
    • Loja Integrada
      • Loja Integrada Customers
      • Loja Integrada Orders
      • Loja Integrada Products
    • Nuvem Shop
      • Nuvem Shop Customers
      • Nuvem Shop Orders
      • Nuvem Shop Products
    • Pipedrive
      • Pipedrive Deals
      • Pipedrive Leads
      • Pipedrive Lead Sources
      • Pipedrive People
      • Pipedrive Pipelines
      • Pipedrive Pipeline Stages
      • Pipedrive Products
      • Pipedrive Users
    • Rd Station
      • Rd Station Deal Stages
      • Rd Station Deals
      • Rd Station Products
    • Shopify
      • Shopify Customers
      • Shopify Orders
      • Shopify Orders Items
      • Shopify Products
    • Tray
      • Tray Customers
      • Tray Orders
      • Tray Products
    • Unbounce
      • Unbounce Leads
    • Vtex
      • Vtex Customers
      • Vtex Orders
      • Vtex Products
    • Investimentos de Mídia
      • Investimentos de Mídia
    • Integrações
      • Integrações
  1. TikTok

TikTok Info

GET
https://rest.api.mktlab.app/v1/tiktok/info
Resposta
A resposta descreve detalhes abrangentes sobre um anúncio do TikTok, cobrindo informações do anúncio, campanha, formatos, links de rastreamento, e outros parâmetros relacionados à execução e otimização. Abaixo está uma explicação detalhada sobre cada campo desse tipo.

Descrição do Tipo ITiktokInfo#

CampoTipoDescrição
image_idsstringIDs das imagens usadas no anúncio.
shopping_ads_fallback_typestringTipo de fallback para anúncios de compras (caso algum erro ocorra).
tiktok_item_idstringID do item do TikTok associado ao anúncio.
adgroup_namestringNome do grupo de anúncios.
campaign_namestringNome da campanha.
ad_ref_pixel_idstringID do pixel de rastreamento usado para este anúncio.
avatar_icon_web_uristringURI do ícone de avatar na web para o anúncio.
tracking_offline_event_set_idsstringIDs dos conjuntos de eventos offline para rastreamento.
landing_page_urlstringURL da página de destino para o anúncio.
click_tracking_urlstringURL de rastreamento de cliques para o anúncio.
viewability_vast_urlstringURL VAST (Video Ad Serving Template) para rastreamento de visibilidade de anúncios.
adgroup_idstringID do grupo de anúncios.
call_to_action_idstringID do botão de call-to-action associado ao anúncio.
ad_idstringID único do anúncio.
ad_textstringTexto do anúncio (descrição ou título).
creative_authorizedbooleanIndica se o criativo foi autorizado para veiculação.
creative_typestringTipo de criativo (ex: imagem, vídeo, etc.).
tracking_pixel_idstringID do pixel de rastreamento para medir a eficácia do anúncio.
optimization_eventstringEvento de otimização associado ao anúncio (ex: conversão, clique, etc.).
impression_tracking_urlstringURL para rastreamento de impressões do anúncio.
card_idstringID do cartão (ex: carrossel de imagens ou vídeos) associado ao anúncio.
page_idstringID da página relacionada ao anúncio.
video_idstringID do vídeo associado ao anúncio, caso seja um anúncio de vídeo.
deeplinkstringLink direto para um conteúdo ou produto específico dentro do aplicativo.
app_namestringNome do aplicativo associado ao anúncio.
brand_safety_vast_urlstringURL VAST para garantir a segurança da marca no anúncio.
playable_urlstringURL para o conteúdo interativo ou jogável (se aplicável).
brand_safety_postbid_partnerstringNome do parceiro de pós-leilão para a segurança da marca.
viewability_postbid_partnerstringNome do parceiro de pós-leilão para rastreamento de visibilidade.
vast_moat_enabledbooleanIndica se o VAST Moat (parceiro de medição de visibilidade) está habilitado.
display_namestringNome exibido do anunciante ou campanha.
create_timeDateData e hora de criação do anúncio.
is_acobooleanIndica se o anúncio pertence a um tipo de campanha ACO (Automatic Campaign Optimization).
ad_formatstringFormato do anúncio (ex: imagem, vídeo, carrossel).
is_new_structurebooleanIndica se a estrutura do anúncio segue um novo modelo de dados.
ad_textsstringTexto do anúncio (pode incluir descrições, chamadas ou legendas).
carousel_image_labelsstringRótulos para as imagens do carrossel de anúncios, se aplicável.
operation_statusstringStatus operacional do anúncio (ex: ativo, pausado).
modify_timeDateData e hora da última modificação do anúncio.
landing_page_urlsstringURLs de várias páginas de destino associadas ao anúncio, caso existam múltiplas.
dynamic_destinationstringDestino dinâmico associado ao anúncio, possivelmente relacionado a produtos ou conteúdos dinâmicos.
vertical_video_strategystringEstratégia para vídeos verticais.
identity_idstringID da identidade associada ao anúncio (ex: influenciador, criador de conteúdo).
music_idstringID da música usada no anúncio, caso seja um anúncio musical.
profile_image_urlstringURL da imagem de perfil associada ao criador do anúncio ou à marca.
secondary_statusstringStatus secundário associado ao anúncio (ex: pausado, expirado).
advertiser_idstringID único do anunciante.
promotional_music_disabledstringIndica se a música promocional foi desabilitada para o anúncio.
campaign_idstringID da campanha associada ao anúncio.
identity_typestringTipo de identidade associada ao criador de conteúdo ou à marca (ex: influenciador, marca oficial).
deeplink_typestringTipo de link profundo (para redirecionar para um conteúdo específico dentro de um aplicativo).
ad_namestringNome do anúncio.
fallback_typestringTipo de fallback para o anúncio, no caso de falha na entrega do criativo.
call_to_actionstringTexto ou tipo de chamada para ação (CTA) do anúncio (ex: "Compre agora", "Saiba mais").
integration_idstringID da integração com a plataforma do TikTok.
project_idstringID do projeto associado ao anúncio.
unit_idstringID da unidade de negócios associada ao anúncio.
document_idstringID do documento relacionado ao anúncio ou campanha.
inserted_atDateData e hora de inserção do registro no sistema (formato ISO 8601).



Requisição

Authorization
Forneça seu token bearer no cabeçalho
Authorization
ao fazer requisições para recursos protegidos.
Exemplo:
Authorization: Bearer ********************
Parâmetros de Consulta

Respostas

🟢200Tiktok Info
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://rest.api.mktlab.app/v1/tiktok/info' \
--header 'Authorization: Bearer <token>'
Response Response Example
{
    "data": [
        {
            "image_ids": "img123,img456",
            "shopping_ads_fallback_type": "default",
            "tiktok_item_id": "item_123456",
            "adgroup_name": "Spring Sale Ad Group",
            "campaign_name": "Spring Sale 2025",
            "ad_ref_pixel_id": "pixel123",
            "avatar_icon_web_uri": "https://example.com/avatar.jpg",
            "tracking_offline_event_set_ids": "event1,event2",
            "landing_page_url": "https://example.com/landing",
            "click_tracking_url": "https://example.com/click",
            "viewability_vast_url": "https://example.com/vast",
            "adgroup_id": "adgroup_12345",
            "call_to_action_id": "cta_123",
            "ad_id": "ad_123456",
            "ad_text": "Shop our new Spring collection now!",
            "creative_authorized": true,
            "creative_type": "video",
            "tracking_pixel_id": "pixel_123",
            "optimization_event": "purchase",
            "impression_tracking_url": "https://example.com/impression",
            "card_id": "card123",
            "page_id": "page123",
            "video_id": "video123",
            "deeplink": "tiktok://product/123456",
            "app_name": "TikTok",
            "brand_safety_vast_url": "https://example.com/brand_safety",
            "playable_url": "https://example.com/playable_content",
            "brand_safety_postbid_partner": "partner1",
            "viewability_postbid_partner": "partner2",
            "vast_moat_enabled": true,
            "display_name": "Spring Collection",
            "create_time": "2025-03-24T00:00:00Z",
            "is_aco": true,
            "ad_format": "carousel",
            "is_new_structure": false,
            "ad_texts": "Spring Sale, Limited Time Only!",
            "carousel_image_labels": "new, exclusive",
            "operation_status": "active",
            "modify_time": "2025-03-24T00:00:00Z",
            "landing_page_urls": "https://example.com/landing1,https://example.com/landing2",
            "dynamic_destination": "https://example.com/dynamic_product",
            "vertical_video_strategy": "optimize",
            "identity_id": "identity_123",
            "music_id": "music_123",
            "profile_image_url": "https://example.com/profile.jpg",
            "secondary_status": "paused",
            "advertiser_id": "advertiser123",
            "promotional_music_disabled": "false",
            "campaign_id": "campaign_123456",
            "identity_type": "brand",
            "deeplink_type": "product",
            "ad_name": "Spring Sale Video",
            "fallback_type": "image",
            "call_to_action": "Shop Now",
            "integration_id": "integration_123",
            "project_id": "project_123",
            "unit_id": "unit_123",
            "document_id": "document_123",
            "inserted_at": "2025-03-24T00:00:00Z"
        }
    ],
    "meta": {
        "page": 1,
        "limit": 500,
        "total": 1,
        "totalPages": 1,
        "hasNextPage": false,
        "hasPreviousPage": true
    }
}
Modificado em 2025-10-08 17:25:55
Página anterior
TikTok Group Budget
Próxima página
TikTok Region
Built with