Ocean of Jobs
REST APIReferenceCompanies

Search companies by domain or name

GET
/companies/search

Minimum 2 characters required. Accepts any /api/jobs filter to count open jobs per company under specific conditions.

curl "https://oceanofjobs.com/api/companies/search?name=acme&country=US"

Query Parameters

name*string

Search string (required).

Length2 <= length
country?string

Two-letter country code (e.g., US or US,GB). Uses normalized location data.

city?string

City names (e.g., New York,London).

location?string

Raw location text provided by the employer.

company?string

Company domain names (e.g., example.com,example.org).

ats?string

Applicant tracking system names (e.g., greenhouse,lever).

department?string

Normalized job categories (e.g., Security, Infrastructure). Fetch valid values via /api/facets.

seniority?string

intern, junior, mid, senior, staff, principal, lead, manager, director, exec.

workplace?string

remote, hybrid, onsite.

skills?string

Comma-separated skill names (e.g., Python,Kubernetes). Filters jobs matching at least one skill and sets sort=match.

ids?string

Fetch specific job IDs in a single request.

israel_only?string

Set to 1 to restrict to Israeli locations (Equivalent to country=IL).

confidence?string

verified (default, confirmed on employer site), best_effort, or all.

Default"verified"
Value in"verified""best_effort""all"
include_closed?string

Set to 1 to include roles closed within the last 30 days.

include_outdated?string

Set to 1 to include open postings older than 1 year (hidden by default).

min_age_days?integer

Filter listings by age in days.

Range0 <= value
max_age_days?integer

Filter listings by age in days.

Range0 <= value
salary_min?integer

Lowest monthly gross salary in shekels. Keeps listings with no shekel figure unless salary_known=1.

Range0 <= value
salary_max?integer

Highest monthly gross salary in shekels. Same rule as salary_min.

Range0 <= value
salary_known?"1"

1 for only listings with a shekel salary figure.

Value in"1"
salary_disclosed?"1"

1 for only listings whose employer stated the salary, in any currency.

Value in"1"

Response Body

Success.

application/json
  1. response
companies?array<>
Example Request
curl -X GET 'https://oceanofjobs.com/api/companies/search?name=acme'
Example Response
{  "companies": [    {}  ]}