Companies

GET /companies Public

List companies with job counts and denormalized facets; optional filters.

Most active first. Facet params are repeatable and filter by array overlap (OR within a facet, AND across facets), composably with q. meta.total reports the count matching the full filter.

Query parameters

q string
Case-insensitive name substring filter.Example acme
collections string
Curated-collection slug (e.g. yc, bigtech). Repeatable.Example yc
regions string
Region the company hires in. Repeatable.Example eu
countries string
ISO 3166-1 alpha-2 country. Repeatable.Example DE
domains string
Business domain (e.g. fintech). Repeatable.Example fintech
company_type string
Company type (e.g. product, outstaff). Repeatable.Example product
company_size string
Size bucket (e.g. 51-200). Repeatable.Example 51-200
remote_regions string
Job-derived remote-hiring region. Repeatable.Example eu
yc_batch string
YC batch (e.g. W21). Repeatable.Example W21
yc_status string
YC company status. Repeatable.Example active
yc_stage string
YC funding stage. Repeatable.Example series-a
yc_flags string
Curated YC highlight flag. Repeatable.Example hiring
maturity string
Company stage/maturity. Repeatable.Example growth
subindustries string
YC subindustry leaf (see /companies/subindustries). Repeatable.Example payments
limit integer
Page size, 1–100.Example 20
offset integer
Rows to skip.Example 0
curl 
curl "https://freehire.dev/api/v1/companies?q=acme&collections=yc"
json — response 
{
  "data": [
    {
      "slug": "acme",
      "name": "Acme",
      "job_count": 12,
      "collections": ["yc"],
      "regions": ["eu"],
      "countries": ["DE"],
      "domains": ["fintech"],
      "company_types": ["product"],
      "company_sizes": ["51-200"],
      "industries": ["payments"],
      "year_founded": 2015,
      "employee_count": 120,
      "hq_country": "DE",
      "organization_type": "private",
      "tagline": "Payments for builders",
      "company_info": { "...": "..." },
      "remote_regions": ["eu"],
      "yc_batch": ["W21"],
      "yc_status": ["active"],
      "yc_stage": ["series-a"],
      "yc_flags": ["hiring"],
      "maturity": "growth"
    }
  ],
  "meta": { "total": 1, "limit": 20, "offset": 0 }
}