Company search API

Organization search

curl --request POST \
  --url https://api-v2.forager.ai/api/{account_id}/datastorage/organization_search/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "page": 123,
  "organization_ids": [
    123
  ],
  "description": "<string>",
  "locations": [
    123
  ],
  "industries": [
    123
  ],
  "industries_exclude": [
    123
  ],
  "keywords": [
    123
  ],
  "employees_start": 123,
  "employees_end": 123,
  "founded_date_start": "2023-12-25",
  "founded_date_end": "2023-12-25",
  "revenue_start": 123,
  "revenue_end": 123,
  "domains": [
    "<string>"
  ],
  "domain_rank_start": 123,
  "domain_rank_end": 123,
  "domain_traffic_start": 123,
  "domain_traffic_end": 123,
  "web_technologies": [
    123
  ],
  "linkedin_public_identifiers": [
    "<string>"
  ],
  "funding_types": [],
  "funding_total_start": 123,
  "funding_total_end": 123,
  "funding_event_date_featured_start": "2023-12-25",
  "funding_event_date_featured_end": "2023-12-25",
  "job_post_title": "<string>",
  "job_post_description": "<string>",
  "job_post_is_remote": true,
  "job_post_is_active": true,
  "job_post_date_featured_start": "2023-12-25",
  "job_post_date_featured_end": "2023-12-25",
  "job_post_locations": [
    123
  ],
  "job_post_locations_exclude": [
    123
  ],
  "simple_event_date_featured_start": "2023-12-25",
  "simple_event_date_featured_end": "2023-12-25"
}
'

import requests

url = "https://api-v2.forager.ai/api/{account_id}/datastorage/organization_search/"

payload = {
    "page": 123,
    "organization_ids": [123],
    "description": "<string>",
    "locations": [123],
    "industries": [123],
    "industries_exclude": [123],
    "keywords": [123],
    "employees_start": 123,
    "employees_end": 123,
    "founded_date_start": "2023-12-25",
    "founded_date_end": "2023-12-25",
    "revenue_start": 123,
    "revenue_end": 123,
    "domains": ["<string>"],
    "domain_rank_start": 123,
    "domain_rank_end": 123,
    "domain_traffic_start": 123,
    "domain_traffic_end": 123,
    "web_technologies": [123],
    "linkedin_public_identifiers": ["<string>"],
    "funding_types": [],
    "funding_total_start": 123,
    "funding_total_end": 123,
    "funding_event_date_featured_start": "2023-12-25",
    "funding_event_date_featured_end": "2023-12-25",
    "job_post_title": "<string>",
    "job_post_description": "<string>",
    "job_post_is_remote": True,
    "job_post_is_active": True,
    "job_post_date_featured_start": "2023-12-25",
    "job_post_date_featured_end": "2023-12-25",
    "job_post_locations": [123],
    "job_post_locations_exclude": [123],
    "simple_event_date_featured_start": "2023-12-25",
    "simple_event_date_featured_end": "2023-12-25"
}
headers = {
    "X-API-KEY": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    page: 123,
    organization_ids: [123],
    description: '<string>',
    locations: [123],
    industries: [123],
    industries_exclude: [123],
    keywords: [123],
    employees_start: 123,
    employees_end: 123,
    founded_date_start: '2023-12-25',
    founded_date_end: '2023-12-25',
    revenue_start: 123,
    revenue_end: 123,
    domains: ['<string>'],
    domain_rank_start: 123,
    domain_rank_end: 123,
    domain_traffic_start: 123,
    domain_traffic_end: 123,
    web_technologies: [123],
    linkedin_public_identifiers: ['<string>'],
    funding_types: [],
    funding_total_start: 123,
    funding_total_end: 123,
    funding_event_date_featured_start: '2023-12-25',
    funding_event_date_featured_end: '2023-12-25',
    job_post_title: '<string>',
    job_post_description: '<string>',
    job_post_is_remote: true,
    job_post_is_active: true,
    job_post_date_featured_start: '2023-12-25',
    job_post_date_featured_end: '2023-12-25',
    job_post_locations: [123],
    job_post_locations_exclude: [123],
    simple_event_date_featured_start: '2023-12-25',
    simple_event_date_featured_end: '2023-12-25'
  })
};

fetch('https://api-v2.forager.ai/api/{account_id}/datastorage/organization_search/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

const options = {
  method: 'POST',
  headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    page: 123,
    organization_ids: [123],
    description: '<string>',
    locations: [123],
    industries: [123],
    industries_exclude: [123],
    keywords: [123],
    employees_start: 123,
    employees_end: 123,
    founded_date_start: '2023-12-25',
    founded_date_end: '2023-12-25',
    revenue_start: 123,
    revenue_end: 123,
    domains: ['<string>'],
    domain_rank_start: 123,
    domain_rank_end: 123,
    domain_traffic_start: 123,
    domain_traffic_end: 123,
    web_technologies: [123],
    linkedin_public_identifiers: ['<string>'],
    funding_types: [],
    funding_total_start: 123,
    funding_total_end: 123,
    funding_event_date_featured_start: '2023-12-25',
    funding_event_date_featured_end: '2023-12-25',
    job_post_title: '<string>',
    job_post_description: '<string>',
    job_post_is_remote: true,
    job_post_is_active: true,
    job_post_date_featured_start: '2023-12-25',
    job_post_date_featured_end: '2023-12-25',
    job_post_locations: [123],
    job_post_locations_exclude: [123],
    simple_event_date_featured_start: '2023-12-25',
    simple_event_date_featured_end: '2023-12-25'
  })
};

