# freehire

> Search open tech jobs with freehire, the open-source job search engine that gathers postings from companies' own career pages. Find jobs by keywords, location, remote work, seniority, skills, salary and visa sponsorship; count the market by any of them; look up companies; and start a workflow when a new job matches a search. No account or API key required.

App · 6 actions. Web page: https://docs.lodol.com/docs/integrations/freehire

## Actions

### Count jobs

Count the open jobs that match a search, broken down by seniority, work mode, role, skills, country and more, with the most common values first. Takes the same filters as 'Search jobs'. Useful for questions like how many remote Rust jobs there are in Europe, and at what level.

**Inputs**

- Keywords (`keywords`, text): Words to look for in the title, company, description and location, such as "python developer". Put "-" before a word to leave out jobs with it. Leave empty for every job.
- Match keywords in the title only (`title_only`, true/false): On: the keywords must be in the job title. Off: they can be anywhere in the posting. Default: `false`.
- Locations (`locations`, list): Regions, countries or cities. A job in any of them matches. Leave empty for anywhere.
- Work mode (`work_modes`, text): Remote, hybrid or on-site. Leave empty for all, including jobs that don't say. One or more of: `remote`, `hybrid`, `onsite` (On-site).
- Seniority (`seniority`, text): The levels to include. Many postings don't state one, and those are left out once a level is chosen. One or more of: `intern`, `junior`, `middle` (Mid-level), `senior`, `lead`, `staff`, `principal`, `c_level` (Executive (C-level)).
- Skills (`skills`, list): Skills the job asks for, such as python or kubernetes. A job with any of them matches, unless 'Must have every skill' is on.
- Must have every skill (`require_all_skills`, true/false): On: only jobs that ask for every skill chosen. Default: `false`.
- Role category (`categories`, list): The kinds of role, such as Backend or Data science.
- Employment type (`employment_types`, text): Full-time, part-time, contract and so on. Leave empty for all. One or more of: `full_time` (Full-time), `part_time` (Part-time), `contract`, `internship`, `fellowship`.
- Companies (`companies`, list): Only jobs at these companies. The list offers well-known tech employers; for any other, type its id from 'Search companies'.
- Company lists (`company_lists`, list): Only companies on these lists, such as Y Combinator or US H-1B visa sponsors.
- Listed in the last (days) (`listed_within_days`, number): Only jobs freehire found this many days ago or less. Reposted ads don't count as new. Leave empty for any age. From 1 to 3650.
- Only jobs that sponsor a visa (`visa_sponsorship`, true/false): On: only jobs whose posting says it sponsors a visa. Default: `false`.
- Minimum salary (`min_salary`, number): Only jobs whose stated pay starts at this or more. Jobs that state no pay are left out. Pay isn't converted between currencies, so choose a salary currency and period too. At least 0.
- Salary currency (`salary_currency`, text): Only jobs that state their pay in this currency.
- Salary period (`salary_period`, text): Only jobs that state their pay per year, month, day or hour. One of: `year` (A year), `month` (A month), `day` (A day), `hour` (An hour).
- Only fresh listings (`fresh_only`, true/false): On: leave out jobs that have been open for a long time and ads that are always open. A large share of listings are old, so this is the quickest way to see current openings. Default: `false`.
- Break down by (`breakdown_by`, text): The fields to split the count by. Defaults to seniority, work mode and role category. One or more of: `seniority`, `work_mode` (Work mode), `category` (Role category), `skills`, `regions`, `countries`, `cities`, `employment_type` (Employment type), `company_type` (Company type), `company_size` (Company size), and 5 more.
- Values per breakdown (`top_values`, number): How many of the most common values to list for each field, from 1 to 100. Defaults to 10. From 1 to 100. Default: `10`.

**Outputs**

- `breakdowns` (list): One breakdown per field asked for.
- `experience_range` (object): The lowest and highest figure among the matching jobs.
- `salary_range` (object): The lowest and highest figure among the matching jobs.
- `total` (number): How many open jobs match.

**Example output**

```json
{
  "breakdowns": [
    {
      "field": "seniority",
      "label": "Seniority",
      "other_values": 5,
      "values": [
        {
          "jobs": 586,
          "label": "Senior",
          "value": "senior"
        },
        {
          "jobs": 99,
          "label": "Junior",
          "value": "junior"
        },
        {
          "jobs": 88,
          "label": "Intern",
          "value": "intern"
        }
      ]
    }
  ],
  "experience_range": {
    "max": 15,
    "min": 0
  },
  "salary_range": {
    "max": 450000,
    "min": 0
  },
  "total": 3433
}
```

