Caminho
curl --request GET \
--url https://api.example.com/api/v1/caminhoimport requests
url = "https://api.example.com/api/v1/caminho"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.example.com/api/v1/caminho', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/api/v1/caminho",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/api/v1/caminho"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/api/v1/caminho")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/v1/caminho")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_bodyCaminho
Como duas entidades se ligam — e se essa ligação significa alguma coisa.
GET
/
api
/
v1
/
caminho
Caminho
curl --request GET \
--url https://api.example.com/api/v1/caminhoimport requests
url = "https://api.example.com/api/v1/caminho"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.example.com/api/v1/caminho', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/api/v1/caminho",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/api/v1/caminho"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/api/v1/caminho")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/v1/caminho")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_bodystring
required
CNPJ (8 ou 14 dígitos) ou id de pessoa.
string
required
CNPJ (8 ou 14 dígitos) ou id de pessoa.
curl "https://brain.pandoragraph.com/api/v1/caminho?de=00000000¶=00360305" \
-H "Authorization: Bearer pk_sua_chave"
{
"dado": {
"conectadas": false,
"caminhoExiste": true,
"ligacao": "geografica",
"relevante": false,
"porque": "o caminho passa só por mesma região, que não liga uma entidade a outra: milhões de empresas compartilham isso",
"saltos": 4,
"caminho": [
{ "id": "00000000", "tipo": "CompanyRoot" },
{ "id": "00000000444235", "tipo": "CompanyEstablishment" },
{ "id": "2611606", "tipo": "Municipality" },
{ "id": "00360305102888", "tipo": "CompanyEstablishment" },
{ "id": "00360305", "tipo": "CompanyRoot" }
]
}
}
conectadas vem false.
Agora o caso que interessa. Mesma pergunta, outro par — Petrobras contra Caixa
Econômica:
curl "https://brain.pandoragraph.com/api/v1/caminho?de=33000167¶=00360305" \
-H "Authorization: Bearer pk_sua_chave"
{
"dado": {
"conectadas": true,
"caminhoExiste": true,
"ligacao": "societaria",
"relevante": true,
"porque": "as duas se ligam por sócio em comum",
"saltos": 4,
"caminho": [
{ "id": "33000167", "tipo": "CompanyRoot" },
{ "id": "***650110**::████", "tipo": "Person" },
{ "id": "00743065", "tipo": "CompanyRoot" },
{ "id": "***424857**::████", "tipo": "Person" },
{ "id": "00360305", "tipo": "CompanyRoot" }
],
"arestas": ["PARTNER_OF", "PARTNER_OF", "PARTNER_OF", "PARTNER_OF"]
}
}
ligacao e relevante separam os dois — o
número de saltos é igual.
O nome das pessoas vem preenchido na resposta da API, dentro do
id, no
formato ***650110**::NOME COMPLETO. Aqui na documentação ele está tarjado
porque esta página é pública e são pessoas reais; o CPF já vem mascarado da
própria fonte.E vale a regra de sempre: constar no quadro societário é o que o registro
afirma, não titularidade — e o casamento é por nome, então homônimo é possível.Leia conectadas, não saltos
Duas empresas quaisquer se ligam em pouquíssimos saltos por natureza jurídica,
CNAE ou município. O caminho existe e não significa nada.Estes dois caminhos reais têm o mesmo tamanho e a mesma forma:Uma integração que lesse só o número de saltos trataria os dois igual. Por isso
CompanyRoot → LegalNature → CompanyRoot as duas são LTDA
CompanyRoot → Person → CompanyRoot a mesma pessoa é sócia das duas
conectadas reflete a relevância, não a existência do caminho.{
"dado": {
"conectadas": false,
"caminhoExiste": true,
"ligacao": "atributo_comum",
"relevante": false,
"porque": "o caminho passa só por mesma classificação cadastral, que não liga uma entidade a outra: milhões de empresas compartilham isso",
"saltos": 2,
"caminho": [
{ "id": "00360305", "tipo": "CompanyRoot" },
{ "id": "2011", "tipo": "LegalNature" },
{ "id": "34028316", "tipo": "CompanyRoot" }
]
}
}
Tipos de ligação
ligacao | relevante | o que é |
|---|---|---|
societaria | sim | pessoa em comum entre as duas |
dinheiro_publico | sim | contrato, licitação, empenho, despesa |
eleitoral | sim | doação, candidatura, partido |
endereco | sim | mesmo endereço — indício, não prova |
geografica | não | mesmo município ou UF |
atributo_comum | não | mesma natureza jurídica ou CNAE |
caminho[] e arestas[] continuam crus para você auditar a conclusão.
Sem caminho dentro do limite de saltos você recebe
200 com
caminhoExiste: false — e isso não prova que não exista ligação, só que não
achamos dentro do limite. Base fora do ar é 503, nunca conectadas: false.