Creatives with Ad
GET
https://rest.api.mktlab.app/v1/facebook/ads/creatives
Resposta
| Campo | Tipo | Descrição |
|---|---|---|
| creative_id | string | ID do criativo no Facebook. |
| creative_name | string | Nome do criativo conforme cadastrado na plataforma. |
| object_type | string | Tipo do objeto do criativo (ex: SHARE, VIDEO). |
| status | string | Status atual do criativo (ex: ACTIVE, PAUSED). |
| ad_id | string | ID do anúncio vinculado ao criativo. |
| ad_created_time | string | Data de criação do anúncio (formato ISO 8601). |
| instagram_permalink_url | string | Link direto para o criativo no Instagram. |
| thumbnail_url | string | URL da miniatura do criativo (imagem exibida). |
| title | string | Título do criativo (se houver). |
| video_id | string | ID do vídeo associado ao criativo (se aplicável). |
| image_url | string | URL da imagem usada no criativo. |
| url_tags | string | Tags de rastreamento aplicadas à URL (ex: UTM). |
| optimization_type | string | Tipo de otimização do criativo (ex: PLACEMENT, REACH). |
| ad_formats | array (string) | Formatos utilizados pelo criativo (ex: SINGLE_IMAGE, AUTOMATIC_FORMAT). |
| website_link | string | Link externo vinculado ao criativo (ex: site, WhatsApp). |
| call_to_action_types | array (string) | Tipos de chamada para ação utilizados (ex: SHOP_NOW, WHATSAPP_MESSAGE). |
| title_text | string | Texto alternativo/título complementar do criativo. |
| age_max | integer | Idade máxima segmentada para o público-alvo. |
| age_min | integer | Idade mínima segmentada para o público-alvo. |
| publisher_platforms | array (string) | Plataformas onde o criativo é exibido (ex: facebook, instagram). |
| facebook_positions | array (string) | Posições de exibição no Facebook (ex: feed, reels, marketplace). |
| instagram_positions | array (string) | Posições de exibição no Instagram (ex: explore, feed, stories). |
| messenger_positions | array (string) | Posições de exibição no Messenger (ex: messenger_home). |
| audience_network_positions | array (string) | null |
| reasons_to_shop | boolean | Indica se o criativo apresenta motivos para compra (true/false). |
| shops_bundle | boolean | Indica se o criativo faz parte de um pacote de loja (true/false). |
| integration_id | string | ID da integração com a conta de anúncios do Facebook. |
| project_id | string | ID do projeto associado a integração. |
| unit_id | string | ID da unidade. |
| document_id | string | ID do documento da integração. |
| inserted_at | string | Data e hora em que o registro foi inserido no sistema (formato ISO 8601). |
Requisição
Parâmetros de Consulta
Respostas
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://rest.api.mktlab.app/v1/facebook/ads/creatives' \
--header 'Authorization: Bearer <token>'Response Response Example
{
"data": [
{
"creative_id": "120216407326512345",
"creative_name": "{{product.name}} 2025-01-10-7c69fcd1c4323fb89fa212db9d12345",
"object_type": "SHARE",
"status": "ACTIVE",
"ad_id": "120215298180012345",
"ad_created_time": "2025-05-01T03:00:00.000Z",
"instagram_permalink_url": "https://www.instagram.com/",
"thumbnail_url": "https://scontent-iad3-1.xx.fbcdn.net/...",
"title": null,
"video_id": null,
"image_url": null,
"url_tags": null,
"optimization_type": "PLACEMENT",
"ad_formats": [
"AUTOMATIC_FORMAT"
],
"website_link": "https://api.whatsapp.com/send",
"call_to_action_types": [
"WHATSAPP_MESSAGE"
],
"title_text": "Titulo Exemplo",
"age_max": 65,
"age_min": 13,
"publisher_platforms": [
"facebook",
"instagram",
"messenger"
],
"facebook_positions": [
"facebook_reels_overlay",
"profile_feed"
],
"instagram_positions": [
"ig_search",
"explore_home",
"profile_feed"
],
"messenger_positions": [
"messenger_home"
],
"audience_network_positions": null,
"reasons_to_shop": false,
"shops_bundle": false,
"integration_id": "integration456",
"project_id": "project789",
"unit_id": "unit123",
"document_id": "doc789",
"inserted_at": "2025-05-15T12:00:00Z"
}
],
"meta": {
"page": 1,
"limit": 500,
"total": 1,
"totalPages": 1,
"hasNextPage": false,
"hasPreviousPage": true
}
}Modificado em 2025-10-08 17:25:55