1. Geolocalização
Kipflow
  • API de Consulta
    • Ínicio
    • Empresas
      • Guia de Filtros da API - Consulta de Empresas
      • Buscar Empresa por CNPJ ou Domínio
      • Buscar Empresas com Filtros
    • Pessoas
      • Buscar Pessoa por CPF
    • Redes Sociais
      • Guia de Filtros da API - Consulta Social
      • Buscar Empresa no LinkedIn
      • Buscar Pessoa no LinkedIn
      • Buscar Pessoas no LinkedIn com Filtros
      • Buscar Personas no LinkedIn por Empresa
    • Contatos
      • Busca telefones de empresa por CNPJ ou domínio
      • Gerar emails de pessoas de uma empresa
      • Gerar email de uma pessoa a partir do LinkedIn ID
      • Gerar emails em lote a partir de IDs do LinkedIn
      • Gerar email a partir de nome completo + domínio
      • Gerar email a partir de nome completo + CNPJ
    • Inteligência
      • Classificar Atividade (CNAE) de Empresa
      • Buscar empresa por nome com score de similaridade
    • PER-DCOMP
      • Buscar declarações PER/DCOMP por CNPJ
    • Geolocalização
      • Buscar Lugares por CNPJ
        GET
    • Trabalhista
      • Consultar dados PAT por CNPJ
    • Veículos
      • Consultar frota de veículos por CNPJ
      • Consultar dados de um veículo por placa ou ID
      • Consultar tacógrafos vinculados a um CNPJ
      • Consultar dados de cronotacógrafo por placa
      • Consultar dados de múltiplos veículos por placas ou IDs
    • Jurídico
      • Buscar Parte por CPF
      • Buscar Parte por CNPJ
      • Buscar Parte por Raiz de CNPJ
      • Buscar Parte por Nome ou Razão Social
      • Buscar Parte por Nome ou Razão Social Exato
      • Buscar Advogado por CPF
      • Buscar Advogado por OAB
      • Buscar Advogado por Nome ou Razão Social
      • Buscar Advogado por Nome ou Razão Social Exato
    • Esquemas
      • EnderecoDto
      • AtividadeSecundariaDto
      • ContatoDto
      • SiteDto
      • AtividadeDto
      • SocialMediaDto
      • SocioDto
      • CompanyDto
      • TelefoneDto
      • ApiErrorDto
      • CompanySearchResponseDto
      • DividaItemDto
      • InvalidCnpjResponseDto
      • DividaDto
      • CompanyNotFoundResponseDto
      • CreateCheckoutDto
      • CompanyFilterRequestDto
      • ActivityListDto
      • CompanyFilterResponseDto
      • CpfDataDto
      • BalanceResponseDto
      • CpfResponseDto
      • PricingTierDto
      • BatchCnpjRequestDto
      • ApiErrorResponseDto
      • DatasetPricesDto
      • BatchItemResultDto
      • SocialCompanyDataDto
      • WorkspacePricingResponseDto
      • BatchSearchResponseDto
      • SocialSearchResponseDto
      • SetWorkspacePricingDto
      • BatchDomainRequestDto
      • InvalidSocialIdResponseDto
      • CurrentTierResponseDto
      • UpdateBillingInfoDto
      • SocialNotFoundResponseDto
      • BillingInfoDto
      • PersonEducationDto
      • CnpjLookupResultDto
      • PersonExperienceDto
      • PersonDataDto
      • PersonSearchResponseDto
      • InvalidPersonIdResponseDto
      • PersonNotFoundResponseDto
      • PeopleFilterRequestDto
      • PeopleFilterResponseDto
      • PhoneDto
      • ContactDataDto
      • ContactSearchResponseDto
      • ContactErrorResponseDto
      • AddCreditGrantRequestDto
      • PerdcompItemDto
      • PerdcompResponseDto
      • CpfBatchRequestDto
      • PerdcompNotFoundResponseDto
      • CpfBatchResponseDto
      • CpfLinkedinDataDto
      • EmailDto
      • GeneratedEmailDto
      • CpfLinkedinResponseDto
      • PerdcompDataDto
      • EmailDataDto
      • EmailSearchResponseDto
      • InvalidCnpjPerdcompResponseDto
      • PersonaSearchFilterDto
      • PersonaSearchRequestDto
      • CnaeAlternativoDto
      • ActivityClassifierDataDto
      • ActivityClassifierResponseDto
      • ActivityClassifierBadRequestResponseDto
      • ActivityClassifierNotFoundResponseDto
      • PatItemDto
      • PatResponseDto
      • InvalidCnpjPatResponseDto
      • EmailFilterDto
      • LinkedinBatchEmailRequestDto
      • PatNotFoundResponseDto
      • EmailFilterRequestDto
      • EmailGenerateByDomainRequestDto
      • EmailGenerateByCnpjRequestDto
      • VehicleTypeItemDto
      • PlateItemDto
      • FleetDataDto
      • FleetResponseDto
      • InvalidCnpjVehiclesResponseDto
      • VehiclesNotFoundResponseDto
      • PlateResponseDto
      • InvalidPlateResponseDto
      • GeoPlaceItemDto
      • GeoPlacesResponseDto
      • TachographRecordDto
      • TachographResponseDto
      • VehicleBatchRequestDto
      • ClasseProcessualDto
      • AssuntoCNJDto
      • OabAdvogadoDto
      • AdvogadoDto
      • ParteDto
      • ValorCausaDto
      • JulgamentoDto
      • StatusPredictusDto
      • ProcessoRelacionadoDto
      • LegalProcessoDto
      • PricingDto
      • LegalSearchResponseDto
      • LegalErrorResponseDto
  1. Geolocalização

