curl --request POST \
--url https://api.datadingo.com/v1/company/search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"q": "<string>",
"similar_to": "<string>",
"similar_to_many": [
"<string>"
],
"filters": {
"industry": "<string>",
"industry_exclude": "<string>",
"state": "<string>",
"hq_state": "<string>",
"locality": "<string>",
"rdti_active": true,
"ato_total_income_min": 1,
"ato_total_income_max": 1,
"min_abn_confidence": 0.5,
"min_abn_level": "high",
"news_published_after": "<string>",
"news_event_type": "acquisition_merger",
"news_event_after": "<string>",
"llms_txt": "authored",
"ai_training": "opted_out",
"technology": "<string>",
"technology_match": "any",
"technology_category": "Website platform",
"web_reach_level": "none",
"web_reach_trend": "growing",
"keywords": "<string>",
"keywords_exclude": "<string>",
"employee_range": "1"
},
"sort": "relevance",
"limit": 25,
"offset": 0,
"ids_only": true,
"exclude_owned": true,
"tz": "<string>"
}
'import requests
url = "https://api.datadingo.com/v1/company/search"
payload = {
"q": "<string>",
"similar_to": "<string>",
"similar_to_many": ["<string>"],
"filters": {
"industry": "<string>",
"industry_exclude": "<string>",
"state": "<string>",
"hq_state": "<string>",
"locality": "<string>",
"rdti_active": True,
"ato_total_income_min": 1,
"ato_total_income_max": 1,
"min_abn_confidence": 0.5,
"min_abn_level": "high",
"news_published_after": "<string>",
"news_event_type": "acquisition_merger",
"news_event_after": "<string>",
"llms_txt": "authored",
"ai_training": "opted_out",
"technology": "<string>",
"technology_match": "any",
"technology_category": "Website platform",
"web_reach_level": "none",
"web_reach_trend": "growing",
"keywords": "<string>",
"keywords_exclude": "<string>",
"employee_range": "1"
},
"sort": "relevance",
"limit": 25,
"offset": 0,
"ids_only": True,
"exclude_owned": True,
"tz": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
q: '<string>',
similar_to: '<string>',
similar_to_many: ['<string>'],
filters: {
industry: '<string>',
industry_exclude: '<string>',
state: '<string>',
hq_state: '<string>',
locality: '<string>',
rdti_active: true,
ato_total_income_min: 1,
ato_total_income_max: 1,
min_abn_confidence: 0.5,
min_abn_level: 'high',
news_published_after: '<string>',
news_event_type: 'acquisition_merger',
news_event_after: '<string>',
llms_txt: 'authored',
ai_training: 'opted_out',
technology: '<string>',
technology_match: 'any',
technology_category: 'Website platform',
web_reach_level: 'none',
web_reach_trend: 'growing',
keywords: '<string>',
keywords_exclude: '<string>',
employee_range: '1'
},
sort: 'relevance',
limit: 25,
offset: 0,
ids_only: true,
exclude_owned: true,
tz: '<string>'
})
};
fetch('https://api.datadingo.com/v1/company/search', 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.datadingo.com/v1/company/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'q' => '<string>',
'similar_to' => '<string>',
'similar_to_many' => [
'<string>'
],
'filters' => [
'industry' => '<string>',
'industry_exclude' => '<string>',
'state' => '<string>',
'hq_state' => '<string>',
'locality' => '<string>',
'rdti_active' => true,
'ato_total_income_min' => 1,
'ato_total_income_max' => 1,
'min_abn_confidence' => 0.5,
'min_abn_level' => 'high',
'news_published_after' => '<string>',
'news_event_type' => 'acquisition_merger',
'news_event_after' => '<string>',
'llms_txt' => 'authored',
'ai_training' => 'opted_out',
'technology' => '<string>',
'technology_match' => 'any',
'technology_category' => 'Website platform',
'web_reach_level' => 'none',
'web_reach_trend' => 'growing',
'keywords' => '<string>',
'keywords_exclude' => '<string>',
'employee_range' => '1'
],
'sort' => 'relevance',
'limit' => 25,
'offset' => 0,
'ids_only' => true,
'exclude_owned' => true,
'tz' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.datadingo.com/v1/company/search"
payload := strings.NewReader("{\n \"q\": \"<string>\",\n \"similar_to\": \"<string>\",\n \"similar_to_many\": [\n \"<string>\"\n ],\n \"filters\": {\n \"industry\": \"<string>\",\n \"industry_exclude\": \"<string>\",\n \"state\": \"<string>\",\n \"hq_state\": \"<string>\",\n \"locality\": \"<string>\",\n \"rdti_active\": true,\n \"ato_total_income_min\": 1,\n \"ato_total_income_max\": 1,\n \"min_abn_confidence\": 0.5,\n \"min_abn_level\": \"high\",\n \"news_published_after\": \"<string>\",\n \"news_event_type\": \"acquisition_merger\",\n \"news_event_after\": \"<string>\",\n \"llms_txt\": \"authored\",\n \"ai_training\": \"opted_out\",\n \"technology\": \"<string>\",\n \"technology_match\": \"any\",\n \"technology_category\": \"Website platform\",\n \"web_reach_level\": \"none\",\n \"web_reach_trend\": \"growing\",\n \"keywords\": \"<string>\",\n \"keywords_exclude\": \"<string>\",\n \"employee_range\": \"1\"\n },\n \"sort\": \"relevance\",\n \"limit\": 25,\n \"offset\": 0,\n \"ids_only\": true,\n \"exclude_owned\": true,\n \"tz\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.datadingo.com/v1/company/search")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"q\": \"<string>\",\n \"similar_to\": \"<string>\",\n \"similar_to_many\": [\n \"<string>\"\n ],\n \"filters\": {\n \"industry\": \"<string>\",\n \"industry_exclude\": \"<string>\",\n \"state\": \"<string>\",\n \"hq_state\": \"<string>\",\n \"locality\": \"<string>\",\n \"rdti_active\": true,\n \"ato_total_income_min\": 1,\n \"ato_total_income_max\": 1,\n \"min_abn_confidence\": 0.5,\n \"min_abn_level\": \"high\",\n \"news_published_after\": \"<string>\",\n \"news_event_type\": \"acquisition_merger\",\n \"news_event_after\": \"<string>\",\n \"llms_txt\": \"authored\",\n \"ai_training\": \"opted_out\",\n \"technology\": \"<string>\",\n \"technology_match\": \"any\",\n \"technology_category\": \"Website platform\",\n \"web_reach_level\": \"none\",\n \"web_reach_trend\": \"growing\",\n \"keywords\": \"<string>\",\n \"keywords_exclude\": \"<string>\",\n \"employee_range\": \"1\"\n },\n \"sort\": \"relevance\",\n \"limit\": 25,\n \"offset\": 0,\n \"ids_only\": true,\n \"exclude_owned\": true,\n \"tz\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.datadingo.com/v1/company/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"q\": \"<string>\",\n \"similar_to\": \"<string>\",\n \"similar_to_many\": [\n \"<string>\"\n ],\n \"filters\": {\n \"industry\": \"<string>\",\n \"industry_exclude\": \"<string>\",\n \"state\": \"<string>\",\n \"hq_state\": \"<string>\",\n \"locality\": \"<string>\",\n \"rdti_active\": true,\n \"ato_total_income_min\": 1,\n \"ato_total_income_max\": 1,\n \"min_abn_confidence\": 0.5,\n \"min_abn_level\": \"high\",\n \"news_published_after\": \"<string>\",\n \"news_event_type\": \"acquisition_merger\",\n \"news_event_after\": \"<string>\",\n \"llms_txt\": \"authored\",\n \"ai_training\": \"opted_out\",\n \"technology\": \"<string>\",\n \"technology_match\": \"any\",\n \"technology_category\": \"Website platform\",\n \"web_reach_level\": \"none\",\n \"web_reach_trend\": \"growing\",\n \"keywords\": \"<string>\",\n \"keywords_exclude\": \"<string>\",\n \"employee_range\": \"1\"\n },\n \"sort\": \"relevance\",\n \"limit\": 25,\n \"offset\": 0,\n \"ids_only\": true,\n \"exclude_owned\": true,\n \"tz\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"total": 123,
"total_is_capped": true,
"already_yours": 1,
"results": [
{
"score": 123,
"company": {
"id": "<string>",
"name": "<string>",
"website": "<string>",
"summary": "<string>",
"industry": "<string>",
"hq_location": "<string>",
"hq_state": "NSW",
"states": [
"<string>"
],
"employee_range": "<string>",
"matched_office": {
"locality": "<string>",
"state": "<string>",
"postcode": "<string>"
}
}
}
],
"interpreted": {
"sort": "relevance",
"locality": "<string>",
"industry": {
"included": [
"<string>"
],
"excluded": [
"<string>"
]
}
},
"seeds_missing": [
"<string>"
]
}{
"error": 123,
"message": "<string>"
}{
"error": 123,
"message": "<string>"
}{
"error": 123,
"code": "plan_required",
"message": "<string>",
"subscribe_url": "<string>"
}{
"error": 123,
"message": "<string>"
}{
"error": 123,
"message": "<string>",
"limit": 123,
"remaining": 123,
"resets_at": "2023-11-07T05:31:56Z"
}Company search: exact filters, one fixed sort
Custom endpoint (ADR-0018). Exact filters, then one sort: relevance (fit to free text q, likeness to similar_to or to a seed list similar_to_many, 1–10 domains) or a stored-field sort over every filtered company (best_known, largest). Needs at least one filter, or q / a seed. limit: 0 counts only; ids_only: true answers the page’s ids instead of cards. Results are short cards, one per company record (website); call GET /v1/company?id= for the full card. Each user may receive 5,000 search cards a UTC day (counts and ids-only searches are not counted); past that a card search is a 429.
curl --request POST \
--url https://api.datadingo.com/v1/company/search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"q": "<string>",
"similar_to": "<string>",
"similar_to_many": [
"<string>"
],
"filters": {
"industry": "<string>",
"industry_exclude": "<string>",
"state": "<string>",
"hq_state": "<string>",
"locality": "<string>",
"rdti_active": true,
"ato_total_income_min": 1,
"ato_total_income_max": 1,
"min_abn_confidence": 0.5,
"min_abn_level": "high",
"news_published_after": "<string>",
"news_event_type": "acquisition_merger",
"news_event_after": "<string>",
"llms_txt": "authored",
"ai_training": "opted_out",
"technology": "<string>",
"technology_match": "any",
"technology_category": "Website platform",
"web_reach_level": "none",
"web_reach_trend": "growing",
"keywords": "<string>",
"keywords_exclude": "<string>",
"employee_range": "1"
},
"sort": "relevance",
"limit": 25,
"offset": 0,
"ids_only": true,
"exclude_owned": true,
"tz": "<string>"
}
'import requests
url = "https://api.datadingo.com/v1/company/search"
payload = {
"q": "<string>",
"similar_to": "<string>",
"similar_to_many": ["<string>"],
"filters": {
"industry": "<string>",
"industry_exclude": "<string>",
"state": "<string>",
"hq_state": "<string>",
"locality": "<string>",
"rdti_active": True,
"ato_total_income_min": 1,
"ato_total_income_max": 1,
"min_abn_confidence": 0.5,
"min_abn_level": "high",
"news_published_after": "<string>",
"news_event_type": "acquisition_merger",
"news_event_after": "<string>",
"llms_txt": "authored",
"ai_training": "opted_out",
"technology": "<string>",
"technology_match": "any",
"technology_category": "Website platform",
"web_reach_level": "none",
"web_reach_trend": "growing",
"keywords": "<string>",
"keywords_exclude": "<string>",
"employee_range": "1"
},
"sort": "relevance",
"limit": 25,
"offset": 0,
"ids_only": True,
"exclude_owned": True,
"tz": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
q: '<string>',
similar_to: '<string>',
similar_to_many: ['<string>'],
filters: {
industry: '<string>',
industry_exclude: '<string>',
state: '<string>',
hq_state: '<string>',
locality: '<string>',
rdti_active: true,
ato_total_income_min: 1,
ato_total_income_max: 1,
min_abn_confidence: 0.5,
min_abn_level: 'high',
news_published_after: '<string>',
news_event_type: 'acquisition_merger',
news_event_after: '<string>',
llms_txt: 'authored',
ai_training: 'opted_out',
technology: '<string>',
technology_match: 'any',
technology_category: 'Website platform',
web_reach_level: 'none',
web_reach_trend: 'growing',
keywords: '<string>',
keywords_exclude: '<string>',
employee_range: '1'
},
sort: 'relevance',
limit: 25,
offset: 0,
ids_only: true,
exclude_owned: true,
tz: '<string>'
})
};
fetch('https://api.datadingo.com/v1/company/search', 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.datadingo.com/v1/company/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'q' => '<string>',
'similar_to' => '<string>',
'similar_to_many' => [
'<string>'
],
'filters' => [
'industry' => '<string>',
'industry_exclude' => '<string>',
'state' => '<string>',
'hq_state' => '<string>',
'locality' => '<string>',
'rdti_active' => true,
'ato_total_income_min' => 1,
'ato_total_income_max' => 1,
'min_abn_confidence' => 0.5,
'min_abn_level' => 'high',
'news_published_after' => '<string>',
'news_event_type' => 'acquisition_merger',
'news_event_after' => '<string>',
'llms_txt' => 'authored',
'ai_training' => 'opted_out',
'technology' => '<string>',
'technology_match' => 'any',
'technology_category' => 'Website platform',
'web_reach_level' => 'none',
'web_reach_trend' => 'growing',
'keywords' => '<string>',
'keywords_exclude' => '<string>',
'employee_range' => '1'
],
'sort' => 'relevance',
'limit' => 25,
'offset' => 0,
'ids_only' => true,
'exclude_owned' => true,
'tz' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.datadingo.com/v1/company/search"
payload := strings.NewReader("{\n \"q\": \"<string>\",\n \"similar_to\": \"<string>\",\n \"similar_to_many\": [\n \"<string>\"\n ],\n \"filters\": {\n \"industry\": \"<string>\",\n \"industry_exclude\": \"<string>\",\n \"state\": \"<string>\",\n \"hq_state\": \"<string>\",\n \"locality\": \"<string>\",\n \"rdti_active\": true,\n \"ato_total_income_min\": 1,\n \"ato_total_income_max\": 1,\n \"min_abn_confidence\": 0.5,\n \"min_abn_level\": \"high\",\n \"news_published_after\": \"<string>\",\n \"news_event_type\": \"acquisition_merger\",\n \"news_event_after\": \"<string>\",\n \"llms_txt\": \"authored\",\n \"ai_training\": \"opted_out\",\n \"technology\": \"<string>\",\n \"technology_match\": \"any\",\n \"technology_category\": \"Website platform\",\n \"web_reach_level\": \"none\",\n \"web_reach_trend\": \"growing\",\n \"keywords\": \"<string>\",\n \"keywords_exclude\": \"<string>\",\n \"employee_range\": \"1\"\n },\n \"sort\": \"relevance\",\n \"limit\": 25,\n \"offset\": 0,\n \"ids_only\": true,\n \"exclude_owned\": true,\n \"tz\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.datadingo.com/v1/company/search")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"q\": \"<string>\",\n \"similar_to\": \"<string>\",\n \"similar_to_many\": [\n \"<string>\"\n ],\n \"filters\": {\n \"industry\": \"<string>\",\n \"industry_exclude\": \"<string>\",\n \"state\": \"<string>\",\n \"hq_state\": \"<string>\",\n \"locality\": \"<string>\",\n \"rdti_active\": true,\n \"ato_total_income_min\": 1,\n \"ato_total_income_max\": 1,\n \"min_abn_confidence\": 0.5,\n \"min_abn_level\": \"high\",\n \"news_published_after\": \"<string>\",\n \"news_event_type\": \"acquisition_merger\",\n \"news_event_after\": \"<string>\",\n \"llms_txt\": \"authored\",\n \"ai_training\": \"opted_out\",\n \"technology\": \"<string>\",\n \"technology_match\": \"any\",\n \"technology_category\": \"Website platform\",\n \"web_reach_level\": \"none\",\n \"web_reach_trend\": \"growing\",\n \"keywords\": \"<string>\",\n \"keywords_exclude\": \"<string>\",\n \"employee_range\": \"1\"\n },\n \"sort\": \"relevance\",\n \"limit\": 25,\n \"offset\": 0,\n \"ids_only\": true,\n \"exclude_owned\": true,\n \"tz\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.datadingo.com/v1/company/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"q\": \"<string>\",\n \"similar_to\": \"<string>\",\n \"similar_to_many\": [\n \"<string>\"\n ],\n \"filters\": {\n \"industry\": \"<string>\",\n \"industry_exclude\": \"<string>\",\n \"state\": \"<string>\",\n \"hq_state\": \"<string>\",\n \"locality\": \"<string>\",\n \"rdti_active\": true,\n \"ato_total_income_min\": 1,\n \"ato_total_income_max\": 1,\n \"min_abn_confidence\": 0.5,\n \"min_abn_level\": \"high\",\n \"news_published_after\": \"<string>\",\n \"news_event_type\": \"acquisition_merger\",\n \"news_event_after\": \"<string>\",\n \"llms_txt\": \"authored\",\n \"ai_training\": \"opted_out\",\n \"technology\": \"<string>\",\n \"technology_match\": \"any\",\n \"technology_category\": \"Website platform\",\n \"web_reach_level\": \"none\",\n \"web_reach_trend\": \"growing\",\n \"keywords\": \"<string>\",\n \"keywords_exclude\": \"<string>\",\n \"employee_range\": \"1\"\n },\n \"sort\": \"relevance\",\n \"limit\": 25,\n \"offset\": 0,\n \"ids_only\": true,\n \"exclude_owned\": true,\n \"tz\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"total": 123,
"total_is_capped": true,
"already_yours": 1,
"results": [
{
"score": 123,
"company": {
"id": "<string>",
"name": "<string>",
"website": "<string>",
"summary": "<string>",
"industry": "<string>",
"hq_location": "<string>",
"hq_state": "NSW",
"states": [
"<string>"
],
"employee_range": "<string>",
"matched_office": {
"locality": "<string>",
"state": "<string>",
"postcode": "<string>"
}
}
}
],
"interpreted": {
"sort": "relevance",
"locality": "<string>",
"industry": {
"included": [
"<string>"
],
"excluded": [
"<string>"
]
}
},
"seeds_missing": [
"<string>"
]
}{
"error": 123,
"message": "<string>"
}{
"error": 123,
"message": "<string>"
}{
"error": 123,
"code": "plan_required",
"message": "<string>",
"subscribe_url": "<string>"
}{
"error": 123,
"message": "<string>"
}{
"error": 123,
"message": "<string>",
"limit": 123,
"remaining": 123,
"resets_at": "2023-11-07T05:31:56Z"
}Authorizations
Body
Needs at least one filter, or q, similar_to or similar_to_many (enforced in the handler — JSON Schema can't express it cleanly with optional fields). Results are one row per company record (website): two websites that share an ABN are two results.
Needs at least one filter, or q, similar_to or similar_to_many (enforced in the handler — JSON Schema can't express it cleanly with optional fields). Results are one row per company record (website): two websites that share an ABN are two results.
Free text that ORDERS the results by fit (sort: relevance): its meaning matched against each company's description, fused with a word match on names and specialties that needs EVERY word of q (small words like "the" ignored), so keep q to the few words that describe the company ("commercial cleaning", not "companies that do commercial cleaning in Sydney"). It only ranks; it never filters, and nothing is read out of it. Put places in filters.state / filters.locality, a kind of company with no industry label in filters.keywords, and use lookup_by_name for one specific company. Each of its two rankings reaches only its top 600 (about 1,200 together), so it gives the best fits first, not all of them; leave it out when the filters already say what kind of company.
1 - 1000Lookalikes of a list of companies: 1–10 registrable domains of seed companies (e.g. a customer list). Returns companies like the seeds as a group; the seeds themselves are never in results. A seed with no embedding is listed in the response's seeds_missing instead of failing the search — 404 only when no seed has one. Use either similar_to or similar_to_many, not both.
1 - 10 elements1 - 255The order of the results, one of a fixed list. relevance: fit to q or likeness to the seed(s) — the default when q, similar_to or similar_to_many is set, and a 400 without one. best_known: the best-known companies first — the default for a filters-only search. largest: biggest LinkedIn size band first, no band last, then best known within a band. best_known and largest with q or a seed is a 400: put the kind of company into filters instead. The sort applied is echoed in interpreted.sort.
relevance Response
Default Response
- Option 1
- Option 2
Search results in sort order.
total is how many companies pass every applied filter (seeds excluded): the pool, not the page. Counting stops at 10,000 (total_is_capped: true = at least that many). Under relevance the pool is companies with a description vector plus word matches, and only roughly the top 1,200 can be paged with q (600 for one seed alone): an empty page is the end of what you can reach, not of the pool, and paging can drift slightly. Under best_known / largest the pool is every company passing the filters, pageable to offset 10,000 with no repeats or skips. So total can differ with and without q; narrow with filters rather than paging deep.