### Find similar jobs

Find open jobs most like a given one, most alike first. Sometimes returns fewer than asked for, or none.

**Inputs**

- Job (`job_id`, text, required): The job's id from 'Search jobs', or its freehire link (https://freehire.me/jobs/...).
- Number of jobs (`limit`, number): How many to return, from 1 to 20. Defaults to 6. From 1 to 20. Default: `6`.

**Outputs**

- `count` (number): How many jobs this step returned.
- `jobs` (list): The jobs found.

**Example output**

```json
{
  "count": 1,
  "jobs": [
    {
      "apply_url": "https://jobs.ashbyhq.com/scribe/28031cc3-1043-47ee-b856-4732c6fb04cb?utm_source=freehire.me",
      "category": "Backend",
      "cities": [],
      "closed_at": null,
      "company": "scribe.com",
      "company_id": "scribe-com",
      "countries": [
        "United States"
      ],
      "country_codes": [
        "us"
      ],
      "days_listed": 14,
      "description": "About Scribe\n\nScribe is where exceptional people come to do the best work of their careers.",
      "employment_type": "Full-time",
      "experience_years": 5,
      "first_seen_at": "2026-10-05T21:27:55Z",
      "freehire_url": "https://freehire.me/jobs/senior-backend-engineer-scribe-com-ac74aivg",
      "freshness": "fresh",
      "ghost_warning": null,
      "id": "senior-backend-engineer-scribe-com-ac74aivg",
      "is_open": true,
      "last_seen_at": "2026-10-19T21:31:46Z",
      "location": "United States",
      "posted_at": "2026-10-05T19:03:59Z",
      "regions": [
        "North America"
      ],
      "relocation": null,
      "requirements": [
        {
          "priority": "required",
          "text": "5+ years building production software at scale"
        }
      ],
      "salary": {
        "currency": "USD",
        "max": 240000,
        "min": 175000,
        "period": "year"
      },
      "salary_text": "USD 175,000 - 240,000 a year",
      "seniority": "Senior",
      "skills": [
        "aws",
        "django",
        "postgresql",
        "python",
        "redis",
        "terraform"
      ],
      "source": "ashby",
      "summary": "Senior engineer at Scribe who owns a product area end to end, design through launch, on one of four teams (Agents, Docs, Growth, Optimize).",
      "timezone_note": null,
      "title": "Senior Backend Engineer",
      "visa_sponsorship": null,
      "work_mode": "Remote"
    }
  ]
}
```

### Get company

Get a company's profile (what it does, website, size, funding, where it hires) and a page of its open jobs.

**Inputs**