fetch('https://api-v2.forager.ai/api/{account_id}/datastorage/organization_search/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api-v2.forager.ai/api/{account_id}/datastorage/organization_search/"

	payload := strings.NewReader("{\n  \"page\": 123,\n  \"organization_ids\": [\n    123\n  ],\n  \"description\": \"<string>\",\n  \"locations\": [\n    123\n  ],\n  \"industries\": [\n    123\n  ],\n  \"industries_exclude\": [\n    123\n  ],\n  \"keywords\": [\n    123\n  ],\n  \"employees_start\": 123,\n  \"employees_end\": 123,\n  \"founded_date_start\": \"2023-12-25\",\n  \"founded_date_end\": \"2023-12-25\",\n  \"revenue_start\": 123,\n  \"revenue_end\": 123,\n  \"domains\": [\n    \"<string>\"\n  ],\n  \"domain_rank_start\": 123,\n  \"domain_rank_end\": 123,\n  \"domain_traffic_start\": 123,\n  \"domain_traffic_end\": 123,\n  \"web_technologies\": [\n    123\n  ],\n  \"linkedin_public_identifiers\": [\n    \"<string>\"\n  ],\n  \"funding_types\": [],\n  \"funding_total_start\": 123,\n  \"funding_total_end\": 123,\n  \"funding_event_date_featured_start\": \"2023-12-25\",\n  \"funding_event_date_featured_end\": \"2023-12-25\",\n  \"job_post_title\": \"<string>\",\n  \"job_post_description\": \"<string>\",\n  \"job_post_is_remote\": true,\n  \"job_post_is_active\": true,\n  \"job_post_date_featured_start\": \"2023-12-25\",\n  \"job_post_date_featured_end\": \"2023-12-25\",\n  \"job_post_locations\": [\n    123\n  ],\n  \"job_post_locations_exclude\": [\n    123\n  ],\n  \"simple_event_date_featured_start\": \"2023-12-25\",\n  \"simple_event_date_featured_end\": \"2023-12-25\"\n}")

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

	req.Header.Add("X-API-KEY", "<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))

}

require 'uri'
require 'net/http'

url = URI("https://api-v2.forager.ai/api/{account_id}/datastorage/organization_search/")

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

request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"page\": 123,\n  \"organization_ids\": [\n    123\n  ],\n  \"description\": \"<string>\",\n  \"locations\": [\n    123\n  ],\n  \"industries\": [\n    123\n  ],\n  \"industries_exclude\": [\n    123\n  ],\n  \"keywords\": [\n    123\n  ],\n  \"employees_start\": 123,\n  \"employees_end\": 123,\n  \"founded_date_start\": \"2023-12-25\",\n  \"founded_date_end\": \"2023-12-25\",\n  \"revenue_start\": 123,\n  \"revenue_end\": 123,\n  \"domains\": [\n    \"<string>\"\n  ],\n  \"domain_rank_start\": 123,\n  \"domain_rank_end\": 123,\n  \"domain_traffic_start\": 123,\n  \"domain_traffic_end\": 123,\n  \"web_technologies\": [\n    123\n  ],\n  \"linkedin_public_identifiers\": [\n    \"<string>\"\n  ],\n  \"funding_types\": [],\n  \"funding_total_start\": 123,\n  \"funding_total_end\": 123,\n  \"funding_event_date_featured_start\": \"2023-12-25\",\n  \"funding_event_date_featured_end\": \"2023-12-25\",\n  \"job_post_title\": \"<string>\",\n  \"job_post_description\": \"<string>\",\n  \"job_post_is_remote\": true,\n  \"job_post_is_active\": true,\n  \"job_post_date_featured_start\": \"2023-12-25\",\n  \"job_post_date_featured_end\": \"2023-12-25\",\n  \"job_post_locations\": [\n    123\n  ],\n  \"job_post_locations_exclude\": [\n    123\n  ],\n  \"simple_event_date_featured_start\": \"2023-12-25\",\n  \"simple_event_date_featured_end\": \"2023-12-25\"\n}"

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

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api-v2.forager.ai/api/{account_id}/datastorage/organization_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([
    'page' => 123,
    'organization_ids' => [
        123
    ],
    'description' => '<string>',
    'locations' => [
        123
    ],
    'industries' => [
        123
    ],
    'industries_exclude' => [
        123
    ],
    'keywords' => [
        123
    ],
    'employees_start' => 123,
    'employees_end' => 123,
    'founded_date_start' => '2023-12-25',
    'founded_date_end' => '2023-12-25',
    'revenue_start' => 123,
    'revenue_end' => 123,
    'domains' => [
        '<string>'
    ],
    'domain_rank_start' => 123,
    'domain_rank_end' => 123,
    'domain_traffic_start' => 123,
    'domain_traffic_end' => 123,
    'web_technologies' => [
        123
    ],
    'linkedin_public_identifiers' => [
        '<string>'
    ],
    'funding_types' => [
        
    ],
    'funding_total_start' => 123,
    'funding_total_end' => 123,
    'funding_event_date_featured_start' => '2023-12-25',
    'funding_event_date_featured_end' => '2023-12-25',
    'job_post_title' => '<string>',
    'job_post_description' => '<string>',
    'job_post_is_remote' => true,
    'job_post_is_active' => true,
    'job_post_date_featured_start' => '2023-12-25',
    'job_post_date_featured_end' => '2023-12-25',
    'job_post_locations' => [
        123
    ],
    'job_post_locations_exclude' => [
        123
    ],
    'simple_event_date_featured_start' => '2023-12-25',
    'simple_event_date_featured_end' => '2023-12-25'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "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;
}

HttpResponse<String> response = Unirest.post("https://api-v2.forager.ai/api/{account_id}/datastorage/organization_search/")
  .header("X-API-KEY", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"page\": 123,\n  \"organization_ids\": [\n    123\n  ],\n  \"description\": \"<string>\",\n  \"locations\": [\n    123\n  ],\n  \"industries\": [\n    123\n  ],\n  \"industries_exclude\": [\n    123\n  ],\n  \"keywords\": [\n    123\n  ],\n  \"employees_start\": 123,\n  \"employees_end\": 123,\n  \"founded_date_start\": \"2023-12-25\",\n  \"founded_date_end\": \"2023-12-25\",\n  \"revenue_start\": 123,\n  \"revenue_end\": 123,\n  \"domains\": [\n    \"<string>\"\n  ],\n  \"domain_rank_start\": 123,\n  \"domain_rank_end\": 123,\n  \"domain_traffic_start\": 123,\n  \"domain_traffic_end\": 123,\n  \"web_technologies\": [\n    123\n  ],\n  \"linkedin_public_identifiers\": [\n    \"<string>\"\n  ],\n  \"funding_types\": [],\n  \"funding_total_start\": 123,\n  \"funding_total_end\": 123,\n  \"funding_event_date_featured_start\": \"2023-12-25\",\n  \"funding_event_date_featured_end\": \"2023-12-25\",\n  \"job_post_title\": \"<string>\",\n  \"job_post_description\": \"<string>\",\n  \"job_post_is_remote\": true,\n  \"job_post_is_active\": true,\n  \"job_post_date_featured_start\": \"2023-12-25\",\n  \"job_post_date_featured_end\": \"2023-12-25\",\n  \"job_post_locations\": [\n    123\n  ],\n  \"job_post_locations_exclude\": [\n    123\n  ],\n  \"simple_event_date_featured_start\": \"2023-12-25\",\n  \"simple_event_date_featured_end\": \"2023-12-25\"\n}")
  .asString();

{
  "search_results": [
    {
      "id": 123,
      "name": "<string>",
      "legal_name": "<string>",
      "domain_rank": 123,
      "keywords": [
        {
          "id": 123,
          "name": "<string>"
        }
      ],
      "location": {
        "id": 123,
        "name": "<string>",
        "osm_locations": [
          {
            "id": 123,
            "name": "<string>",
            "place_type": "<string>"
          }
        ]
      },
      "finance_info": {
        "revenue": 4611686018427388000
      },
      "linkedin_info": {
        "industry": {
          "id": 123,
          "name": "<string>"
        },
        "public_profile_url": "<string>",
        "public_identifier": "<string>"
      },
      "addresses": [
        {
          "country": "<string>",
          "summary": "<string>",
          "street_number": "<string>",
          "street_name": "<string>",
          "city": "<string>",
          "state": "<string>",
          "postcode": "<string>"
        }
      ],
      "date_updated": "2023-11-07T05:31:56Z",
      "found_simple_events": [
        {
          "id": 123,
          "source": "product_hunt",
          "date_featured": "2023-12-25",
          "organization_id": 123,
          "reason": "report_released",
          "url": "<string>"
        }
      ],
      "found_funding_events": [
        {
          "id": 123,
          "source": "crunchbase",
          "date_featured": "2023-12-25",
          "organization_id": 123,
          "funding_type": "<string>",
          "funding_total": 4611686018427388000
        }
      ],
      "found_job_post_events": [
        {
          "id": 123,
          "source": "indeed",
          "date_featured": "2023-12-25",
          "organization_id": 123,
          "source_id": "<string>",
          "url": "<string>",
          "title": "<string>",
          "is_remote": true,
          "is_active": true
        }
      ],
      "website": "<string>",
      "domain": "<string>",
      "logo": "<string>",
      "description": "<string>",
      "founded_date": "2023-12-25",
      "operating_status": "<string>",
      "employees_range": "<string>",
      "employees_amount": 1073741823
    }
  ],
  "total_search_results": 1
}

{
  "detail": "Authentication credentials were not provided."
}

POST

https://api-v2.forager.ai

api

{account_id}

datastorage

organization_search

Organization search

curl --request POST \
  --url https://api-v2.forager.ai/api/{account_id}/datastorage/organization_search/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "page": 123,
  "organization_ids": [
    123
  ],
  "description": "<string>",
  "locations": [
    123
  ],
  "industries": [
    123
  ],
  "industries_exclude": [
    123
  ],
  "keywords": [
    123
  ],
  "employees_start": 123,
  "employees_end": 123,
  "founded_date_start": "2023-12-25",
  "founded_date_end": "2023-12-25",
  "revenue_start": 123,
  "revenue_end": 123,
  "domains": [
    "<string>"
  ],
  "domain_rank_start": 123,
  "domain_rank_end": 123,
  "domain_traffic_start": 123,
  "domain_traffic_end": 123,
  "web_technologies": [
    123
  ],
  "linkedin_public_identifiers": [
    "<string>"
  ],
  "funding_types": [],
  "funding_total_start": 123,
  "funding_total_end": 123,
  "funding_event_date_featured_start": "2023-12-25",
  "funding_event_date_featured_end": "2023-12-25",
  "job_post_title": "<string>",
  "job_post_description": "<string>",
  "job_post_is_remote": true,
  "job_post_is_active": true,
  "job_post_date_featured_start": "2023-12-25",
  "job_post_date_featured_end": "2023-12-25",
  "job_post_locations": [
    123
  ],
  "job_post_locations_exclude": [
    123
  ],
  "simple_event_date_featured_start": "2023-12-25",
  "simple_event_date_featured_end": "2023-12-25"
}
'

import requests

url = "https://api-v2.forager.ai/api/{account_id}/datastorage/organization_search/"

payload = {
    "page": 123,
    "organization_ids": [123],
    "description": "<string>",
    "locations": [123],
    "industries": [123],
    "industries_exclude": [123],
    "keywords": [123],
    "employees_start": 123,
    "employees_end": 123,
    "founded_date_start": "2023-12-25",
    "founded_date_end": "2023-12-25",
    "revenue_start": 123,
    "revenue_end": 123,
    "domains": ["<string>"],
    "domain_rank_start": 123,
    "domain_rank_end": 123,
    "domain_traffic_start": 123,
    "domain_traffic_end": 123,
    "web_technologies": [123],
    "linkedin_public_identifiers": ["<string>"],
    "funding_types": [],
    "funding_total_start": 123,
    "funding_total_end": 123,
    "funding_event_date_featured_start": "2023-12-25",
    "funding_event_date_featured_end": "2023-12-25",
    "job_post_title": "<string>",
    "job_post_description": "<string>",
    "job_post_is_remote": True,
    "job_post_is_active": True,
    "job_post_date_featured_start": "2023-12-25",
    "job_post_date_featured_end": "2023-12-25",
    "job_post_locations": [123],
    "job_post_locations_exclude": [123],
    "simple_event_date_featured_start": "2023-12-25",
    "simple_event_date_featured_end": "2023-12-25"
}
headers = {
    "X-API-KEY": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    page: 123,
    organization_ids: [123],
    description: '<string>',
    locations: [123],
    industries: [123],
    industries_exclude: [123],
    keywords: [123],
    employees_start: 123,
    employees_end: 123,
    founded_date_start: '2023-12-25',
    founded_date_end: '2023-12-25',
    revenue_start: 123,
    revenue_end: 123,
    domains: ['<string>'],
    domain_rank_start: 123,
    domain_rank_end: 123,
    domain_traffic_start: 123,
    domain_traffic_end: 123,
    web_technologies: [123],
    linkedin_public_identifiers: ['<string>'],
    funding_types: [],
    funding_total_start: 123,
    funding_total_end: 123,
    funding_event_date_featured_start: '2023-12-25',
    funding_event_date_featured_end: '2023-12-25',
    job_post_title: '<string>',
    job_post_description: '<string>',
    job_post_is_remote: true,
    job_post_is_active: true,
    job_post_date_featured_start: '2023-12-25',
    job_post_date_featured_end: '2023-12-25',
    job_post_locations: [123],
    job_post_locations_exclude: [123],
    simple_event_date_featured_start: '2023-12-25',
    simple_event_date_featured_end: '2023-12-25'
  })
};

