GeckoAPI
Entrar Agendar uma demo

// docs

Google Places -> iFood -> Casa dos Dados

Parte de buscas no Google Places, valida presenca no iFood, identifica CNPJ e entrega um artifact company-centric com enrichments da Casa dos Dados.

Template ID

google-places-ifood-cdd-company-enrichment

Etapas

4

Formato final

JSON / CSV

Execução

Dashboard + API key

O que este workflow faz

Este workflow foi desenhado para descobrir empresas por localizacao, validar presenca comercial no iFood e consolidar o resultado no nivel da empresa. O output final combina sinais do Google Places, matching de lojas no iFood e dados empresariais estruturados da Casa dos Dados.

Quando usar

  • Mapear redes alimenticias que aparecem no Google Places e tambem operam no iFood.
  • Gerar bases company-centric com CNPJ e dados empresariais enriquecidos.
  • Cruzar localizacao, presenca digital e dados cadastrais em um unico artifact.

Como usar no dashboard

  1. PASSO 1

    No Dashboard, selecione o template de Google Places para iFood e Casa dos Dados.

  2. PASSO 2

    Informe a keyword principal e a lista de localizacoes que quer cobrir.

  3. PASSO 3

    Revise a estimativa de creditos e os limites de matching antes de iniciar o run.

  4. PASSO 4

    Acompanhe as etapas de Google Places, iFood, enrichment de loja e enrichment empresarial.

  5. PASSO 5

    Baixe o artifact final em JSON ou CSV para consumir uma linha ou objeto por empresa identificada.

Etapas do workflow

Google Places

#1

google_places

Busca empresas pela keyword em cada localizacao e extrai os candidatos relevantes com seus CEPs.

iFood Busca

#2

ifood_search

Pesquisa o iFood usando os CEPs deduplicados para validar quais candidatos tambem operam no marketplace.

iFood Loja

#3

ifood_store

Enriquece as lojas deduplicadas para obter dados operacionais e sinais que ajudam a identificar o CNPJ.

Casa dos Dados

#4

casa_dos_dados

Consulta o CNPJ identificado e devolve os dados empresariais completos no artifact.

Campos de input

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 principal usado para buscar empresas no Google Places e validar o matching posterior.

Escolha uma marca, categoria ou termo comercial com boa intencao de busca.

 Habib's
Localizacoes
locations
 multiline_list Sim

Lista de cidades, bairros ou combinacoes cidade + UF onde a busca sera executada.

Aceita uma localizacao por linha ou valores separados por virgula.

 Curitiba, PR\nSao Paulo, SP
Formato final
outputFormat
 output_format Sim

Formato do artifact final.

CSV funciona bem para CRM. JSON preserva toda a estrutura company-centric.

 csv

Executar este template via API

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.

Ver guia completo da API de workflows
Criar workflow 
curl -X POST https://api.geckoapi.com.br/v1/workflows/runs \
+  -H "Authorization: Bearer SUA_CHAVE" \
+  -H "Content-Type: application/json" \
+  -d '{
  "templateId": "google-places-ifood-cdd-company-enrichment",
  "input": {
    "keyword": "Habib's",
    "locations": [
      "Curitiba, PR",
      "Sao Paulo, SP"
    ],
    "outputFormat": "csv"
  }
}'

Cancelar um workflow faz o resultado coletado até então se perder para consumo final, então use esse endpoint com cautela.

O que você recebe no arquivo final

Cada run gera um artifact company-centric com metadados do fluxo, resumo de execucao e uma lista de empresas identificadas por CNPJ com seus sinais de matching e enrichment empresarial.

Empresa identificada por CNPJ como item principal do artifact.
Contexto de matching com locations, CEPs, Google Places e lojas do iFood relacionadas.
Payload empresarial enriquecido da Casa dos Dados.
Artifact pronto para analise comercial, CRM e prospeccao.

Envelope do artifact

O arquivo final sempre carrega metadados do run, o input original, a estimativa usada na criação e o resumo operacional da execução.

