curl --request POST \
--url https://api.metrito.com/v3/query \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"project_id": "69162064162b926ae607959b",
"fields": [
"spend",
"impressions",
"clicks"
],
"time": {
"start": "2026-02-01",
"end": "2026-02-08"
}
}
'{
"success": true,
"data": [
{
"spend": 1250.75,
"impressions": 45230,
"clicks": 1205,
"ctr": 0.0266,
"cpc": 1.038
}
],
"currency": "BRL"
}Consultar Métricas
Endpoint unificado para consulta de métricas de anúncios. Retorna dados sincronizados do PostgreSQL via CubeJS, com enriquecimento de nomes de entidades e conversão de moeda automática.
Os dados são sincronizados em background a cada 5-30 minutos (conforme o tier do plano). A resposta é instantânea (~50ms) pois consulta dados já armazenados localmente.
curl --request POST \
--url https://api.metrito.com/v3/query \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"project_id": "69162064162b926ae607959b",
"fields": [
"spend",
"impressions",
"clicks"
],
"time": {
"start": "2026-02-01",
"end": "2026-02-08"
}
}
'{
"success": true,
"data": [
{
"spend": 1250.75,
"impressions": 45230,
"clicks": 1205,
"ctr": 0.0266,
"cpc": 1.038
}
],
"currency": "BRL"
}Autorizações
JWT da plataforma ou API key mtk_live_... enviada no header Authorization
Cabeçalhos
Obrigatório quando usar JWT. Opcional quando usar API key (mtk_live_...)
"69162064162b926ae607959b"
Corpo
ID do projeto (brand) no Metrito
"69162064162b926ae607959b"
Lista de métricas a consultar. Consulte GET /v3/fields para ver todas as opções.
1["spend", "impressions", "clicks", "ctr"]
Plataforma de anúncios. Omita para consultar todas.
meta_ads, google_ads, tiktok_ads "meta_ads"
IDs de conexões específicas. Omita para usar todas as conexões do projeto.
Show child attributes
Show child attributes
Filtros para restringir os dados retornados
Show child attributes
Show child attributes
Ordenação dos resultados. Ex: { "spend": "desc" }
Show child attributes
Show child attributes
{ "spend": "desc" }
Limite de resultados
1 <= x <= 50000100
Offset para paginação
x >= 0Opções adicionais da query
Show child attributes
Show child attributes