fetch('https://api-v2.forager.ai/api/{account_id}/datastorage/organization_search/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

const options = {
  method: 'POST',
  headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    page: 123,
    organization_ids: [123],
    description: '<string>',
    locations: [123],
    industries: [123],
    industries_exclude: [123],
    keywords: [123],
    employees_start: 123,
    employees_end: 123,
    founded_date_start: '2023-12-25',
    founded_date_end: '2023-12-25',
    revenue_start: 123,
    revenue_end: 123,
    domains: ['<string>'],
    domain_rank_start: 123,
    domain_rank_end: 123,
    domain_traffic_start: 123,
    domain_traffic_end: 123,
    web_technologies: [123],
    linkedin_public_identifiers: ['<string>'],
    funding_types: [],
    funding_total_start: 123,
    funding_total_end: 123,
    funding_event_date_featured_start: '2023-12-25',
    funding_event_date_featured_end: '2023-12-25',
    job_post_title: '<string>',
    job_post_description: '<string>',
    job_post_is_remote: true,
    job_post_is_active: true,
    job_post_date_featured_start: '2023-12-25',
    job_post_date_featured_end: '2023-12-25',
    job_post_locations: [123],
    job_post_locations_exclude: [123],
    simple_event_date_featured_start: '2023-12-25',
    simple_event_date_featured_end: '2023-12-25'
  })
};

