Instagram Media Insights
GET
https://rest.api.mktlab.app/v1/instagram/media-insights
Resposta
| Campo | Tipo | Descrição |
|---|---|---|
id_insert | number | ID do registro inserido no banco de dados. |
media_id | string | ID único da mídia no Instagram. |
media_type | string | Tipo da mídia (ex: "IMAGE", "VIDEO"). |
media_product_type | string | Tipo de produto da mídia (ex: "CAROUSEL", "SINGLE_IMAGE"). |
media_timestamp | Date | Data e hora em que a mídia foi postada (formato ISO 8601). |
metric_name | string | Nome da métrica associada à mídia (ex: "engajamento", "alcance", etc.). |
metric_period | string | Período de tempo da métrica (ex: "2025-01-01 - 2025-01-31"). |
metric_value | number | Valor da métrica associada à mídia (ex: 1500 para curtidas). |
metric_title | string | Título descritivo da métrica associada à mídia (ex: "Total de Curtidas"). |
metric_description | string | Descrição detalhada da métrica associada à mídia. |
integration_id | string | ID da integração entre o sistema e a conta do Instagram. |
project_id | string | ID do projeto associado aos dados do insight de mídia. |
unit_id | string | ID da unidade de negócios associada ao insight de mídia. |
document_id | string | ID do documento relacionado ao insight ou ao relatório de dados de mídia. |
inserted_at | Date | 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/instagram/media-insights' \
--header 'Authorization: Bearer <token>'Response Response Example
{
"data": [
{
"id_insert": 1,
"media_id": "media_12345",
"media_type": "IMAGE",
"media_product_type": "SINGLE_IMAGE",
"media_timestamp": "2025-01-01T08:30:00Z",
"metric_name": "engajamento",
"metric_period": "2025-01-01 - 2025-01-31",
"metric_value": 1500,
"metric_title": "Total de Curtidas",
"metric_description": "Número total de curtidas recebidas pela imagem no período.",
"integration_id": "integration_123",
"project_id": "project_abc",
"unit_id": "unit_xyz",
"document_id": "document_001",
"inserted_at": "2025-03-24T10:00:00Z"
}
],
"meta": {
"page": 1,
"limit": 500,
"total": 1,
"totalPages": 1,
"hasNextPage": false,
"hasPreviousPage": true
}
}Modificado em 2025-10-08 17:25:55