1. Facebook Ads
Mediahub Rest API
  • Introdução
  • API Reference
    • Facebook Ads
      • Accounts
        GET
      • Ads [Ad Level]
        GET
      • Ads Config [Ad Level]
        GET
      • Ads [Adset Level]
        GET
      • Ads Config [Adset Level]
        GET
      • Ads [Campaign Level]
        GET
      • Ads Config [Campaign Level]
        GET
      • Ads Actions
        GET
      • Ads Gender/Age
        GET
      • Ads Region
        GET
      • Ads Platform
        GET
      • Creatives [Deprecated]
        GET
      • Creatives with Ad
        GET
    • 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
      • TikTok Demographic
      • TikTok Group Budget
      • TikTok Info
      • TikTok Region
    • 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. Facebook Ads

Creatives [Deprecated]

GET
https://rest.api.mktlab.app/v1/facebook/creatives
Consulta os dados de criativos do Facebook Ads trazendo seus detalhamentos.
Deprecated - Prefira utilizar o endpoint de 'Creatives with Ad'

Resposta#

A resposta retorna uma lista de criativos das campanhas do Facebook com os seguintes campos:
CampoTipoDescrição
id_insertstringID do registro inserido no banco de dados.
idstringID do criativo no Facebook.
namestringNome do criativo.
object_typestringTipo do objeto do criativo (ex: image, video, carousel).
titlestringTítulo do criativo.
instagram_permalink_urlstringLink direto para o criativo no Instagram.
thumbnail_urlstringURL da miniatura do criativo.
statusstringStatus atual do criativo (ex: ACTIVE, PAUSED).
video_idstringID do vídeo associado ao criativo (se aplicável).
image_urlstringURL da imagem do criativo.
website_linkstringURL do site vinculado ao criativo.
call_to_action_typesstringTipo de chamada para ação (ex: SHOP_NOW, LEARN_MORE).
title_textstringTexto do título do criativo.
ad_formatsstringFormato do anúncio (ex: carousel, single_image, video).
age_maxstringIdade máxima segmentada para o criativo.
age_minstringIdade mínima segmentada para o criativo.
publisher_platformsstringPlataformas de publicação (ex: facebook, instagram).
facebook_positionsstringPosições no Facebook (ex: feed, stories, marketplace).
instagram_positionsstringPosições no Instagram (ex: feed, stories, explore).
messenger_positionsstringPosições no Messenger (ex: inbox, stories).
audience_network_positionsstringPosições na Audience Network (ex: native, feed).
datestringData de referência do criativo (formato ISO 8601).
integration_idstringID da integração da plataforma com a conta do Facebook.
project_idstringID do projeto associado ao criativo.
unit_idstringID da unidade de negócios associada ao criativo.
document_idstringID do documento associado ao criativo.
inserted_atstringData e hora em que o registro foi inserido 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

🟢200Creatives
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://rest.api.mktlab.app/v1/facebook/creatives' \
--header 'Authorization: Bearer <token>'
Response Response Example
{
    "data": [
        {
            "id": "creative98765",
            "name": "Creative Example Name",
            "object_type": "image",
            "title": "Summer Sale Ad",
            "instagram_permalink_url": "https://www.instagram.com/p/creative_example/",
            "thumbnail_url": "https://www.example.com/thumbnail.jpg",
            "status": "ACTIVE",
            "video_id": "video12345",
            "image_url": "https://www.example.com/ad_image.jpg",
            "website_link": "https://www.example.com/sale",
            "call_to_action_types": "SHOP_NOW",
            "title_text": "Shop the Best Deals This Summer!",
            "ad_formats": "carousel",
            "age_max": "45",
            "age_min": "18",
            "publisher_platforms": "facebook,instagram",
            "facebook_positions": "feed,stories",
            "instagram_positions": "feed,stories",
            "messenger_positions": "inbox",
            "audience_network_positions": "native,feed",
            "date": "2025-03-01T00:00:00Z",
            "integration_id": "integration456",
            "project_id": "project789",
            "unit_id": "unit123",
            "document_id": "doc789",
            "inserted_at": "2025-03-15T12: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
Ads Platform
Próxima página
Creatives with Ad
Built with