Search companies

curl --request POST \
  --url https://api.agntdata.dev/v1/data/agnt/companies/search \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "filters": {
    "industry": "fintech",
    "headcount": [
      "51-200"
    ]
  },
  "page": 1
}
'

import requests

url = "https://api.agntdata.dev/v1/data/agnt/companies/search"

payload = {
    "filters": {
        "industry": "fintech",
        "headcount": ["51-200"]
    },
    "page": 1
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({filters: {industry: 'fintech', headcount: ['51-200']}, page: 1})
};

fetch('https://api.agntdata.dev/v1/data/agnt/companies/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.agntdata.dev/v1/data/agnt/companies/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([
    'filters' => [
        'industry' => 'fintech',
        'headcount' => [
                '51-200'
        ]
    ],
    'page' => 1
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "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.agntdata.dev/v1/data/agnt/companies/search"

	payload := strings.NewReader("{\n  \"filters\": {\n    \"industry\": \"fintech\",\n    \"headcount\": [\n      \"51-200\"\n    ]\n  },\n  \"page\": 1\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	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.agntdata.dev/v1/data/agnt/companies/search")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"filters\": {\n    \"industry\": \"fintech\",\n    \"headcount\": [\n      \"51-200\"\n    ]\n  },\n  \"page\": 1\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.agntdata.dev/v1/data/agnt/companies/search")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"filters\": {\n    \"industry\": \"fintech\",\n    \"headcount\": [\n      \"51-200\"\n    ]\n  },\n  \"page\": 1\n}"

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

{
  "success": true,
  "data": {},
  "meta": {
    "costCents": 123,
    "purchasedBalanceCents": 123,
    "subscriptionRemainingCents": 123,
    "cached": true,
    "latencyMs": 123,
    "priceRange": {
      "minCents": 123,
      "maxCents": 123
    },
    "budgetCents": 123,
    "budgetCentsPerRecord": 123,
    "providersAttempted": 123,
    "fieldsReturned": [
      "<string>"
    ],
    "fieldsMissing": [
      "<string>"
    ],
    "records": 123
  }
}

POST

data

agnt

companies

Search companies

curl --request POST \
  --url https://api.agntdata.dev/v1/data/agnt/companies/search \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "filters": {
    "industry": "fintech",
    "headcount": [
      "51-200"
    ]
  },
  "page": 1
}
'

import requests

url = "https://api.agntdata.dev/v1/data/agnt/companies/search"

payload = {
    "filters": {
        "industry": "fintech",
        "headcount": ["51-200"]
    },
    "page": 1
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({filters: {industry: 'fintech', headcount: ['51-200']}, page: 1})
};

fetch('https://api.agntdata.dev/v1/data/agnt/companies/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.agntdata.dev/v1/data/agnt/companies/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([
    'filters' => [
        'industry' => 'fintech',
        'headcount' => [
                '51-200'
        ]
    ],
    'page' => 1
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "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.agntdata.dev/v1/data/agnt/companies/search"

	payload := strings.NewReader("{\n  \"filters\": {\n    \"industry\": \"fintech\",\n    \"headcount\": [\n      \"51-200\"\n    ]\n  },\n  \"page\": 1\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	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.agntdata.dev/v1/data/agnt/companies/search")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"filters\": {\n    \"industry\": \"fintech\",\n    \"headcount\": [\n      \"51-200\"\n    ]\n  },\n  \"page\": 1\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.agntdata.dev/v1/data/agnt/companies/search")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"filters\": {\n    \"industry\": \"fintech\",\n    \"headcount\": [\n      \"51-200\"\n    ]\n  },\n  \"page\": 1\n}"

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

{
  "success": true,
  "data": {},
  "meta": {
    "costCents": 123,
    "purchasedBalanceCents": 123,
    "subscriptionRemainingCents": 123,
    "cached": true,
    "latencyMs": 123,
    "priceRange": {
      "minCents": 123,
      "maxCents": 123
    },
    "budgetCents": 123,
    "budgetCentsPerRecord": 123,
    "providersAttempted": 123,
    "fieldsReturned": [
      "<string>"
    ],
    "fieldsMissing": [
      "<string>"
    ],
    "records": 123
  }
}

Authorizations

Authorization

string

header

required

Bearer token. Pass your agntdata API key as: Authorization: Bearer agnt_live_...

Body

application/json

filters

object

Filter object. Each entry is keyed by filter name and takes either { include?: string[], exclude?: string[] } for categorical filters or { min?, max? } for ranges. Searches that contain ONLY exclude filters are rejected — always pair with at least one positive filter. Common keys: company_industry ({ include/exclude } — e.g. { "include": ["Software Development"] }); company_headcount ({ min, max } — numeric employee count range, e.g. { "min": 1000 }); company_country ({ include/exclude } — ISO country names or codes); company_funding ({ stage: string[], funding_date: number-of-days, last_funding: { min, max }, total_funding: { min, max } }; amounts use suffix notation like "1M", "10M", "100M"); company_type ({ include/exclude } — e.g. ["Privately Held", "Public Company"]). For convenience, flat aliases are accepted and translated server-side: industry/industries → company_industry.include, country/countries → company_country.include, headcount_min/headcount_max → company_headcount.{min,max}. Top-level keys other than filters/page (e.g. limit) are ignored. Example: { "company_industry": { "include": ["Software Development"] }, "company_headcount": { "min": 1000 } }.

Show child attributes

page

integer

Page number (25 results per page; max page = 1000).

Required range: x > 0

max_cost_cents

number

Required range: x >= 0

Response

Company search results.

success

enum<boolean>

required

Available options:

true

data

object

required

Overview

agntdata Lead APIs

LinkedIn

YouTube

TikTok

X

Instagram

Reddit

Facebook

Search companies

Authorizations

Body

Response