Mercado Livre Busca
#1ml_search
Pesquisa produtos no Mercado Livre a partir da keyword e deduplica PDPs.
// docs
Parte de produtos no Mercado Livre, consolida vendedores unicos, usa uma escada de buscas no Google, valida sites oficiais com IA e pode usar diretorios de CNPJ como fallback para descobrir empresa e contatos.
Template ID
mercadolivre-google-website-cdd-seller-enrichment
Etapas
6
Formato final
JSON / CSV
Execução
Dashboard + API key
Este workflow foi desenhado para prospeccao seller-first. A GeckoAPI percorre resultados do Mercado Livre, abre cada produto, extrai o seller principal e os otherSellers, executa multiplas queries no Google, rankeia candidatos, usa IA para decidir entre visitar, fazer preflight ou descartar e, quando necessario, usa paginas de CNPJ como apoio para achar empresa, contatos e CNPJ valido.
No Dashboard, selecione o template de Mercado Livre seller enrichment.
Informe a keyword e quantas paginas do Mercado Livre o workflow deve percorrer.
Revise a estimativa maxima de creditos, incluindo a etapa de validacao com IA.
Acompanhe a coleta de produtos, a consolidacao dos sellers, a busca no Google e a validacao do site oficial.
Ao final, baixe o artifact em JSON ou CSV com um item por vendedor unico.
ml_search
Pesquisa produtos no Mercado Livre a partir da keyword e deduplica PDPs.
ml_product
Abre o produto e extrai o seller principal e os otherSellers disponiveis.
google_search
Executa uma escada de queries no Google e guarda candidatos de site oficial e diretorios de CNPJ.
ai_website_match
Usa IA para decidir entre visitar direto, fazer preflight ou descartar os candidatos rankeados.
website_contact
Extrai telefones, emails, WhatsApp, redes sociais e CNPJ do site validado ou do diretorio de CNPJ escolhido no preflight.
casa_dos_dados
Enriquece o CNPJ identificado quando o website aponta para uma empresa unica.
Estes são os campos usados no dashboard e no body do
POST /v1/workflows/runs.
| Campo | Tipo | Obrigatório | Como usar | Exemplo |
|---|---|---|---|---|
| Keyword keyword | text | Sim | Termo pesquisado no Mercado Livre. | peca para robo aspirador |
| Paginas pages | number | Sim | Quantidade de paginas do Mercado Livre que o workflow deve percorrer. | 2 |
| Formato final outputFormat | output_format | Sim | Formato do artifact final. CSV funciona bem para operacao e CRM. JSON preserva a estrutura completa do seller e da evidencias. | csv |
O payload abaixo já usa este templateId e um body real
compatível com o endpoint público. Depois da criação, acompanhe o run em
GET /v1/workflows/runs/{runId}/status e, se necessário,
cancele com POST /v1/workflows/runs/{runId}/cancel.
curl -X POST https://api.geckoapi.com.br/v1/workflows/runs \
+ -H "Authorization: Bearer SUA_CHAVE" \
+ -H "Content-Type: application/json" \
+ -d '{
"templateId": "mercadolivre-google-website-cdd-seller-enrichment",
"input": {
"keyword": "peca para robo aspirador",
"pages": 2,
"outputFormat": "csv"
}
}' Cancelar um workflow faz o resultado coletado até então se perder para consumo final, então use esse endpoint com cautela.
Cada run gera um artifact seller-centric. O item final combina identidade do vendedor, produtos de origem, candidatos do Google, decisao da IA, dados do website e enrichment empresarial.
O arquivo final sempre carrega metadados do run, o input original, a estimativa usada na criação e o resumo operacional da execução.
{
"runId": "run_ml_123",
"correlationId": "corr_ml_123",
"templateId": "mercadolivre-google-website-cdd-seller-enrichment",
"outputFormat": "json",
"generatedAt": "2026-03-29T12:00:00.000Z",
"input": {
"keyword": "peca para robo aspirador",
"pages": 2,
"outputFormat": "json"
},
"estimate": {
"maxCredits": 780,
"breakdown": [],
"caps": []
},
"summary": {
"status": "completed",
"completedTasks": 64,
"failedTasks": 2,
"discoveredStores": 41,
"uniqueStores": 18
},
"items": [
{
"seller": {
"itemId": "mercadolivre_seller#5521",
"name": "Roboparts",
"sellerId": "5521",
"sellerUrl": "https://www.mercadolivre.com.br/perfil/ROBOPARTS",
"sellerLevel": "5_green",
"powerSellerStatusTitle": "MercadoLider",
"otherSellersAvailable": true
},
"sourceProducts": [
{
"title": "Escova lateral para robo aspirador",
"url": "https://produto.mercadolivre.com.br/MLB-123"
}
],
"website": {
"status": "completed",
"selectedUrl": "https://roboparts.com.br/",
"canonicalUrl": "https://roboparts.com.br/",
"domain": "roboparts.com.br",
"title": "Roboparts",
"description": "Pecas para robo aspirador",
"phones": [
"11999998888"
],
"emails": [
"contato@roboparts.com.br"
],
"whatsAppNumbers": [
"5511999998888"
],
"facebookUrls": [],
"instagramUrls": [
"https://www.instagram.com/roboparts/"
],
"addressSnippets": [],
"contactPageUrls": [
"https://roboparts.com.br/contato"
]
},
"cnpj": {
"status": "identified",
"value": "12345678000199",
"candidates": [
"12345678000199"
]
},
"casaDosDados": {
"status": "completed",
"extractedAt": "2026-03-29T12:02:00.000Z",
"data": {
"razao_social": "Roboparts Comercio Ltda"
}
},
"enrichment": {
"googleSearchQuery": "Roboparts",
"googleSearchStatus": "completed",
"googleCandidates": [
{
"position": 1,
"url": "https://roboparts.com.br/",
"domain": "roboparts.com.br",
"title": "Roboparts",
"description": "Pecas para robo aspirador"
}
],
"aiWebsiteMatchStatus": "completed",
"aiWebsiteMatchDecision": "visit",
"aiWebsiteMatchConfidence": 0.94,
"aiWebsiteMatchSelectedUrl": "https://roboparts.com.br/",
"aiWebsiteMatchSelectedDomain": "roboparts.com.br",
"aiWebsiteMatchSelectedTitle": "Roboparts",
"aiWebsiteMatchSelectedPosition": 1,
"aiWebsiteMatchReason": "Nome, dominio e categoria batem com o seller.",
"aiWebsiteMatchBrandSignals": [
"brand-name-in-domain",
"category-match"
],
"lastError": null
},
"workflow": {
"runId": "run_ml_123",
"templateId": "mercadolivre-google-website-cdd-seller-enrichment",
"outputFormat": "json"
}
}
]
} | Path | Tipo | Descrição | Exemplo |
|---|---|---|---|
| correlationId | string | Chave de correlacao para observabilidade. | corr_ml_123 |
| estimate.maxCredits | number | 780 | |
| generatedAt | ISO-8601 string | Horario em que o artifact foi consolidado. | 2026-03-29T12:00:00.000Z |
| input.keyword | string | peca para robo aspirador | |
| input.pages | number | 2 | |
| items[] | WorkflowMercadoLivreSellerExportItem | {"seller":{"itemId":"mercadolivre_seller#5521","name":"Roboparts","sellerId":"5521","sellerUrl":"https://www.mercadolivre.com.br/perfil/ROBOPARTS","sellerLevel":"5_green","powerSellerStatusTitle":"MercadoLider","otherSellersAvailable":true},"sourceProducts":[{"title":"Escova lateral para robo aspirador","url":"https://produto.mercadolivre.com.br/MLB-123"}],"website":{"status":"completed","selectedUrl":"https://roboparts.com.br/","canonicalUrl":"https://roboparts.com.br/","domain":"roboparts.com.br","title":"Roboparts","description":"Pecas para robo aspirador","phones":["11999998888"],"emails":["contato@roboparts.com.br"],"whatsAppNumbers":["5511999998888"],"facebookUrls":[],"instagramUrls":["https://www.instagram.com/roboparts/"],"addressSnippets":[],"contactPageUrls":["https://roboparts.com.br/contato"]},"cnpj":{"status":"identified","value":"12345678000199","candidates":["12345678000199"]},"casaDosDados":{"status":"completed","extractedAt":"2026-03-29T12:02:00.000Z","data":{"razao_social":"Roboparts Comercio Ltda"}},"enrichment":{"googleSearchQuery":"Roboparts","googleSearchStatus":"completed","googleCandidates":[{"position":1,"url":"https://roboparts.com.br/","domain":"roboparts.com.br","title":"Roboparts","description":"Pecas para robo aspirador"}],"aiWebsiteMatchStatus":"completed","aiWebsiteMatchDecision":"visit","aiWebsiteMatchConfidence":0.94,"aiWebsiteMatchSelectedUrl":"https://roboparts.com.br/","aiWebsiteMatchSelectedDomain":"roboparts.com.br","aiWebsiteMatchSelectedTitle":"Roboparts","aiWebsiteMatchSelectedPosition":1,"aiWebsiteMatchReason":"Nome, dominio e categoria batem com o seller.","aiWebsiteMatchBrandSignals":["brand-name-in-domain","category-match"],"lastError":null},"workflow":{"runId":"run_ml_123","templateId":"mercadolivre-google-website-cdd-seller-enrichment","outputFormat":"json"}} | |
| outputFormat | "json" | "csv" | Formato final do artifact. | json |
| runId | string | Identificador do run. | run_ml_123 |
| summary.completedTasks | number | 64 | |
| summary.discoveredStores | number | 41 | |
| summary.failedTasks | number | 2 | |
| summary.status | WorkflowRunStatus | completed | |
| summary.uniqueStores | number | 18 | |
| templateId | string | Template executado. | mercadolivre-google-website-cdd-seller-enrichment |
Cada item representa um seller unico do Mercado Livre. O artifact deixa explicito quando nao foi encontrado um site oficial validado, evitando falsos positivos forçados.
{
"seller": {
"itemId": "mercadolivre_seller#5521",
"name": "Roboparts",
"sellerId": "5521",
"sellerUrl": "https://www.mercadolivre.com.br/perfil/ROBOPARTS",
"sellerLevel": "5_green",
"powerSellerStatusTitle": "MercadoLider",
"otherSellersAvailable": true
},
"sourceProducts": [
{
"title": "Escova lateral para robo aspirador",
"url": "https://produto.mercadolivre.com.br/MLB-123"
}
],
"website": {
"status": "skipped",
"selectedUrl": null,
"canonicalUrl": null,
"domain": null,
"title": null,
"description": null,
"phones": [],
"emails": [],
"whatsAppNumbers": [],
"facebookUrls": [],
"instagramUrls": [],
"addressSnippets": [],
"contactPageUrls": []
},
"cnpj": {
"status": "not_found",
"value": null,
"candidates": []
},
"casaDosDados": {
"status": "skipped",
"extractedAt": null,
"data": null
},
"enrichment": {
"googleSearchQuery": "Roboparts",
"googleSearchStatus": "completed",
"googleCandidates": [],
"aiWebsiteMatchStatus": "completed",
"aiWebsiteMatchDecision": "skip",
"aiWebsiteMatchConfidence": 0.32,
"aiWebsiteMatchSelectedUrl": null,
"aiWebsiteMatchSelectedDomain": null,
"aiWebsiteMatchSelectedTitle": null,
"aiWebsiteMatchSelectedPosition": null,
"aiWebsiteMatchReason": "Nenhum resultado parece ser um site oficial confiavel.",
"aiWebsiteMatchBrandSignals": [],
"lastError": null
},
"workflow": {
"runId": "run_ml_123",
"templateId": "mercadolivre-google-website-cdd-seller-enrichment",
"outputFormat": "json"
}
} | Path | Tipo | Descrição | Exemplo |
|---|---|---|---|
| casaDosDados.status | WorkflowEnrichmentStatus | skipped | |
| cnpj.status | WorkflowCnpjStatus | not_found | |
| cnpj.value | string | null | null | |
| enrichment.aiWebsiteMatchDecision | "visit" | "skip" | null | Decisao da IA sobre visitar ou nao o site. | skip |
| enrichment.googleCandidates[] | { position: number, url: string, domain: string | null, title: string | null, description: string | null } | N/A | |
| seller.itemId | string | mercadolivre_seller#5521 | |
| seller.name | string | null | Roboparts | |
| seller.sellerId | string | null | 5521 | |
| seller.sellerUrl | string | null | https://www.mercadolivre.com.br/perfil/ROBOPARTS | |
| sourceProducts[] | { title: string | null, url: string | null } | {"title":"Escova lateral para robo aspirador","url":"https://produto.mercadolivre.com.br/MLB-123"} | |
| website.selectedUrl | string | null | null | |
| website.status | WorkflowEnrichmentStatus | skipped | |
| workflow.runId | string | run_ml_123 |
Use o template no dashboard para estimar créditos, acompanhar a execução por etapa e baixar o artifact final.