Buscar Lugares por CNPJ
GET
/geo/v1/places
Consulta de Lugares por CNPJ
Informações Gerais
| Item | Descrição |
|---|---|
| Autenticação | Header X-API-Key obrigatório |
| Custo | Consulte em platform.kipflow.io/pricing |
| Rate Limit | 5/seg • 100/min • 1000/hora |
| Formato CNPJ | Com ou sem máscara (35.965.725/0001-07 ou 35965725000107) |
Dados Retornados
Identificação
Contato & Online
Localização
Horários de Funcionamento
Avaliações
Mídias
Outros
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ódigo | Descrição |
|---|---|
| 200 | Lugares encontrados com sucesso |
| 400 | CNPJ inválido ou formato incorreto |
| 402 | Saldo insuficiente na carteira |
| 404 | Nenhum lugar encontrado para o CNPJ |
| 429 | Limite de requisições excedido |
Casos de Uso
Requisição
Parâmetros de Consulta
Respostas
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