Get your team's network at a company

Returns your team’s connections at a specific company, who you know there, what roles they hold and which teammates are linked to them.

Returns 404 when the org has no resolvable contacts at the requested company.

This endpoint uses 1 credit per request.

GET /network/connection/{companyId}

Get your team's network at a company

cURL

curl --request GET \
  --url https://app.tryspecter.com/api/v1/network/connection/{companyId} \
  --header 'X-API-Key: <api-key>'

import requests

url = "https://app.tryspecter.com/api/v1/network/connection/{companyId}"

headers = {"X-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://app.tryspecter.com/api/v1/network/connection/{companyId}', 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://app.tryspecter.com/api/v1/network/connection/{companyId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$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://app.tryspecter.com/api/v1/network/connection/{companyId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://app.tryspecter.com/api/v1/network/connection/{companyId}")
  .header("X-API-Key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.tryspecter.com/api/v1/network/connection/{companyId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

200

{
  "company_id": "66d926166261234567890123",
  "contacts": [
    {
      "person_id": "per_5f3a2b1c4d5e6f7a8b9c0d1e",
      "connected_teammates": [
        "user_2opva2jahltnNL8xOK7vArM0IBg"
      ],
      "full_name": "Jane Doe",
      "headline": "Engineering Lead @ Acme · ex-Google",
      "profile_picture_url": "https://media.licdn.com/dms/image/.../profile.jpg",
      "linkedin_url": "https://linkedin.com/in/janedoe",
      "twitter_url": "https://twitter.com/janedoe",
      "github_url": "https://github.com/janedoe"
    }
  ],
  "roles": [
    "engineer",
    "founder"
  ],
  "connected_teammates": [
    "user_2opva2jahltnNL8xOK7vArM0IBg"
  ]
}

{
  "errorCode": "API_KEY_MISSING",
  "message": "No API Key was presented on the header X-API-KEY"
}

{
  "errorCode": "OUT_OF_CREDITS",
  "message": "<string>"
}

{
  "errorCode": "NOT_PERMITTED",
  "message": "You do not have permission to access this resource."
}

{
  "errorCode": "<string>",
  "message": "<string>"
}

{
  "errorCode": "<string>",
  "message": "<string>"
}

Authorizations

X-API-Key · string · header · required

Path Parameters

company_id · string · required

The Specter company id.

Response

200

application/json

Your team's network connections at a specific company.

Your team's network presence at a single company - who you know there, their roles, and which teammates are connected to them.

company_id · string · required

The Specter company id of the queried company.

Example:

"66d926166261234567890123"

contacts · NetworkContact · object[] · required

People in your team's network who currently work at this company.

Show child attributes

roles · string[] · required

Distinct role classifications across all contacts at this company (e.g. engineer, founder). Useful for filtering or summarising the type of relationship the org has at this company.

Example:

["engineer", "founder"]

connected_teammates · string[] · required

Internal Specter user IDs of all teammates who hold at least one connection at this company.

Example:

["user_2opva2jahltnNL8xOK7vArM0IBg"]