fetch('https://api-v2.forager.ai/api/{account_id}/datastorage/organization_search/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api-v2.forager.ai/api/{account_id}/datastorage/organization_search/"

	payload := strings.NewReader("{\n  \"page\": 123,\n  \"organization_ids\": [\n    123\n  ],\n  \"description\": \"<string>\",\n  \"locations\": [\n    123\n  ],\n  \"industries\": [\n    123\n  ],\n  \"industries_exclude\": [\n    123\n  ],\n  \"keywords\": [\n    123\n  ],\n  \"employees_start\": 123,\n  \"employees_end\": 123,\n  \"founded_date_start\": \"2023-12-25\",\n  \"founded_date_end\": \"2023-12-25\",\n  \"revenue_start\": 123,\n  \"revenue_end\": 123,\n  \"domains\": [\n    \"<string>\"\n  ],\n  \"domain_rank_start\": 123,\n  \"domain_rank_end\": 123,\n  \"domain_traffic_start\": 123,\n  \"domain_traffic_end\": 123,\n  \"web_technologies\": [\n    123\n  ],\n  \"linkedin_public_identifiers\": [\n    \"<string>\"\n  ],\n  \"funding_types\": [],\n  \"funding_total_start\": 123,\n  \"funding_total_end\": 123,\n  \"funding_event_date_featured_start\": \"2023-12-25\",\n  \"funding_event_date_featured_end\": \"2023-12-25\",\n  \"job_post_title\": \"<string>\",\n  \"job_post_description\": \"<string>\",\n  \"job_post_is_remote\": true,\n  \"job_post_is_active\": true,\n  \"job_post_date_featured_start\": \"2023-12-25\",\n  \"job_post_date_featured_end\": \"2023-12-25\",\n  \"job_post_locations\": [\n    123\n  ],\n  \"job_post_locations_exclude\": [\n    123\n  ],\n  \"simple_event_date_featured_start\": \"2023-12-25\",\n  \"simple_event_date_featured_end\": \"2023-12-25\"\n}")

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

	req.Header.Add("X-API-KEY", "<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))

}

require 'uri'
require 'net/http'

url = URI("https://api-v2.forager.ai/api/{account_id}/datastorage/organization_search/")

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

request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"page\": 123,\n  \"organization_ids\": [\n    123\n  ],\n  \"description\": \"<string>\",\n  \"locations\": [\n    123\n  ],\n  \"industries\": [\n    123\n  ],\n  \"industries_exclude\": [\n    123\n  ],\n  \"keywords\": [\n    123\n  ],\n  \"employees_start\": 123,\n  \"employees_end\": 123,\n  \"founded_date_start\": \"2023-12-25\",\n  \"founded_date_end\": \"2023-12-25\",\n  \"revenue_start\": 123,\n  \"revenue_end\": 123,\n  \"domains\": [\n    \"<string>\"\n  ],\n  \"domain_rank_start\": 123,\n  \"domain_rank_end\": 123,\n  \"domain_traffic_start\": 123,\n  \"domain_traffic_end\": 123,\n  \"web_technologies\": [\n    123\n  ],\n  \"linkedin_public_identifiers\": [\n    \"<string>\"\n  ],\n  \"funding_types\": [],\n  \"funding_total_start\": 123,\n  \"funding_total_end\": 123,\n  \"funding_event_date_featured_start\": \"2023-12-25\",\n  \"funding_event_date_featured_end\": \"2023-12-25\",\n  \"job_post_title\": \"<string>\",\n  \"job_post_description\": \"<string>\",\n  \"job_post_is_remote\": true,\n  \"job_post_is_active\": true,\n  \"job_post_date_featured_start\": \"2023-12-25\",\n  \"job_post_date_featured_end\": \"2023-12-25\",\n  \"job_post_locations\": [\n    123\n  ],\n  \"job_post_locations_exclude\": [\n    123\n  ],\n  \"simple_event_date_featured_start\": \"2023-12-25\",\n  \"simple_event_date_featured_end\": \"2023-12-25\"\n}"

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

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api-v2.forager.ai/api/{account_id}/datastorage/organization_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([
    'page' => 123,
    'organization_ids' => [
        123
    ],
    'description' => '<string>',
    'locations' => [
        123
    ],
    'industries' => [
        123
    ],
    'industries_exclude' => [
        123
    ],
    'keywords' => [
        123
    ],
    'employees_start' => 123,
    'employees_end' => 123,
    'founded_date_start' => '2023-12-25',
    'founded_date_end' => '2023-12-25',
    'revenue_start' => 123,
    'revenue_end' => 123,
    'domains' => [
        '<string>'
    ],
    'domain_rank_start' => 123,
    'domain_rank_end' => 123,
    'domain_traffic_start' => 123,
    'domain_traffic_end' => 123,
    'web_technologies' => [
        123
    ],
    'linkedin_public_identifiers' => [
        '<string>'
    ],
    'funding_types' => [
        
    ],
    'funding_total_start' => 123,
    'funding_total_end' => 123,
    'funding_event_date_featured_start' => '2023-12-25',
    'funding_event_date_featured_end' => '2023-12-25',
    'job_post_title' => '<string>',
    'job_post_description' => '<string>',
    'job_post_is_remote' => true,
    'job_post_is_active' => true,
    'job_post_date_featured_start' => '2023-12-25',
    'job_post_date_featured_end' => '2023-12-25',
    'job_post_locations' => [
        123
    ],
    'job_post_locations_exclude' => [
        123
    ],
    'simple_event_date_featured_start' => '2023-12-25',
    'simple_event_date_featured_end' => '2023-12-25'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "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;
}

HttpResponse<String> response = Unirest.post("https://api-v2.forager.ai/api/{account_id}/datastorage/organization_search/")
  .header("X-API-KEY", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"page\": 123,\n  \"organization_ids\": [\n    123\n  ],\n  \"description\": \"<string>\",\n  \"locations\": [\n    123\n  ],\n  \"industries\": [\n    123\n  ],\n  \"industries_exclude\": [\n    123\n  ],\n  \"keywords\": [\n    123\n  ],\n  \"employees_start\": 123,\n  \"employees_end\": 123,\n  \"founded_date_start\": \"2023-12-25\",\n  \"founded_date_end\": \"2023-12-25\",\n  \"revenue_start\": 123,\n  \"revenue_end\": 123,\n  \"domains\": [\n    \"<string>\"\n  ],\n  \"domain_rank_start\": 123,\n  \"domain_rank_end\": 123,\n  \"domain_traffic_start\": 123,\n  \"domain_traffic_end\": 123,\n  \"web_technologies\": [\n    123\n  ],\n  \"linkedin_public_identifiers\": [\n    \"<string>\"\n  ],\n  \"funding_types\": [],\n  \"funding_total_start\": 123,\n  \"funding_total_end\": 123,\n  \"funding_event_date_featured_start\": \"2023-12-25\",\n  \"funding_event_date_featured_end\": \"2023-12-25\",\n  \"job_post_title\": \"<string>\",\n  \"job_post_description\": \"<string>\",\n  \"job_post_is_remote\": true,\n  \"job_post_is_active\": true,\n  \"job_post_date_featured_start\": \"2023-12-25\",\n  \"job_post_date_featured_end\": \"2023-12-25\",\n  \"job_post_locations\": [\n    123\n  ],\n  \"job_post_locations_exclude\": [\n    123\n  ],\n  \"simple_event_date_featured_start\": \"2023-12-25\",\n  \"simple_event_date_featured_end\": \"2023-12-25\"\n}")
  .asString();

{
  "search_results": [
    {
      "id": 123,
      "name": "<string>",
      "legal_name": "<string>",
      "domain_rank": 123,
      "keywords": [
        {
          "id": 123,
          "name": "<string>"
        }
      ],
      "location": {
        "id": 123,
        "name": "<string>",
        "osm_locations": [
          {
            "id": 123,
            "name": "<string>",
            "place_type": "<string>"
          }
        ]
      },
      "finance_info": {
        "revenue": 4611686018427388000
      },
      "linkedin_info": {
        "industry": {
          "id": 123,
          "name": "<string>"
        },
        "public_profile_url": "<string>",
        "public_identifier": "<string>"
      },
      "addresses": [
        {
          "country": "<string>",
          "summary": "<string>",
          "street_number": "<string>",
          "street_name": "<string>",
          "city": "<string>",
          "state": "<string>",
          "postcode": "<string>"
        }
      ],
      "date_updated": "2023-11-07T05:31:56Z",
      "found_simple_events": [
        {
          "id": 123,
          "source": "product_hunt",
          "date_featured": "2023-12-25",
          "organization_id": 123,
          "reason": "report_released",
          "url": "<string>"
        }
      ],
      "found_funding_events": [
        {
          "id": 123,
          "source": "crunchbase",
          "date_featured": "2023-12-25",
          "organization_id": 123,
          "funding_type": "<string>",
          "funding_total": 4611686018427388000
        }
      ],
      "found_job_post_events": [
        {
          "id": 123,
          "source": "indeed",
          "date_featured": "2023-12-25",
          "organization_id": 123,
          "source_id": "<string>",
          "url": "<string>",
          "title": "<string>",
          "is_remote": true,
          "is_active": true
        }
      ],
      "website": "<string>",
      "domain": "<string>",
      "logo": "<string>",
      "description": "<string>",
      "founded_date": "2023-12-25",
      "operating_status": "<string>",
      "employees_range": "<string>",
      "employees_amount": 1073741823
    }
  ],
  "total_search_results": 1
}

{
  "detail": "Authentication credentials were not provided."
}

When to use this endpoint

You want a list of companies that match criteria: domain, industry, size, revenue, location, technology, funding or hiring activity. Use the id of a result as organization_id in the website lookup, or its domain as a people search filter.

Example request

cURL

curl -X POST "https://api-v2.forager.ai/api/$FORAGER_ACCOUNT_ID/datastorage/organization_search/" \
  -H "X-API-KEY: $FORAGER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "domains": [
    "acme.com"
  ],
  "page": 1
}'

