curl --request GET \
--url https://app.tryspecter.com/api/v1/companies/{companyId}/latest-valuation \
--header 'X-API-Key: <api-key>'import requests
url = "https://app.tryspecter.com/api/v1/companies/{companyId}/latest-valuation"
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/companies/{companyId}/latest-valuation', 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/companies/{companyId}/latest-valuation",
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/companies/{companyId}/latest-valuation"
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/companies/{companyId}/latest-valuation")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.tryspecter.com/api/v1/companies/{companyId}/latest-valuation")
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{
"id": "5e3a8fc7040ca7b0c6f35b14",
"company_name": "Best Apps Market",
"domain": "bestappsmarket.com",
"est_valuation_usd": 10000000,
"latest_valuation_reported_usd": 10000000,
"latest_valuation_reported_date": "2011-05-10",
"est_valuation_growth_1m_pct": 4.05,
"est_valuation_growth_3m_pct": 11.59,
"est_valuation_growth_6m_pct": 18.46,
"est_valuation_growth_1y_pct": 43.55,
"est_valuation_growth_2y_pct": 50
}{
"errorCode": "API_KEY_MISSING",
"message": "No API Key was presented on the header X-API-KEY"
}{
"errorCode": "OUT_OF_CREDITS",
"message": "There are no more credits available to complete the request"
}{
"errorCode": "NOT_PERMITTED",
"message": "API key present, but you are not permitted"
}{
"errorCode": "NOT_FOUND",
"message": "Not Found"
}{
"errorCode": "VALIDATION_ERROR",
"message": "Field required (body.name)"
}{
"errorCode": "RATE_LIMITED",
"message": "You have been rate-limited"
}{
"errorCode": "clerk_unavailable",
"message": "Key verification is temporarily unavailable"
}Get company latest valuation
Returns the latest valuation figures and estimated valuation growth for a single company.
Costs 1 credit per matched result.
What you need
A Specter companyId in the path. If you only have a domain, website, or name, get
the ID first with Find company ID
(batch, free), or find it by name with Search entities by
name.
Behaviour
- Growth fields are percentages (
4.05= +4.05%) and can be negative. - Valuation figures are post-money.
- A matched company with no valuation data on file returns
200with every valuation field set tonull. - Returns
404if no company matchescompanyId.
What you do next
- Get revenue too. Pull the latest revenue with Get company latest revenue.
- See the raises behind it. Pull the funding history with Get company funding rounds.
curl --request GET \
--url https://app.tryspecter.com/api/v1/companies/{companyId}/latest-valuation \
--header 'X-API-Key: <api-key>'import requests
url = "https://app.tryspecter.com/api/v1/companies/{companyId}/latest-valuation"
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/companies/{companyId}/latest-valuation', 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/companies/{companyId}/latest-valuation",
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/companies/{companyId}/latest-valuation"
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/companies/{companyId}/latest-valuation")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.tryspecter.com/api/v1/companies/{companyId}/latest-valuation")
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{
"id": "5e3a8fc7040ca7b0c6f35b14",
"company_name": "Best Apps Market",
"domain": "bestappsmarket.com",
"est_valuation_usd": 10000000,
"latest_valuation_reported_usd": 10000000,
"latest_valuation_reported_date": "2011-05-10",
"est_valuation_growth_1m_pct": 4.05,
"est_valuation_growth_3m_pct": 11.59,
"est_valuation_growth_6m_pct": 18.46,
"est_valuation_growth_1y_pct": 43.55,
"est_valuation_growth_2y_pct": 50
}{
"errorCode": "API_KEY_MISSING",
"message": "No API Key was presented on the header X-API-KEY"
}{
"errorCode": "OUT_OF_CREDITS",
"message": "There are no more credits available to complete the request"
}{
"errorCode": "NOT_PERMITTED",
"message": "API key present, but you are not permitted"
}{
"errorCode": "NOT_FOUND",
"message": "Not Found"
}{
"errorCode": "VALIDATION_ERROR",
"message": "Field required (body.name)"
}{
"errorCode": "RATE_LIMITED",
"message": "You have been rate-limited"
}{
"errorCode": "clerk_unavailable",
"message": "Key verification is temporarily unavailable"
}Authorizations
Path Parameters
The Specter company ID.
Response
The valuation figures for the matched company.
Latest valuation figures and estimated valuation growth for a single
company. Every valuation field is null when the company is found but has no
valuation data on file. Growth values are percentages (e.g. 4.05 = +4.05%) and can
be negative.
The Specter company ID of the matched company.
"5e3a8fc7040ca7b0c6f35b14"
The name of the matched company.
"Best Apps Market"
The domain of the matched company.
"bestappsmarket.com"
Latest estimated post-money valuation, in USD.
10000000
Latest reported post-money valuation, in USD.
10000000
Date (YYYY-MM-DD) of the latest reported post-money valuation.
"2011-05-10"
1-month growth in estimated post-money valuation, as a percentage.
4.05
3-month growth in estimated post-money valuation, as a percentage.
11.59
6-month growth in estimated post-money valuation, as a percentage.
18.46
1-year growth in estimated post-money valuation, as a percentage.
43.55
2-year growth in estimated post-money valuation, as a percentage.
50
Was this page helpful?