- Company (`company_id`, text, required): Pick a company, or give its id from 'Search companies' or its freehire link (https://freehire.me/companies/...).
- Number of jobs (`limit`, number): How many of its open jobs to return, from 1 to 100. Defaults to 10. From 1 to 100. Default: `10`.
- Skip the first jobs (`offset`, number): How many of its jobs to skip, for the next page: give the 'next_offset' of the previous step. From 0 to 9999.

**Outputs**

- `company` (object)
- `count` (number): How many jobs this step returned.
- `jobs` (list): A page of its open jobs.
- `next_offset` (number): Give this as 'Skip the first jobs' to get the next page. Empty on the last page.

**Example output**

```json
{
  "company": {
    "description": "Stripe is a global technology company that builds economic infrastructure for the internet.",
    "employees": 7000,
    "freehire_url": "https://freehire.me/companies/stripe",
    "headquarters": "United States",
    "hiring_countries": [
      "Germany",
      "United Kingdom",
      "United States"
    ],
    "hiring_regions": [
      "Europe",
      "North America",
      "United Kingdom"
    ],
    "id": "stripe",
    "industries": [
      "developer-tools",
      "enterprise-software",
      "fintech"
    ],
    "linkedin": "https://linkedin.com/company/stripe",
    "lists": [
      "Unicorns",
      "Y Combinator"
    ],
    "logo_url": "https://bookface-images.s3.amazonaws.com/small_logos/e5ccedd9995f6524b4a0379062eb67f7c991613e.png",
    "name": "Stripe",
    "open_jobs": 541,
    "remote_regions": [
      "Europe",
      "North America",
      "United Kingdom"
    ],
    "stage": "enterprise",
    "tagline": "Economic infrastructure for the internet.",
    "tech_stack": [
      "Apache Spark",
      "Ruby",
      "Scala"
    ],
    "total_raised_usd": 9810000000,
    "website": "http://stripe.com",
    "yc_batch": "Summer 2009",
    "year_founded": 2012
  },
  "count": 1,
  "jobs": [
    {
      "apply_url": "https://jobs.ashbyhq.com/scribe/28031cc3-1043-47ee-b856-4732c6fb04cb?utm_source=freehire.me",
      "category": "Backend",
      "cities": [],
      "closed_at": null,
      "company": "scribe.com",
      "company_id": "scribe-com",
      "countries": [
        "United States"
      ],
      "country_codes": [
        "us"
      ],
      "days_listed": 14,
      "description": "About Scribe\n\nScribe is where exceptional people come to do the best work of their careers.",
      "employment_type": "Full-time",
      "experience_years": 5,
      "first_seen_at": "2026-10-05T21:27:55Z",
      "freehire_url": "https://freehire.me/jobs/senior-backend-engineer-scribe-com-ac74aivg",
      "freshness": "fresh",
      "ghost_warning": null,
      "id": "senior-backend-engineer-scribe-com-ac74aivg",
      "is_open": true,
      "last_seen_at": "2026-10-19T21:31:46Z",
      "location": "United States",
      "posted_at": "2026-10-05T19:03:59Z",
      "regions": [
        "North America"
      ],
      "relocation": null,
      "requirements": [
        {
          "priority": "required",
          "text": "5+ years building production software at scale"
        }
      ],
      "salary": {
        "currency": "USD",
        "max": 240000,
        "min": 175000,
        "period": "year"
      },
      "salary_text": "USD 175,000 - 240,000 a year",
      "seniority": "Senior",
      "skills": [
        "aws",
        "django",
        "postgresql",
        "python",
        "redis",
        "terraform"
      ],
      "source": "ashby",
      "summary": "Senior engineer at Scribe who owns a product area end to end, design through launch, on one of four teams (Agents, Docs, Growth, Optimize).",
      "timezone_note": null,
      "title": "Senior Backend Engineer",
      "visa_sponsorship": null,
      "work_mode": "Remote"
    }
  ],
  "next_offset": 1
}
```

### Get job

Get one job with its full description, salary, skills, requirements and a link to apply. Works for jobs that have since closed, so a workflow can check whether a job is still open.

**Inputs**

- Job (`job_id`, text, required): The job's id from 'Search jobs', or its freehire link (https://freehire.me/jobs/...).

**Outputs**

- `job` (object): The job.

**Example output**

```json
{
  "job": {
    "apply_url": "https://jobs.ashbyhq.com/scribe/28031cc3-1043-47ee-b856-4732c6fb04cb?utm_source=freehire.me",
    "category": "Backend",
    "cities": [],
    "closed_at": null,
    "company": "scribe.com",
    "company_id": "scribe-com",
    "countries": [
      "United States"
    ],
    "country_codes": [
      "us"
    ],
    "days_listed": 14,
    "description": "About Scribe\n\nScribe is where exceptional people come to do the best work of their careers.",
    "employment_type": "Full-time",
    "experience_years": 5,
    "first_seen_at": "2026-10-05T21:27:55Z",
    "freehire_url": "https://freehire.me/jobs/senior-backend-engineer-scribe-com-ac74aivg",
    "freshness": "fresh",
    "ghost_warning": null,
    "id": "senior-backend-engineer-scribe-com-ac74aivg",
    "is_open": true,
    "last_seen_at": "2026-10-19T21:31:46Z",
    "location": "United States",
    "posted_at": "2026-10-05T19:03:59Z",
    "regions": [
      "North America"
    ],
    "relocation": null,
    "requirements": [
      {
        "priority": "required",
        "text": "5+ years building production software at scale"
      }
    ],
    "salary": {
      "currency": "USD",
      "max": 240000,
      "min": 175000,
      "period": "year"
    },
    "salary_text": "USD 175,000 - 240,000 a year",
    "seniority": "Senior",
    "skills": [
      "aws",
      "django",
      "postgresql",
      "python",
      "redis",
      "terraform"
    ],
    "source": "ashby",
    "summary": "Senior engineer at Scribe who owns a product area end to end, design through launch, on one of four teams (Agents, Docs, Growth, Optimize).",
    "timezone_note": null,
    "title": "Senior Backend Engineer",
    "visa_sponsorship": null,
    "work_mode": "Remote"
  }
}
```

### Search companies

Find companies with open jobs on freehire, most open jobs first: by name, company list (such as Y Combinator or visa sponsors), where they hire, where they hire remotely, type and size.

**Inputs**

- Name (`name`, text): Part of the company's name. Leave empty for all.
- Company lists (`company_lists`, list): Only companies on these lists, such as Y Combinator or US H-1B visa sponsors.
- Hiring in (`locations`, list): Regions or countries the company has jobs in. Any of them matches.
- Hiring remotely in (`remote_regions`, text): Regions the company has remote jobs in. One or more of: `north_america` (North America), `eu` (Europe), `uk` (United Kingdom), `latam` (Latin America), `apac` (Asia-Pacific), `mena` (Middle East & North Africa), `africa`, `cis` (CIS (Eastern Europe & Central Asia)), `global` (Worldwide).
- Company type (`company_types`, text): Product company, startup, agency and so on. One or more of: `product` (Product company), `startup`, `inhouse` (In-house team), `outsource` (Outsourcing), `outstaff` (Outstaffing), `agency`, `government`.
- Company size (`company_sizes`, text): How many people work there. One or more of: `1-10` (1-10 people), `11-50` (11-50 people), `51-200` (51-200 people), `201-500` (201-500 people), `501-1000` (501-1,000 people), `1000+` (More than 1,000 people).
- Number of results (`limit`, number): How many to return, from 1 to 100. Defaults to 10. From 1 to 100. Default: `10`.
- Skip the first (`offset`, number): How many results to skip, for the next page: give the 'next_offset' of the previous step. Defaults to 0. From 0 to 9999.

**Outputs**

- `companies` (list): The companies found.
- `count` (number): How many companies this step returned.
- `next_offset` (number): Give this as 'Skip the first' to get the next page. Empty on the last page.
- `total` (number): How many companies match in all.

**Example output**

```json
{
  "companies": [
    {
      "freehire_url": "https://freehire.me/companies/stripe",
      "headquarters": "United States",
      "id": "stripe",
      "industries": [
        "developer-tools",
        "enterprise-software",
        "fintech"
      ],
      "lists": [
        "Unicorns",
        "Y Combinator"
      ],
      "name": "Stripe",
      "open_jobs": 541,
      "tagline": "Economic infrastructure for the internet."
    }
  ],
  "count": 1,
  "next_offset": 1,
  "total": 86
}
```

### Search jobs

Search open tech jobs on freehire, gathered from companies' own career pages and job boards. Every filter is optional: narrow by keywords, location, work mode, seniority, skills, role, company, salary and how recently the job was listed. Each job comes with its salary, skills, a link to apply and a plain-text description.

**Inputs**

- Keywords (`keywords`, text): Words to look for in the title, company, description and location, such as "python developer". Put "-" before a word to leave out jobs with it. Leave empty for every job.
- Match keywords in the title only (`title_only`, true/false): On: the keywords must be in the job title. Off: they can be anywhere in the posting. Default: `false`.
- Locations (`locations`, list): Regions, countries or cities. A job in any of them matches. Leave empty for anywhere.
- Work mode (`work_modes`, text): Remote, hybrid or on-site. Leave empty for all, including jobs that don't say. One or more of: `remote`, `hybrid`, `onsite` (On-site).
- Seniority (`seniority`, text): The levels to include. Many postings don't state one, and those are left out once a level is chosen. One or more of: `intern`, `junior`, `middle` (Mid-level), `senior`, `lead`, `staff`, `principal`, `c_level` (Executive (C-level)).
- Skills (`skills`, list): Skills the job asks for, such as python or kubernetes. A job with any of them matches, unless 'Must have every skill' is on.
- Must have every skill (`require_all_skills`, true/false): On: only jobs that ask for every skill chosen. Default: `false`.
- Role category (`categories`, list): The kinds of role, such as Backend or Data science.
- Employment type (`employment_types`, text): Full-time, part-time, contract and so on. Leave empty for all. One or more of: `full_time` (Full-time), `part_time` (Part-time), `contract`, `internship`, `fellowship`.
- Companies (`companies`, list): Only jobs at these companies. The list offers well-known tech employers; for any other, type its id from 'Search companies'.
- Company lists (`company_lists`, list): Only companies on these lists, such as Y Combinator or US H-1B visa sponsors.
- Listed in the last (days) (`listed_within_days`, number): Only jobs freehire found this many days ago or less. Reposted ads don't count as new. Leave empty for any age. From 1 to 3650.
- Only jobs that sponsor a visa (`visa_sponsorship`, true/false): On: only jobs whose posting says it sponsors a visa. Default: `false`.
- Minimum salary (`min_salary`, number): Only jobs whose stated pay starts at this or more. Jobs that state no pay are left out. Pay isn't converted between currencies, so choose a salary currency and period too. At least 0.
- Salary currency (`salary_currency`, text): Only jobs that state their pay in this currency.
- Salary period (`salary_period`, text): Only jobs that state their pay per year, month, day or hour. One of: `year` (A year), `month` (A month), `day` (A day), `hour` (An hour).
- Only fresh listings (`fresh_only`, true/false): On: leave out jobs that have been open for a long time and ads that are always open. A large share of listings are old, so this is the quickest way to see current openings. Default: `false`.
- Order (`sort`, text): Best match ranks by the keywords (and is newest first without any). 'Newest on freehire' suits a scheduled search. One of: `relevance` (Best match), `newest` (Newest on freehire), `recently_posted` (Most recently posted), `highest_salary` (Highest salary), `most_viewed` (Most viewed). Default: `relevance`.
- Full descriptions (`full_descriptions`, true/false): On: each job carries its whole description. Off: a short preview, which keeps the result small. Default: `false`.
- Number of results (`limit`, number): How many to return, from 1 to 100. Defaults to 10. From 1 to 100. Default: `10`.
- Skip the first (`offset`, number): How many results to skip, for the next page: give the 'next_offset' of the previous step. Defaults to 0. From 0 to 9999.

**Outputs**

- `count` (number): How many jobs this step returned.
- `jobs` (list): The jobs found.
- `next_offset` (number): Give this as 'Skip the first' to get the next page. Empty on the last page.
- `total` (number): How many jobs match in all.

**Example output**

```json
{
  "count": 1,
  "jobs": [
    {
      "apply_url": "https://jobs.ashbyhq.com/scribe/28031cc3-1043-47ee-b856-4732c6fb04cb?utm_source=freehire.me",
      "category": "Backend",
      "cities": [],
      "closed_at": null,
      "company": "scribe.com",
      "company_id": "scribe-com",
      "countries": [
        "United States"
      ],
      "country_codes": [
        "us"
      ],
      "days_listed": 14,
      "description": "About Scribe\n\nScribe is where exceptional people come to do the best work of their careers.",
      "employment_type": "Full-time",
      "experience_years": 5,
      "first_seen_at": "2026-10-05T21:27:55Z",
      "freehire_url": "https://freehire.me/jobs/senior-backend-engineer-scribe-com-ac74aivg",
      "freshness": "fresh",
      "ghost_warning": null,
      "id": "senior-backend-engineer-scribe-com-ac74aivg",
      "is_open": true,
      "last_seen_at": "2026-10-19T21:31:46Z",
      "location": "United States",
      "posted_at": "2026-10-05T19:03:59Z",
      "regions": [
        "North America"
      ],
      "relocation": null,
      "requirements": [
        {
          "priority": "required",
          "text": "5+ years building production software at scale"
        }
      ],
      "salary": {
        "currency": "USD",
        "max": 240000,
        "min": 175000,
        "period": "year"
      },
      "salary_text": "USD 175,000 - 240,000 a year",
      "seniority": "Senior",
      "skills": [
        "aws",
        "django",
        "postgresql",
        "python",
        "redis",
        "terraform"
      ],
      "source": "ashby",
      "summary": "Senior engineer at Scribe who owns a product area end to end, design through launch, on one of four teams (Agents, Docs, Growth, Optimize).",
      "timezone_note": null,
      "title": "Senior Backend Engineer",
      "visa_sponsorship": null,
      "work_mode": "Remote"
    }
  ],
  "next_offset": 1,
  "total": 29
}
```