Set FORAGER_API_KEY and FORAGER_ACCOUNT_ID as in the quickstart.

Example response

200 (illustrative values)

{
  "search_results": [
    {
      "id": 90210,
      "name": "Acme Example",
      "legal_name": "Acme Example Inc.",
      "website": "https://acme.com",
      "domain": "acme.com",
      "domain_rank": 48213,
      "logo": null,
      "description": "Example company used in the Forager docs.",
      "founded_date": "2015-06-01",
      "operating_status": "active",
      "employees_range": "51-200",
      "employees_amount": 120,
      "keywords": [
        {
          "id": 311,
          "name": "data infrastructure"
        }
      ],
      "location": {
        "id": 10432,
        "name": "Austin, Texas, United States",
        "osm_locations": [
          {
            "id": 5,
            "name": "Texas",
            "place_type": "state"
          }
        ]
      },
      "finance_info": {
        "revenue": 25000000
      },
      "linkedin_info": {
        "public_identifier": "acme-example",
        "industry": {
          "id": 4,
          "name": "Software Development"
        },
        "public_profile_url": "https://www.linkedin.com/company/acme-example/"
      },
      "addresses": [
        {
          "street_number": "100",
          "street_name": "Main St",
          "city": "Austin",
          "state": "TX",
          "postcode": "78701",
          "country": "United States",
          "summary": "100 Main St, Austin, TX 78701, United States"
        }
      ],
      "date_updated": "2026-10-20T08:15:00Z",
      "found_simple_events": [],
      "found_funding_events": [],
      "found_job_post_events": []
    }
  ],
  "total_search_results": 1
}

