Search companies

Search the company pool with filters. Free of charge: only id, size, industry and headquarters are filled — all other fields are returned empty. Use POST /v1/directory/companies/reveal with the returned ids to get the full company data (0.5 credit per company). Results are deterministic (no randomness), so the same filters + page always return the same companies. Disclaimer: a company “uses” a technology when we saw that technology mentioned in at least one of the company’s job offers in the past months, or in the website sources. It signals the company hires for or runs that technology, not a verified install base.

POST

https://ext.gojiberry.ai

directory

companies

Search companies (free preview)

curl --request POST \
  --url https://ext.gojiberry.ai/v1/directory/companies/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "limit": 25,
  "page": 1,
  "companySize": [
    "51-200"
  ],
  "industry": [
    "Software Development"
  ],
  "headquarters": [
    "France"
  ],
  "isHiring": true,
  "isB2b": true,
  "technologiesUsed": [
    "hubspot"
  ]
}
'

import requests

url = "https://ext.gojiberry.ai/v1/directory/companies/search"

payload = {
    "limit": 25,
    "page": 1,
    "companySize": ["51-200"],
    "industry": ["Software Development"],
    "headquarters": ["France"],
    "isHiring": True,
    "isB2b": True,
    "technologiesUsed": ["hubspot"]
}
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({
    limit: 25,
    page: 1,
    companySize: ['51-200'],
    industry: ['Software Development'],
    headquarters: ['France'],
    isHiring: true,
    isB2b: true,
    technologiesUsed: ['hubspot']
  })
};

fetch('https://ext.gojiberry.ai/v1/directory/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://ext.gojiberry.ai/v1/directory/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([
    'limit' => 25,
    'page' => 1,
    'companySize' => [
        '51-200'
    ],
    'industry' => [
        'Software Development'
    ],
    'headquarters' => [
        'France'
    ],
    'isHiring' => true,
    'isB2b' => true,
    'technologiesUsed' => [
        'hubspot'
    ]
  ]),
  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://ext.gojiberry.ai/v1/directory/companies/search"

	payload := strings.NewReader("{\n  \"limit\": 25,\n  \"page\": 1,\n  \"companySize\": [\n    \"51-200\"\n  ],\n  \"industry\": [\n    \"Software Development\"\n  ],\n  \"headquarters\": [\n    \"France\"\n  ],\n  \"isHiring\": true,\n  \"isB2b\": true,\n  \"technologiesUsed\": [\n    \"hubspot\"\n  ]\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://ext.gojiberry.ai/v1/directory/companies/search")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"limit\": 25,\n  \"page\": 1,\n  \"companySize\": [\n    \"51-200\"\n  ],\n  \"industry\": [\n    \"Software Development\"\n  ],\n  \"headquarters\": [\n    \"France\"\n  ],\n  \"isHiring\": true,\n  \"isB2b\": true,\n  \"technologiesUsed\": [\n    \"hubspot\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://ext.gojiberry.ai/v1/directory/companies/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  \"limit\": 25,\n  \"page\": 1,\n  \"companySize\": [\n    \"51-200\"\n  ],\n  \"industry\": [\n    \"Software Development\"\n  ],\n  \"headquarters\": [\n    \"France\"\n  ],\n  \"isHiring\": true,\n  \"isB2b\": true,\n  \"technologiesUsed\": [\n    \"hubspot\"\n  ]\n}"

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

{
  "companies": [
    {}
  ],
  "total": 123,
  "page": 123,
  "limit": 123
}

Authorizations

Authorization

string

header

required

API key from Settings → API. Send it as Authorization: Bearer .

Headers

x-impersonate-user-id

string

ID of an organization member to act on behalf of. The API key user must be the owner of the organization and the target user must belong to the same organization.

Body

application/json

Search filters. At least one filter is required. String-array fields also accept a single string.

limit

number

Number of companies per page (1-100, default 20)

Example:

25

page

number

Page number, starts at 1