artifact.json 
{
  "runId": "run_company_123",
  "correlationId": "corr_company_123",
  "templateId": "google-places-ifood-cdd-company-enrichment",
  "outputFormat": "json",
  "generatedAt": "2026-03-23T12:00:00.000Z",
  "input": {
    "keyword": "Habib's",
    "locations": [
      "Curitiba, PR"
    ],
    "outputFormat": "json"
  },
  "estimate": {
    "maxCredits": 9086,
    "breakdown": [],
    "caps": []
  },
  "summary": {
    "status": "completed",
    "completedTasks": 42,
    "failedTasks": 2,
    "discoveredStores": 38,
    "uniqueStores": 12
  },
  "items": [
    {
      "cnpj": "12345678000199",
      "matching": {
        "keyword": "Habib's",
        "zipCodes": [
          "80010000"
        ],
        "locations": [
          "Curitiba, PR"
        ],
        "googlePlaceCount": 1,
        "ifoodStoreCount": 1
      },
      "googlePlaces": [
        {
          "googlePlaceId": "google-1",
          "name": "Habib's Centro",
          "address": "Rua X, Curitiba - PR, 80010-000",
          "zipCode": "80010000",
          "city": "Curitiba",
          "country": "Brasil",
          "website": "https://habibs.com.br",
          "domain": "habibs.com.br",
          "phone": "41 3333-4444",
          "url": "https://maps.google.com/?cid=1",
          "locations": [
            "Curitiba, PR"
          ]
        }
      ],
      "ifoodStores": [
        {
          "storeId": "store-1",
          "matchedZipCodes": [
            "80010000"
          ],
          "locations": [
            "Curitiba, PR"
          ],
          "merchant": {
            "name": "Habib's Centro",
            "url": "https://www.ifood.com.br/delivery/curitiba-pr/habibs-centro/store-1",
            "phone": "41 3333-4444"
          }
        }
      ],
      "company": {
        "enrichmentStatus": "enriched",
        "error": null,
        "casaDosDados": {
          "extractedAt": "2026-03-23T12:05:00.000Z",
          "searchTotal": 1,
          "identifiedCompaniesCount": 1,
          "matchedSearchResult": {
            "cnpj": "12345678000199"
          },
          "sameRegionCompanies": [],
          "data": {
            "razao_social": "Habibs Curitiba Ltda",
            "contato_email": [
              {
                "email": "contato@habibs.com.br"
              }
            ],
            "contato_telefonico": [
              {
                "completo": "41-33334444"
              }
            ],
            "endereco": {
              "municipio": "Curitiba",
              "uf": "PR"
            }
          }
        }
      },
      "workflow": {
        "runId": "run_company_123",
        "templateId": "google-places-ifood-cdd-company-enrichment",
        "outputFormat": "json"
      }
    }
  ]
}
Path Tipo Descrição Exemplo
correlationId string Correlacao interna usada para rastrear a execucao completa. corr_company_123
estimate.maxCredits number Estimativa maxima de creditos reservada para a execucao. 9086
generatedAt ISO-8601 string Momento de consolidacao do arquivo final. 2026-03-23T12:00:00.000Z
input.keyword string Keyword principal usada no workflow. Habib's
input.locations[] string Locations pesquisadas no Google Places. Curitiba, PR
input.outputFormat "json" | "csv" Formato solicitado na criacao do run. json
items[] WorkflowCompanyExportItem Lista final de empresas identificadas e enriquecidas. {"cnpj":"12345678000199","matching":{"keyword":"Habib's","zipCodes":["80010000"],"locations":["Curitiba, PR"],"googlePlaceCount":1,"ifoodStoreCount":1},"googlePlaces":[{"googlePlaceId":"google-1","name":"Habib's Centro","address":"Rua X, Curitiba - PR, 80010-000","zipCode":"80010000","city":"Curitiba","country":"Brasil","website":"https://habibs.com.br","domain":"habibs.com.br","phone":"41 3333-4444","url":"https://maps.google.com/?cid=1","locations":["Curitiba, PR"]}],"ifoodStores":[{"storeId":"store-1","matchedZipCodes":["80010000"],"locations":["Curitiba, PR"],"merchant":{"name":"Habib's Centro","url":"https://www.ifood.com.br/delivery/curitiba-pr/habibs-centro/store-1","phone":"41 3333-4444"}}],"company":{"enrichmentStatus":"enriched","error":null,"casaDosDados":{"extractedAt":"2026-03-23T12:05:00.000Z","searchTotal":1,"identifiedCompaniesCount":1,"matchedSearchResult":{"cnpj":"12345678000199"},"sameRegionCompanies":[],"data":{"razao_social":"Habibs Curitiba Ltda","contato_email":[{"email":"contato@habibs.com.br"}],"contato_telefonico":[{"completo":"41-33334444"}],"endereco":{"municipio":"Curitiba","uf":"PR"}}}},"workflow":{"runId":"run_company_123","templateId":"google-places-ifood-cdd-company-enrichment","outputFormat":"json"}}
outputFormat "json" | "csv" Formato final escolhido pelo usuario. json
runId string Identificador unico do run no dashboard. run_company_123
summary.completedTasks number Total de tarefas concluídas com sucesso. 42
summary.discoveredStores number Quantidade total de registros vistos antes da consolidacao. 38
summary.failedTasks number Total de tarefas que falharam. 2
summary.status WorkflowRunStatus Status final do workflow. completed
summary.uniqueStores number Quantidade de itens finais exportados no artifact. 12
templateId string Template usado para gerar este artifact. google-places-ifood-cdd-company-enrichment

Estrutura de cada item

Cada item representa uma empresa, nao uma loja isolada. O artifact agrega os Google Places, as lojas do iFood relacionadas e o payload da Casa dos Dados no mesmo registro.