Credits

Each request costs 1 credit. See API credits and pricing for how credits are charged and how to check what you spent.

Authorizations

X-API-KEY

string

header

required

Path Parameters

account_id

integer

required

Body

Organization search request serializer.

page

integer

organization_ids

integer[]

To get a list of IDs use Organizations lookup endpoint.

description

string

locations

integer[]

To get a list of IDs use Locations lookup endpoint.

industries

integer[]

To get a list of IDs use Industries lookup endpoint.

industries_exclude

integer[]

To get a list of IDs use Industries lookup endpoint.

keywords

integer[]

To get a list of IDs use Organization keywords lookup endpoint.

employees_start

integer

employees_end

integer

founded_date_start

string<date>

founded_date_end

string<date>

revenue_start

integer

revenue_end

integer

domains

string[]

domain_rank_start

integer

domain_rank_end

integer

domain_traffic_start

integer

domain_traffic_end

integer

web_technologies

integer[]

To get a list of IDs use Web technologies lookup endpoint.

linkedin_public_identifiers

string[]

LinkedIn organization "Public identifier/Slug/ID" - "linkedin.com/company/!slug!/".

funding_types

enum<string>[]

angel - Angel
convertible_note - Convertible Note
corporate_round - Corporate Round
debt_financing - Debt Financing
equity_crowdfunding - Equity Crowdfunding
grant - Grant
initial_coin_offering - Initial coin offering (ICO)
non_equity_assistance - Non-Equity Assistance
post_ipo_debt - Post-IPO Debt
post_ipo_equity - Post-IPO Equity
post_ipo_secondary - Post-IPO Secondary
pre_seed - Pre-Seed
private_equity - Private Equity
product_crowdfunding - Product Crowdfunding
secondary_market - Secondary Market
seed - Seed
series_a - Series A
series_b - Series B
series_c - Series C
series_d - Series D
series_e - Series E
series_f - Series F
series_g - Series G
series_h - Series H
series_i - Series I
series_j - Series J
series_unknown - Venture - Series Unknown
undisclosed - Undisclosed