Example:

1

companySize

string[]

Company size brackets (e.g. "2-10", "51-200", "10001+")

Example:

["51-200"]

industry

string[]

Industries to prefer

Example:

["Software Development"]

headquarters

string[]

Headquarters locations or countries to match

Example:

["France"]

isHiring

boolean

Only companies with at least one active job posting

isB2b

boolean

true: only B2B companies, false: only B2C companies. Omit to get both.

technologiesUsed

string[]

Technologies the company uses. Disclaimer: a company "uses" a technology when we saw that technology mentioned in at least one of the company's job offers in the past months, or in the website sources. It signals the company hires for or runs that technology, not a verified install base.

Example:

["hubspot"]

Response

Page of masked companies. Empty fields become available after revealing the company.

companies

object[]

total

number

Total number of companies matching the filters, capped at 10 000 (the deepest page reachable anyway)

page

number

limit

number

⌘I

Search companies (free preview)

curl --request POST \
  --url https://ext.gojiberry.ai/v1/directory/companies/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "limit": 25,
  "page": 1,
  "companySize": [
    "51-200"
  ],
  "industry": [
    "Software Development"
  ],
  "headquarters": [
    "France"
  ],
  "isHiring": true,
  "isB2b": true,
  "technologiesUsed": [
    "hubspot"
  ]
}
'

import requests

url = "https://ext.gojiberry.ai/v1/directory/companies/search"

payload = {
    "limit": 25,
    "page": 1,
    "companySize": ["51-200"],
    "industry": ["Software Development"],
    "headquarters": ["France"],
    "isHiring": True,
    "isB2b": True,
    "technologiesUsed": ["hubspot"]
}
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({
    limit: 25,
    page: 1,
    companySize: ['51-200'],
    industry: ['Software Development'],
    headquarters: ['France'],
    isHiring: true,
    isB2b: true,
    technologiesUsed: ['hubspot']
  })
};

fetch('https://ext.gojiberry.ai/v1/directory/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://ext.gojiberry.ai/v1/directory/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([
    'limit' => 25,
    'page' => 1,
    'companySize' => [
        '51-200'
    ],
    'industry' => [
        'Software Development'
    ],
    'headquarters' => [
        'France'
    ],
    'isHiring' => true,
    'isB2b' => true,
    'technologiesUsed' => [
        'hubspot'
    ]
  ]),
  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://ext.gojiberry.ai/v1/directory/companies/search"

	payload := strings.NewReader("{\n  \"limit\": 25,\n  \"page\": 1,\n  \"companySize\": [\n    \"51-200\"\n  ],\n  \"industry\": [\n    \"Software Development\"\n  ],\n  \"headquarters\": [\n    \"France\"\n  ],\n  \"isHiring\": true,\n  \"isB2b\": true,\n  \"technologiesUsed\": [\n    \"hubspot\"\n  ]\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://ext.gojiberry.ai/v1/directory/companies/search")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"limit\": 25,\n  \"page\": 1,\n  \"companySize\": [\n    \"51-200\"\n  ],\n  \"industry\": [\n    \"Software Development\"\n  ],\n  \"headquarters\": [\n    \"France\"\n  ],\n  \"isHiring\": true,\n  \"isB2b\": true,\n  \"technologiesUsed\": [\n    \"hubspot\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://ext.gojiberry.ai/v1/directory/companies/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  \"limit\": 25,\n  \"page\": 1,\n  \"companySize\": [\n    \"51-200\"\n  ],\n  \"industry\": [\n    \"Software Development\"\n  ],\n  \"headquarters\": [\n    \"France\"\n  ],\n  \"isHiring\": true,\n  \"isB2b\": true,\n  \"technologiesUsed\": [\n    \"hubspot\"\n  ]\n}"

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

{
  "companies": [
    {}
  ],
  "total": 123,
  "page": 123,
  "limit": 123
}

Getting Started

API reference

Search companies

Authorizations

Headers

Body

Response