Affiliate sales analytics across Shopee, AliExpress, Amazon, Mercado Livre and other marketplaces.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Compara os marketplaces lado a lado no período (cliques, pedidos, comissão, GMV, EPC, conversão, ticket médio), do que mais rende para o que menos rende. Use para perguntas tipo "qual loja rende mais?".
Alternativa a start/end: janela de N dias terminando em end_date (default 30).
Fim do período (yyyy-mm-dd). Opcional (default: hoje).
Início do período (yyyy-mm-dd). Opcional — ex.: "2026-06-01".
Compara os marketplaces lado a lado no período (cliques, pedidos, comissão, GMV, EPC, conversão, ticket médio), do que mais rende para o que menos rende. Use para perguntas tipo "qual loja rende mais?".
| Argument | Type | Description |
|---|---|---|
| days | integer | Alternativa a start/end: janela de N dias terminando em end_date (default 30). |
| end_date | string | Fim do período (yyyy-mm-dd). Opcional (default: hoje). |
| start_date | string | Início do período (yyyy-mm-dd). Opcional — ex.: "2026-06-01". |
{
"type": "object",
"properties": {
"days": {
"type": "integer",
"maximum": 366,
"minimum": 1,
"description": "Alternativa a start/end: janela de N dias terminando em end_date (default 30)."
},
"end_date": {
"type": "string",
"description": "Fim do período (yyyy-mm-dd). Opcional (default: hoje)."
},
"start_date": {
"type": "string",
"description": "Início do período (yyyy-mm-dd). Opcional — ex.: \"2026-06-01\"."
}
},
"additionalProperties": false
}Compara o período com outro (default: o período imediatamente anterior, de mesma duração): comissão, vendas, pedidos, cliques, conversão e EPC, com variação absoluta e % no total e por marketplace. Use para "como foi esta semana vs. a passada?" ou "outubro vs. setembro" (informe compare_start_date/compare_end_date).
| Argument | Type | Description |
|---|---|---|
| days | integer | Alternativa a start/end: janela de N dias terminando em end_date (default 30). |
| end_date | string | Fim do período (yyyy-mm-dd). Opcional (default: hoje). |
| start_date | string | Início do período (yyyy-mm-dd). Opcional — ex.: "2026-06-01". |
| compare_end_date | string | Fim do período de comparação (yyyy-mm-dd). Opcional; exige compare_start_date. |
| compare_start_date | string | Início do período de comparação (yyyy-mm-dd). Opcional; exige compare_end_date. |
{
"type": "object",
"properties": {
"days": {
"type": "integer",
"maximum": 366,
"minimum": 1,
"description": "Alternativa a start/end: janela de N dias terminando em end_date (default 30)."
},
"end_date": {
"type": "string",
"description": "Fim do período (yyyy-mm-dd). Opcional (default: hoje)."
},
"start_date": {
"type": "string",
"description": "Início do período (yyyy-mm-dd). Opcional — ex.: \"2026-06-01\"."
},
"compare_end_date": {
"type": "string",
"description": "Fim do período de comparação (yyyy-mm-dd). Opcional; exige compare_start_date."
},
"compare_start_date": {
"type": "string",
"description": "Início do período de comparação (yyyy-mm-dd). Opcional; exige compare_end_date."
}
},
"additionalProperties": false
}Vendas das REDES de afiliados (AWIN, CityAds, Rakuten) quebradas por ANUNCIANTE/programa (ex.: "Kabum BR", "Nike BR") no período: pedidos, itens, comissão e GMV por programa.
| Argument | Type | Description |
|---|---|---|
| days | integer | Alternativa a start/end: janela de N dias terminando em end_date (default 30). |
| end_date | string | Fim do período (yyyy-mm-dd). Opcional (default: hoje). |
| start_date | string | Início do período (yyyy-mm-dd). Opcional — ex.: "2026-06-01". |
{
"type": "object",
"properties": {
"days": {
"type": "integer",
"maximum": 366,
"minimum": 1,
"description": "Alternativa a start/end: janela de N dias terminando em end_date (default 30)."
},
"end_date": {
"type": "string",
"description": "Fim do período (yyyy-mm-dd). Opcional (default: hoje)."
},
"start_date": {
"type": "string",
"description": "Início do período (yyyy-mm-dd). Opcional — ex.: \"2026-06-01\"."
}
},
"additionalProperties": false
}Vendas PENDENTES (comissão a receber), NÃO PAGAS da Shopee (unpaid: aguardando pagamento, fora dos totais) e CANCELADAS/não efetivadas (comissão perdida) por marketplace, com taxa de cancelamento e totais. Mercado Livre entra pelo KPI diário de não efetivadas; Amazon não informa status e não entra.
| Argument | Type | Description |
|---|---|---|
| days | integer | Alternativa a start/end: janela de N dias terminando em end_date (default 30). |
| end_date | string | Fim do período (yyyy-mm-dd). Opcional (default: hoje). |
| start_date | string | Início do período (yyyy-mm-dd). Opcional — ex.: "2026-06-01". |
{
"type": "object",
"properties": {
"days": {
"type": "integer",
"maximum": 366,
"minimum": 1,
"description": "Alternativa a start/end: janela de N dias terminando em end_date (default 30)."
},
"end_date": {
"type": "string",
"description": "Fim do período (yyyy-mm-dd). Opcional (default: hoje)."
},
"start_date": {
"type": "string",
"description": "Início do período (yyyy-mm-dd). Opcional — ex.: \"2026-06-01\"."
}
},
"additionalProperties": false
}Comissão e vendas (BRL) por CATEGORIA de produto no período, de todos os marketplaces que informam categoria (as demais vão para "Outros").
| Argument | Type | Description |
|---|---|---|
| days | integer | Alternativa a start/end: janela de N dias terminando em end_date (default 30). |
| end_date | string | Fim do período (yyyy-mm-dd). Opcional (default: hoje). |
| start_date | string | Início do período (yyyy-mm-dd). Opcional — ex.: "2026-06-01". |
{
"type": "object",
"properties": {
"days": {
"type": "integer",
"maximum": 366,
"minimum": 1,
"description": "Alternativa a start/end: janela de N dias terminando em end_date (default 30)."
},
"end_date": {
"type": "string",
"description": "Fim do período (yyyy-mm-dd). Opcional (default: hoje)."
},
"start_date": {
"type": "string",
"description": "Início do período (yyyy-mm-dd). Opcional — ex.: \"2026-06-01\"."
}
},
"additionalProperties": false
}Funil por CANAL de divulgação (Telegram, WhatsApp, Instagram, Websites…): cliques, pedidos, conversão, vendas, comissão e EPC por canal. Fonte: relatórios da Shopee (Canal/Referenciador) e origem do Magalu — marketplaces sem essa dimensão não aparecem.
| Argument | Type | Description |
|---|---|---|
| days | integer | Alternativa a start/end: janela de N dias terminando em end_date (default 30). |
| end_date | string | Fim do período (yyyy-mm-dd). Opcional (default: hoje). |
| start_date | string | Início do período (yyyy-mm-dd). Opcional — ex.: "2026-06-01". |
{
"type": "object",
"properties": {
"days": {
"type": "integer",
"maximum": 366,
"minimum": 1,
"description": "Alternativa a start/end: janela de N dias terminando em end_date (default 30)."
},
"end_date": {
"type": "string",
"description": "Fim do período (yyyy-mm-dd). Opcional (default: hoje)."
},
"start_date": {
"type": "string",
"description": "Início do período (yyyy-mm-dd). Opcional — ex.: \"2026-06-01\"."
}
},
"additionalProperties": false
}Vendas DIRETAS (produto/loja do próprio link) vs INDIRETAS (outro produto/loja comprado após o clique), quebradas por marketplace em `byMarketplace[]`. Fontes: Amazon (relatório de Categorias, em ITENS; sem comissão separada), Shopee ("Tipo de atribuição": mesma loja vs loja diferente, em produtos, COM comissão separada — directCommissionBrl/indirectCommissionBrl) e Mercado Livre (quantity_direct/quantity_not_direct, em pedidos). Cada item traz direct, indirect e directShare (0–1).
| Argument | Type | Description |
|---|---|---|
| days | integer | Alternativa a start/end: janela de N dias terminando em end_date (default 30). |
| end_date | string | Fim do período (yyyy-mm-dd). Opcional (default: hoje). |
| start_date | string | Início do período (yyyy-mm-dd). Opcional — ex.: "2026-06-01". |
{
"type": "object",
"properties": {
"days": {
"type": "integer",
"maximum": 366,
"minimum": 1,
"description": "Alternativa a start/end: janela de N dias terminando em end_date (default 30)."
},
"end_date": {
"type": "string",
"description": "Fim do período (yyyy-mm-dd). Opcional (default: hoje)."
},
"start_date": {
"type": "string",
"description": "Início do período (yyyy-mm-dd). Opcional — ex.: \"2026-06-01\"."
}
},
"additionalProperties": false
}Metas de vendas (GMV) do mês corrente que o usuário definiu por marketplace, com o realizado, % atingido, quanto falta e quanto falta por dia até o fim do mês. Na Shopee traz também as faixas do bônus. Lista vazia = nenhuma meta definida (o usuário define em Metas, no painel).
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Distribuição por HORA do dia (0–23, fuso de Brasília): pedidos, itens e comissão por hora (de todos os pedidos com timestamp) e cliques por hora (quando o relatório de cliques informa hora). Use para recomendar horários de postagem.
| Argument | Type | Description |
|---|---|---|
| days | integer | Alternativa a start/end: janela de N dias terminando em end_date (default 30). |
| end_date | string | Fim do período (yyyy-mm-dd). Opcional (default: hoje). |
| start_date | string | Início do período (yyyy-mm-dd). Opcional — ex.: "2026-06-01". |
{
"type": "object",
"properties": {
"days": {
"type": "integer",
"maximum": 366,
"minimum": 1,
"description": "Alternativa a start/end: janela de N dias terminando em end_date (default 30)."
},
"end_date": {
"type": "string",
"description": "Fim do período (yyyy-mm-dd). Opcional (default: hoje)."
},
"start_date": {
"type": "string",
"description": "Início do período (yyyy-mm-dd). Opcional — ex.: \"2026-06-01\"."
}
},
"additionalProperties": false
}Insights gerados automaticamente pela IA do painel (anomalias, recomendações, tendências, digests), mais recentes primeiro.
| Argument | Type | Description |
|---|---|---|
| type | string | Filtra por tipo. Opcional. |
| limit | integer | Máximo de insights (default 10). |
{
"type": "object",
"properties": {
"type": {
"enum": [
"anomaly",
"recommendation",
"digest",
"trend"
],
"type": "string",
"description": "Filtra por tipo. Opcional."
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Máximo de insights (default 10)."
}
},
"additionalProperties": false
}Comissão, vendas, pedidos e cliques por MÊS, com variação % sobre o mês anterior, no total e por marketplace. `firstDate` depois do dia 1 indica mês incompleto (conexão recente ou início do histórico do plano) — não compare um mês incompleto como se fosse cheio.
| Argument | Type | Description |
|---|---|---|
| months | integer | Quantos meses até o atual (default 6). |
| marketplace | string | Filtra por marketplace (slug). Opcional. Valores: shopee, amazon, mercadolivre, aliexpress, awin, cityads, rakuten, magalu, natura, terabyte, paguemenos, belezanaweb, outros. |
{
"type": "object",
"properties": {
"months": {
"type": "integer",
"maximum": 12,
"minimum": 2,
"description": "Quantos meses até o atual (default 6)."
},
"marketplace": {
"type": "string",
"description": "Filtra por marketplace (slug). Opcional. Valores: shopee, amazon, mercadolivre, aliexpress, awin, cityads, rakuten, magalu, natura, terabyte, paguemenos, belezanaweb, outros."
}
},
"additionalProperties": false
}Produtos que venderam no período escolhido, com pedidos, comissão (BRL) e última venda — sem cancelados. Aceita filtro por marketplace, categoria e nome. Cliques/EPC por produto não existem por período arbitrário (para isso use painel_get_top_products).
| Argument | Type | Description |
|---|---|---|
| days | integer | Alternativa a start/end: janela de N dias terminando em end_date (default 30). |
| sort | string | Ordenação, decrescente (default commission). |
| limit | integer | Itens por página (default 20). |
| offset | integer | Deslocamento para paginação (default 0). Use paging.nextOffset da resposta. |
| search | string | Busca no nome do produto (contém, sem acento). Opcional. |
| category | string | Filtra por categoria (ex.: "Eletrônicos"). Opcional. |
| end_date | string | Fim do período (yyyy-mm-dd). Opcional (default: hoje). |
| start_date | string | Início do período (yyyy-mm-dd). Opcional — ex.: "2026-06-01". |
Visão geral do período: cliques, pedidos, itens, comissão (BRL), vendas/GMV (BRL), conversão, EPC e ticket médio — totais e por marketplace (maior comissão primeiro). É o ponto de partida para entender a conta. Conversão/EPC do total consideram só marketplaces com cliques.
| Argument | Type | Description |
|---|---|---|
| days | integer | Alternativa a start/end: janela de N dias terminando em end_date (default 30). |
| end_date | string | Fim do período (yyyy-mm-dd). Opcional (default: hoje). |
| start_date | string | Início do período (yyyy-mm-dd). Opcional — ex.: "2026-06-01". |
{
"type": "object",
"properties": {
"days": {
"type": "integer",
"maximum": 366,
"minimum": 1,
"description": "Alternativa a start/end: janela de N dias terminando em end_date (default 30)."
},
"end_date": {
"type": "string",
"description": "Fim do período (yyyy-mm-dd). Opcional (default: hoje)."
},
"start_date": {
"type": "string",
"description": "Início do período (yyyy-mm-dd). Opcional — ex.: \"2026-06-01\"."
}
},
"additionalProperties": false
}Pedidos do período agrupados por status normalizado: pending (a receber), confirmed (concluídos), unpaid ("não pago" da Shopee — aguardando pagamento, FORA dos totais, como no relatório da Shopee) e cancelled (cancelados), com itens, comissão e GMV de cada grupo.
| Argument | Type | Description |
|---|---|---|
| days | integer | Alternativa a start/end: janela de N dias terminando em end_date (default 30). |
| end_date | string | Fim do período (yyyy-mm-dd). Opcional (default: hoje). |
| start_date | string | Início do período (yyyy-mm-dd). Opcional — ex.: "2026-06-01". |
{
"type": "object",
"properties": {
"days": {
"type": "integer",
"maximum": 366,
"minimum": 1,
"description": "Alternativa a start/end: janela de N dias terminando em end_date (default 30)."
},
"end_date": {
"type": "string",
"description": "Fim do período (yyyy-mm-dd). Opcional (default: hoje)."
},
"start_date": {
"type": "string",
"description": "Início do período (yyyy-mm-dd). Opcional — ex.: \"2026-06-01\"."
}
},
"additionalProperties": false
}Vendas agrupadas pelo VALOR BRUTO de um nível de sub_id (Shopee Sub_id1..5 e equivalentes): pedidos, itens, comissão e GMV por valor — os 50 de maior comissão. Use quando o afiliado marca campanha/grupo/post no sub_id e ainda não criou etiquetas. `availableLevels` diz quais níveis têm dado.
| Argument | Type | Description |
|---|---|---|
| days | integer | Alternativa a start/end: janela de N dias terminando em end_date (default 30). |
| level | integer | Nível do sub_id (default 1). |
| end_date | string | Fim do período (yyyy-mm-dd). Opcional (default: hoje). |
| start_date | string | Início do período (yyyy-mm-dd). Opcional — ex.: "2026-06-01". |
| marketplace | string | Filtra por marketplace (slug). Opcional. Valores: shopee, amazon, mercadolivre, aliexpress, awin, cityads, rakuten, magalu, natura, terabyte, paguemenos, belezanaweb, outros. |
{
"type": "object",
"properties": {
"days": {
"type": "integer",
"maximum": 366,
"minimum": 1,
"description": "Alternativa a start/end: janela de N dias terminando em end_date (default 30)."
},
"level": {
"type": "integer",
"maximum": 5,
"minimum": 1,
"description": "Nível do sub_id (default 1)."
},
"end_date": {
"type": "string",
"description": "Fim do período (yyyy-mm-dd). Opcional (default: hoje)."
},
"start_date": {
"type": "string",
"description": "Início do período (yyyy-mm-dd). Opcional — ex.: \"2026-06-01\"."
},
"marketplace": {
"type": "string",
"description": "Filtra por marketplace (slug). Opcional. Valores: shopee, amazon, mercadolivre, aliexpress, awin, cityads, rakuten, magalu, natura, terabyte, paguemenos, belezanaweb, outros."
}
},
"additionalProperties": false
}Desempenho por etiqueta de rastreamento (sub-IDs unificados entre marketplaces, criados pelo usuário no painel) no período: cliques, pedidos, comissão, conversão e EPC por etiqueta. Use para avaliar campanhas/canais rastreados.
| Argument | Type | Description |
|---|---|---|
| days | integer | Alternativa a start/end: janela de N dias terminando em end_date (default 30). |
| end_date | string | Fim do período (yyyy-mm-dd). Opcional (default: hoje). |
| start_date | string | Início do período (yyyy-mm-dd). Opcional — ex.: "2026-06-01". |
{
"type": "object",
"properties": {
"days": {
"type": "integer",
"maximum": 366,
"minimum": 1,
"description": "Alternativa a start/end: janela de N dias terminando em end_date (default 30)."
},
"end_date": {
"type": "string",
"description": "Fim do período (yyyy-mm-dd). Opcional (default: hoje)."
},
"start_date": {
"type": "string",
"description": "Início do período (yyyy-mm-dd). Opcional — ex.: \"2026-06-01\"."
}
},
"additionalProperties": false
}Links de afiliado do AliExpress que mais renderam no período (sem cancelados): pedidos, vendas, comissão, compradores distintos e produtos vendidos por link. `coverage` diz quantos pedidos vieram com o link identificado. Só AliExpress (os outros marketplaces não informam o link da venda).
| Argument | Type | Description |
|---|---|---|
| days | integer | Alternativa a start/end: janela de N dias terminando em end_date (default 30). |
| sort | string | Ordenação, decrescente (default commission). |
| limit | integer | Itens por página (default 20). |
| offset | integer | Deslocamento para paginação (default 0). Use paging.nextOffset da resposta. |
| end_date | string | Fim do período (yyyy-mm-dd). Opcional (default: hoje). |
| start_date | string | Início do período (yyyy-mm-dd). Opcional — ex.: "2026-06-01". |
{
"type": "object",
"properties": {
"days": {
"type": "integer",
"maximum": 366,
"minimum": 1,
"description": "Alternativa a start/end: janela de N dias terminando em end_date (default 30)."
},
"sort": {
"enum": [
"commission",
"sales",
"orders",
"buyers",
"lastOrder"
],
"type": "string",
"description": "Ordenação, decrescente (default commission)."
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Itens por página (default 20)."
},
"offset": {
"type": "integer",
"minimum": 0,
"description": "Deslocamento para paginação (default 0). Use paging.nextOffset da resposta."
},
"end_date": {
"type": "string",
"description": "Fim do período (yyyy-mm-dd). Opcional (default: hoje)."
},
"start_date": {
"type": "string",
"description": "Início do período (yyyy-mm-dd). Opcional — ex.: \"2026-06-01\"."
}
},
"additionalProperties": false
}Ranking de produtos nas janelas FIXAS de 7 e 30 dias (não aceita período): comissão, pedidos, cliques, EPC ou conversão. Única fonte de cliques/EPC/conversão POR PRODUTO. Para um período escolhido (ex.: "mês passado"), use painel_get_products_by_period.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Máximo de itens (default 10). |
| sort_by | string | Métrica de ordenação, na janela de 30 dias (default commission). |
| category | string | Filtra por categoria de produto. Opcional. |
| marketplace | string | Filtra por marketplace (slug). Opcional. Valores: shopee, amazon, mercadolivre, aliexpress, awin, cityads, rakuten, magalu, natura, terabyte, paguemenos, belezanaweb, outros. |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Máximo de itens (default 10)."
},
"sort_by": {
"enum": [
"commission",
"orders",
"clicks",
"epc",
"conversion"
],
"type": "string",
"description": "Métrica de ordenação, na janela de 30 dias (default commission)."
},
"category": {
"type": "string",
"description": "Filtra por categoria de produto. Opcional."
},
"marketplace": {
"type": "string",
"description": "Filtra por marketplace (slug). Opcional. Valores: shopee, amazon, mercadolivre, aliexpress, awin, cityads, rakuten, magalu, natura, terabyte, paguemenos, belezanaweb, outros."
}
},
"additionalProperties": false
}Série temporal diária de uma métrica (comissão, pedidos, cliques ou vendas) por marketplace no período. Use para detectar tendências, picos e quedas ao longo dos dias.
| Argument | Type | Description |
|---|---|---|
| days | integer | Alternativa a start/end: janela de N dias terminando em end_date (default 30). |
| metric | string | Métrica da série: comissão, pedidos, cliques ou vendas/GMV em BRL (default commission). |
| end_date | string | Fim do período (yyyy-mm-dd). Opcional (default: hoje). |
| start_date | string | Início do período (yyyy-mm-dd). Opcional — ex.: "2026-06-01". |
| marketplace | string | Filtra por marketplace (slug). Opcional. Valores: shopee, amazon, mercadolivre, aliexpress, awin, cityads, rakuten, magalu, natura, terabyte, paguemenos, belezanaweb, outros. |
{
"type": "object",
"properties": {
"days": {
"type": "integer",
"maximum": 366,
"minimum": 1,
"description": "Alternativa a start/end: janela de N dias terminando em end_date (default 30)."
},
"metric": {
"enum": [
"commission",
"orders",
"clicks",
"sales"
],
"type": "string",
"description": "Métrica da série: comissão, pedidos, cliques ou vendas/GMV em BRL (default commission)."
},
"end_date": {
"type": "string",
"description": "Fim do período (yyyy-mm-dd). Opcional (default: hoje)."
},
"start_date": {
"type": "string",
"description": "Início do período (yyyy-mm-dd). Opcional — ex.: \"2026-06-01\"."
},
"marketplace": {
"type": "string",
"description": "Filtra por marketplace (slug). Opcional. Valores: shopee, amazon, mercadolivre, aliexpress, awin, cityads, rakuten, magalu, natura, terabyte, paguemenos, belezanaweb, outros."
}
},
"additionalProperties": false
}Lista pedidos INDIVIDUAIS no período (paginado, mais recentes primeiro por padrão), com produto, quantidade, venda, comissão, status, referenciador e anunciante. Um pedido com vários itens aparece em várias linhas. Filtros: marketplace, status, busca por nome de produto. Limitação: Amazon e Mercado Livre não têm pedidos individuais (são pré-agregados). Para totais, use painel_get_sales_summary — não some páginas.
| Argument | Type | Description |
|---|---|---|
| days | integer | Alternativa a start/end: janela de N dias terminando em end_date (default 30). |
| sort | string | Ordenação, decrescente (default date). |
| limit | integer | Itens por página (default 25). |
| offset | integer | Deslocamento para paginação (default 0). A resposta traz paging.hasMore e paging.nextOffset. |
| search | string | Busca no nome do produto (contém, sem acento). Opcional. |
| status | string | Filtra por status. Opcional. unpaid = "não pago" da Shopee (aguardando pagamento). |
| end_date | string | Fim do período (yyyy-mm-dd). Opcional (default: hoje). |
| start_date |
| marketplace |
| string |
| Filtra por marketplace (slug). Opcional. Valores: shopee, amazon, mercadolivre, aliexpress, awin, cityads, rakuten, magalu, natura, terabyte, paguemenos, belezanaweb, outros. |
{
"type": "object",
"properties": {
"days": {
"type": "integer",
"maximum": 366,
"minimum": 1,
"description": "Alternativa a start/end: janela de N dias terminando em end_date (default 30)."
},
"sort": {
"enum": [
"commission",
"orders",
"lastOrder"
],
"type": "string",
"description": "Ordenação, decrescente (default commission)."
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Itens por página (default 20)."
},
"offset": {
"type": "integer",
"minimum": 0,
"description": "Deslocamento para paginação (default 0). Use paging.nextOffset da resposta."
},
"search": {
"type": "string",
"description": "Busca no nome do produto (contém, sem acento). Opcional."
},
"category": {
"type": "string",
"description": "Filtra por categoria (ex.: \"Eletrônicos\"). Opcional."
},
"end_date": {
"type": "string",
"description": "Fim do período (yyyy-mm-dd). Opcional (default: hoje)."
},
"start_date": {
"type": "string",
"description": "Início do período (yyyy-mm-dd). Opcional — ex.: \"2026-06-01\"."
},
"marketplace": {
"type": "string",
"description": "Filtra por marketplace (slug). Opcional. Valores: shopee, amazon, mercadolivre, aliexpress, awin, cityads, rakuten, magalu, natura, terabyte, paguemenos, belezanaweb, outros."
}
},
"additionalProperties": false
}| string |
| Início do período (yyyy-mm-dd). Opcional — ex.: "2026-06-01". |
| marketplace | string | Filtra por marketplace (slug). Opcional. Valores: shopee, amazon, mercadolivre, aliexpress, awin, cityads, rakuten, magalu, natura, terabyte, paguemenos, belezanaweb, outros. |
{
"type": "object",
"properties": {
"days": {
"type": "integer",
"maximum": 366,
"minimum": 1,
"description": "Alternativa a start/end: janela de N dias terminando em end_date (default 30)."
},
"sort": {
"enum": [
"date",
"commission",
"sale"
],
"type": "string",
"description": "Ordenação, decrescente (default date)."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Itens por página (default 25)."
},
"offset": {
"type": "integer",
"minimum": 0,
"description": "Deslocamento para paginação (default 0). A resposta traz paging.hasMore e paging.nextOffset."
},
"search": {
"type": "string",
"description": "Busca no nome do produto (contém, sem acento). Opcional."
},
"status": {
"enum": [
"pending",
"confirmed",
"unpaid",
"cancelled"
],
"type": "string",
"description": "Filtra por status. Opcional. unpaid = \"não pago\" da Shopee (aguardando pagamento)."
},
"end_date": {
"type": "string",
"description": "Fim do período (yyyy-mm-dd). Opcional (default: hoje)."
},
"start_date": {
"type": "string",
"description": "Início do período (yyyy-mm-dd). Opcional — ex.: \"2026-06-01\"."
},
"marketplace": {
"type": "string",
"description": "Filtra por marketplace (slug). Opcional. Valores: shopee, amazon, mercadolivre, aliexpress, awin, cityads, rakuten, magalu, natura, terabyte, paguemenos, belezanaweb, outros."
}
},
"additionalProperties": false
}