Buscar Lugares por CNPJ

GET
/geo/v1/places

Consulta de Lugares por CNPJ#

Obtenha informações detalhadas de estabelecimentos físicos vinculados a um CNPJ, incluindo avaliações, horários, localização e fotos.

Informações Gerais#

ItemDescrição
AutenticaçãoHeader X-API-Key obrigatório
CustoConsulte em platform.kipflow.io/pricing
Rate Limit5/seg • 100/min • 1000/hora
Formato CNPJCom ou sem máscara (35.965.725/0001-07 ou 35965725000107)

Dados Retornados#

Identificação#

Nome do estabelecimento
Categoria e categoria principal
Descrição

Contato & Online#

Telefone formatado
Website
Menu online

Localização#

Endereço completo formatado
CEP, bairro, cidade, estado, país
Coordenadas (latitude e longitude)

Horários de Funcionamento#

Horários completos de abertura
Total de horas funcionamento
Horas em dias úteis vs finais de semana
Horas diurnas vs noturnas
Horários de pico
Aberto aos finais de semana (boolean)

Avaliações#

Rating (nota média)
Total de avaliações
Reviews completas
Palavras-chave das avaliações

Mídias#

Fotos do estabelecimento
Street View
Imagem de satélite

Outros#

Status do negócio (aberto/fechado)
Nível de preço
Data de atualização

Exemplo de Requisição#

Resposta de Sucesso (200)#

{
  "success": true,
  "data": [
    {
      "name": "Empresa XYZ - Loja Centro",
      "category": "Loja de Eletrônicos",
      "main_category": "electronics_store",
      "description": "Loja de eletrônicos e informática",
      "formatted_phone_number": "(11) 1234-5678",
      "website": "https://empresaxyz.com.br",
      "rating": 4.5,
      "user_ratings_total": 342,
      "latitude": -23.550520,
      "longitude": -46.633308,
      "formatted_address": "Av. Paulista, 1000 - Bela Vista, São Paulo - SP, 01310-100",
      "city": "São Paulo",
      "state": "SP",
      "opening_hours": "Seg-Sex: 9h-18h, Sáb: 9h-13h",
      "total_hours": 45.0,
      "is_open_weekend": true,
      "business_status": "OPERATIONAL",
      "cnpj": "35965725000107"
    }
  ],
  "datasets": ["places"],
  "total": 1,
  "cost": 0.21,
  "costFormatted": "R$ 0,21"
}

Códigos de Resposta#

CódigoDescrição
200Lugares encontrados com sucesso
400CNPJ inválido ou formato incorreto
402Saldo insuficiente na carteira
404Nenhum lugar encontrado para o CNPJ
429Limite de requisições excedido

Casos de Uso#

Enriquecimento de dados empresariais com informações de estabelecimentos físicos
Análise de presença física de redes/franquias
Coleta de avaliações e reputação online
Mapeamento de localizações de empresas
Análise de horários de funcionamento
Verificação de status operacional de estabelecimentos

Requisição

Authorization
API Key
Adicionar parâmetro em header
X-API-Key
Exemplo:
X-API-Key: ********************
or
Parâmetros de Consulta

Respostas

🟢200
application/json
Lugares encontrados com sucesso
Body

🟠400
🟠402
🟠404
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.kipflow.io/geo/v1/places?cnpj' \
--header 'X-API-Key: <api-key>'
Response Response Example
200 - Exemplo 1
{
    "success": true,
    "data": [
        {
            "name": "Empresa XYZ - Loja Centro",
            "category": "Loja de Eletrônicos",
            "main_category": "electronics_store",
            "description": "string",
            "formatted_phone_number": "(11) 1234-5678",
            "website": "https://empresaxyz.com.br",
            "rating": 4.5,
            "user_ratings_total": 342,
            "latitude": -23.55052,
            "longitude": -46.633308,
            "formatted_address": "Av. Paulista, 1000 - Bela Vista, São Paulo - SP, 01310-100",
            "city": "São Paulo",
            "state": "SP",
            "opening_hours": "Seg-Sex: 9h-18h, Sáb: 9h-13h",
            "total_hours": 45,
            "is_open_weekend": true,
            "business_status": "OPERATIONAL",
            "cnpj": "35965725000107"
        }
    ],
    "datasets": [
        "places"
    ],
    "total": 1,
    "cost": 0.21,
    "costFormatted": "R$ 0,21"
}
Modificado em 2026-04-13 17:15:40
Página anterior
Buscar declarações PER/DCOMP por CNPJ
Próxima página
Consultar dados PAT por CNPJ
Built with