Available options:

angel,

convertible_note,

corporate_round,

debt_financing,

equity_crowdfunding,

grant,

initial_coin_offering,

non_equity_assistance,

post_ipo_debt,

post_ipo_equity,

post_ipo_secondary,

pre_seed,

private_equity,

product_crowdfunding,

secondary_market,

seed,

series_a,

series_b,

series_c,

series_d,

series_e,

series_f,

series_g,

series_h,

series_i,

series_j,

series_unknown,

undisclosed

funding_total_start

integer

funding_total_end

integer

funding_event_date_featured_start

string<date>

funding_event_date_featured_end

string<date>

job_post_title

string

This field supports a boolean text search query.

job_post_description

string

This field supports a boolean text search query.

job_post_is_remote

boolean | null

job_post_is_active

boolean | null

job_post_date_featured_start

string<date>

job_post_date_featured_end

string<date>

job_post_locations

integer[]

To get a list of IDs use Locations lookup endpoint.

job_post_locations_exclude

integer[]

To get a list of IDs use Locations lookup endpoint.

simple_event_source

enum<string>

product_hunt - Product Hunt
form_c_sec_gov - Form C sec.gov
form_d_sec_gov - Form D sec.gov

Available options:

product_hunt,

form_c_sec_gov,

form_d_sec_gov

simple_event_reason

enum<string>

report_released - Report released
promoted_on_site - Promoted on site

Available options:

report_released,

promoted_on_site

simple_event_date_featured_start

string<date>

simple_event_date_featured_end

string<date>

Response

Organization search response serializer.

search_results

object[]

required

read-only

Hide child attributes

search_results.id

integer

required

read-only

search_results.name