item.json 
{
  "cnpj": "12345678000199",
  "matching": {
    "keyword": "Habib's",
    "zipCodes": [
      "80010000"
    ],
    "locations": [
      "Curitiba, PR"
    ],
    "googlePlaceCount": 1,
    "ifoodStoreCount": 1
  },
  "googlePlaces": [
    {
      "googlePlaceId": "google-1",
      "name": "Habib's Centro",
      "address": "Rua X, Curitiba - PR, 80010-000",
      "zipCode": "80010000",
      "city": "Curitiba",
      "country": "Brasil",
      "website": "https://habibs.com.br",
      "domain": "habibs.com.br",
      "phone": "41 3333-4444",
      "url": "https://maps.google.com/?cid=1",
      "locations": [
        "Curitiba, PR"
      ]
    }
  ],
  "ifoodStores": [
    {
      "storeId": "store-1",
      "matchedZipCodes": [
        "80010000"
      ],
      "locations": [
        "Curitiba, PR"
      ],
      "merchant": {
        "name": "Habib's Centro",
        "url": "https://www.ifood.com.br/delivery/curitiba-pr/habibs-centro/store-1",
        "phone": "41 3333-4444"
      }
    }
  ],
  "company": {
    "enrichmentStatus": "enriched",
    "error": null,
    "casaDosDados": {
      "extractedAt": "2026-03-23T12:05:00.000Z",
      "searchTotal": 1,
      "identifiedCompaniesCount": 1,
      "matchedSearchResult": {
        "cnpj": "12345678000199"
      },
      "sameRegionCompanies": [],
      "data": {
        "razao_social": "Habibs Curitiba Ltda",
        "contato_email": [
          {
            "email": "contato@habibs.com.br"
          }
        ],
        "contato_telefonico": [
          {
            "completo": "41-33334444"
          }
        ],
        "endereco": {
          "municipio": "Curitiba",
          "uf": "PR"
        }
      }
    }
  },
  "workflow": {
    "runId": "run_company_123",
    "templateId": "google-places-ifood-cdd-company-enrichment",
    "outputFormat": "json"
  }
}
Path Tipo Descrição Exemplo
cnpj string CNPJ identificado como entidade principal do item. 12345678000199
company.casaDosDados.data.contato_email[].email string Emails empresariais retornados no enrichment. contato@habibs.com.br
company.casaDosDados.data.contato_telefonico[].completo string Telefones empresariais retornados no enrichment. 41-33334444
company.casaDosDados.data.endereco.municipio string | null Municipio principal da empresa. Curitiba
company.casaDosDados.data.endereco.uf string | null UF principal da empresa. PR
company.casaDosDados.data.razao_social string | null Razao social retornada pela Casa dos Dados. Habibs Curitiba Ltda
company.casaDosDados.extractedAt ISO-8601 string | null Momento em que a consulta empresarial foi consolidada. 2026-03-23T12:05:00.000Z
company.enrichmentStatus "enriched" | "failed" | "partial" Resultado final do enrichment empresarial. enriched
company.error string | null Mensagem de erro quando o enrichment empresarial nao conclui com sucesso. null
googlePlaces[].address string Endereco visivel no Google Places. Rua X, Curitiba - PR, 80010-000
googlePlaces[].name string Nome do candidato encontrado no Google Places. Habib's Centro
googlePlaces[].phone string | null Telefone publico associado ao candidato do Google Places. 41 3333-4444
googlePlaces[].website string | null Website publico associado ao candidato do Google Places. https://habibs.com.br
googlePlaces[].zipCode string CEP extraido do candidato do Google Places. 80010000
ifoodStores[].merchant.name string | null Nome do merchant enriquecido no iFood. Habib's Centro
ifoodStores[].merchant.url string | null URL do merchant no iFood. https://www.ifood.com.br/delivery/curitiba-pr/habibs-centro/store-1
ifoodStores[].storeId string Identificador da loja deduplicada do iFood. store-1
matching.googlePlaceCount number Quantidade de candidatos do Google Places agregados neste item. 1
matching.ifoodStoreCount number Quantidade de lojas do iFood associadas a este item. 1
matching.keyword string Keyword que originou o grupo de matching. Habib's
matching.locations[] string Locations em que a empresa apareceu no workflow. Curitiba, PR
matching.zipCodes[] string CEPs associados ao matching desta empresa. 80010000
workflow.templateId string Template responsavel por gerar este item. google-places-ifood-cdd-company-enrichment

Observações importantes

  • O artifact final e centrado na empresa identificada, nao em cada loja individual.
  • O CSV prioriza colunas operacionais e comerciais; o JSON preserva o contexto completo de matching.
Grátis para sempre

Rodar este workflow no dashboard?

Use o template no dashboard para estimar créditos, acompanhar a execução por etapa e baixar o artifact final.

Abrir dashboard Ver exemplos de uso
WhatsApp