string

required

Maximum string length: 255

search_results.legal_name

string

required

Maximum string length: 255

search_results.domain_rank

integer | null

required

read-only

Domain rank.

search_results.keywords

object[]

required

read-only

Hide child attributes

search_results.keywords.id

integer

required

read-only

search_results.keywords.name

string

required

Maximum string length: 255

search_results.location

object

required

Serializer for the InnerLocation model.

Hide child attributes

search_results.location.id

integer

required

read-only

search_results.location.name

string

required

Maximum string length: 255

search_results.location.osm_locations

object[]

required

read-only

Hide child attributes

search_results.location.osm_locations.id

integer

required

read-only

search_results.location.osm_locations.name

string

required

Maximum string length: 255

search_results.location.osm_locations.place_type

string

required

Maximum string length: 255

search_results.finance_info

object

required

Serializer for the OrganizationFinanceInfo model.

Hide child attributes

search_results.finance_info.revenue

integer<int64> | null

Required range: 0 <= x <= 9223372036854776000

search_results.linkedin_info

object

required

Serializer for the OrganizationLinkedinInfo model.

Hide child attributes

search_results.linkedin_info.industry

object

required

Serializer for the LinkedinIndustry document.

Hide child attributes

search_results.linkedin_info.industry.id

integer

required

read-only

search_results.linkedin_info.industry.name

string

required

Maximum string length: 255

search_results.linkedin_info.public_profile_url

string | null

required

read-only

Get LinkedIn public profile URL.

search_results.linkedin_info.public_identifier

string | null

Maximum string length: 255

search_results.addresses

object[]

required

read-only

Hide child attributes

search_results.addresses.country

string

required

Maximum string length: 255

search_results.addresses.summary

string

required

search_results.addresses.street_number

string | null

Maximum string length: 255

search_results.addresses.street_name

string | null

Maximum string length: 255

search_results.addresses.city

string | null

Maximum string length: 255

search_results.addresses.state

string | null

Maximum string length: 255

search_results.addresses.postcode

string | null

Maximum string length: 64

search_results.date_updated

string<date-time>

required

read-only

search_results.found_simple_events

object[]

required

Events will be available in case any event field would be used for the search. In results will be available 30 most recent matches.

Hide child attributes

search_results.found_simple_events.id

integer

required

read-only

search_results.found_simple_events.source

enum<string>

required

product_hunt - Product Hunt
form_c_sec_gov - Form C sec.gov
form_d_sec_gov - Form D sec.gov

Available options:

product_hunt,

form_c_sec_gov,

form_d_sec_gov

search_results.found_simple_events.date_featured

string<date>

required

search_results.found_simple_events.organization_id

integer

required

read-only

search_results.found_simple_events.reason

enum<string>

required

report_released - Report released
promoted_on_site - Promoted on site

Available options:

report_released,

promoted_on_site

search_results.found_simple_events.url

string<uri>

required

Maximum string length: 255

search_results.found_funding_events

object[]

required

Events will be available in case any event field would be used for the search. In results will be available 30 most recent matches.

Hide child attributes

search_results.found_funding_events.id

integer

required

read-only

search_results.found_funding_events.source

enum<string>

required

crunchbase - Crunchbase

Available options:

crunchbase

search_results.found_funding_events.date_featured

string<date>

required

search_results.found_funding_events.organization_id

integer

required

read-only

search_results.found_funding_events.funding_type

string

required

Maximum string length: 255

search_results.found_funding_events.funding_total

integer<int64>

required

Required range: 0 <= x <= 9223372036854776000

search_results.found_job_post_events

object[]

required

Events will be available in case any event field would be used for the search. In results will be available 30 most recent matches.

Hide child attributes

search_results.found_job_post_events.id

integer

required

read-only

search_results.found_job_post_events.source

enum<string>

required

indeed - Indeed
linkedin - LinkedIn
angellist - AngelList

Available options:

indeed,

linkedin,

angellist

search_results.found_job_post_events.date_featured

string<date>

required

search_results.found_job_post_events.organization_id

integer

required

read-only

search_results.found_job_post_events.source_id

string

required

Maximum string length: 65

search_results.found_job_post_events.url

string<uri>

required

Maximum string length: 510

search_results.found_job_post_events.title

string

required

Maximum string length: 255

search_results.found_job_post_events.is_remote

boolean

required

search_results.found_job_post_events.is_active

boolean

required

search_results.website

string<uri> | null

Maximum string length: 16384

search_results.domain

string<uri> | null

Maximum string length: 200

search_results.logo

string<uri> | null

Maximum string length: 510

search_results.description

string | null

search_results.founded_date

string<date> | null

search_results.operating_status

string | null

Maximum string length: 255

search_results.employees_range

string | null

Maximum string length: 255

search_results.employees_amount

integer | null

Required range: 0 <= x <= 2147483647

total_search_results

integer

required

Required range: x >= 0

Last modified on November 1, 2026

Overview

Endpoints

When to use this endpoint

Example request

Example response

Credits

Authorizations

Path Parameters

Body

Response

​When to use this endpoint

​Example request

​Example response

​Credits

Authorizations

Path Parameters

Body

Response

When to use this endpoint

Example request

Example response

Credits