Catalog / 4DayWeek Jobs

4DayWeek Jobs API

4dayweek.io

Read-only live access to 4dayweek.io public job listings and company profiles. Search accepts the site's keyword, location, work-arrangement, schedule, category, level, salary, work-life, benefits, skills, and sort filters. Results preserve the source's page/total/has_more pagination and source identifiers. Salary lower/upper values are source integer hundredths of the stated currency unit (for example, 8000000 means GBP 80,000.00) alongside the display string and currency; posted is a source Unix-seconds timestamp and inserted is a source ISO-8601 UTC timestamp. Use a returned job slug with the detail operation to read the posting and apply_url. Resolve familiar location text through /locations before passing the returned source location id as near_location to /jobs. The site may gate very recent listings for anonymous visitors; the returned meta object preserves that source state rather than claiming exhaustive freshness.

  • Other
  • jobs
  • careers
  • remote-work
  • companies
  • job-search
8 endpointsDocs updated

Endpoint health

Loading verification…

Connect your agent

Connect through MCP so your agent can find this API, read its docs, and call its endpoints.

Setup guide

Add the server from your terminal.

Claude Code · terminal
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcp

In Claude Code, run /mcp, select agent-data, then Authenticate. Sign in to your agent-data account in the browser.

Then ask your agent to use the 4DayWeek Jobs API for your task.

Call it over HTTP

Get an API key

Sign up free, generate an API key, and set it as AGENT_DATA_API_KEY in your environment. Your first 100 calls each month are free.

Search public company profiles

Optional parameters 13

Free-text company name query.

Comma-separated source country values.

Comma-separated source remote-level values.

When true, request companies that hire worldwide.

Comma-separated source schedule types.

Source company-size filter.

Comma-separated source benefit identifiers.

Source company category.

Source company sort value.

When true, limit to companies with open jobs.

1-based source result page.

Number of source companies requested per page.

Optional source rotation seed for stable browsing.

View call pricing
cURL · Companies
curl --request GET --get 'https://3kpkg0jfvk.execute-api.us-east-2.amazonaws.com/prod/f11801b1-fb06-4f09-88ff-d566ad3431c7/companies' \
  --header "Authorization: Bearer $AGENT_DATA_API_KEY"

Endpoints

Inputs and response fields for every endpoint in this API.

GETCompanies/companies

Search public company profiles

Input

qOptionalQuery · string | null

Free-text company name query.

Example: Seatfrog

countryOptionalQuery · string | null

Comma-separated source country values.

Example: United Kingdom

remoteOptionalQuery · string | null

Comma-separated source remote-level values.

Example: fully-remote

hires_worldwideOptionalQuery · boolean | null

When true, request companies that hire worldwide.

Example: true

scheduleOptionalQuery · string | null

Comma-separated source schedule types.

Example: 4_day_week

sizeOptionalQuery · string | null

Source company-size filter.

Example: small

benefitsOptionalQuery · string | null

Comma-separated source benefit identifiers.

Example: healthcare

categoryOptionalQuery · string | null

Source company category.

Example: Travel

sortOptionalQuery · string | null

Source company sort value.

Example: jobs

has_jobsOptionalQuery · boolean | null

When true, limit to companies with open jobs.

Example: true

pageOptionalQuery · integer, min: 1, default: 1

1-based source result page.

Example: 1

limitOptionalQuery · integer, min: 1, default: 25

Number of source companies requested per page.

Example: 25

rotation_seedOptionalQuery · integer | null

Optional source rotation seed for stable browsing.

Example: 1

Response

pageinteger
totalinteger
has_moreboolean
companiesobject[]
companies[].idstring
companies[].namestring
companies[].slugstring
companies[].country?string | null
companies[].benefits?object | null
companies[].logo_url?string | null
companies[].vacation?integer | null
companies[].employees?integer | null
companies[].job_count?integer | null
companies[].company_url?string | null
companies[].remote_level?string | null
companies[].schedule_type?string | null
companies[].hires_worldwide?boolean | null
companies[].hours_full_time?integer | null
companies[].work_life_score?integer | null
companies[].social_image_url?string | null
companies[].short_description?string | null

Fields marked ? are optional.

GETCompanies by slug/companies/{slug}

Open a company profile and its current open jobs

Input

slugRequiredPath · string

Source company slug returned by /companies or a job's company.slug.

Example: seatfrog

Response

jobsobject[]
jobs[].idstring
jobs[].slug?string, default:
jobs[].level?string | null
jobs[].stack?object[]
jobs[].stack[].id?string | null
jobs[].stack[].name?string | null
jobs[].stack[].slug?string | null
jobs[].titlestring
jobs[].posted?integer | null
jobs[].salary?string | null
jobs[].company?object
jobs[].company.id?string | null
jobs[].company.name?string | null
jobs[].company.slug?string | null
jobs[].company.updated?string | null
jobs[].company.inserted?string | null
jobs[].company.logo_url?string | null
jobs[].company.hires_worldwide?boolean | null
jobs[].category?string | null
jobs[].inserted?string | null
jobs[].locations?object[]
jobs[].locations[].id?string | null
jobs[].locations[].city?string | null
jobs[].locations[].state?string | null
jobs[].locations[].country?string | null
jobs[].locations[].latitude?number | null
jobs[].locations[].continent?string | null
jobs[].locations[].longitude?number | null
jobs[].locations[].is_primary?boolean | null
jobs[].locations[].work_arrangement?string | null
jobs[].timezones?string[]
jobs[].company_id?string, default:
jobs[].is_expired?boolean | null
jobs[].company_name?string, default:
jobs[].salary_lower?integer | null
jobs[].salary_upper?integer | null
jobs[].salary_period?string | null
jobs[].schedule_type?string | null
jobs[].salary_currency?string | null
jobs[].work_life_score?integer | null
jobs[].work_arrangement?string | null
companyobject
company.idstring
company.namestring
company.slugstring
company.country?string | null
company.updated?string | null
company.benefits?object | null
company.category?string | null
company.inserted?string | null
company.logo_url?string | null
company.vacation?integer | null
company.verified?boolean | null
company.continent?string | null
company.employees?integer | null
company.company_url?string | null
company.description?string | null
company.flexibility?string | null
company.company_size?string | null
company.four_day_off?string | null
company.linkedin_url?string | null
company.remote_level?string | null
company.schedule_type?string | null
company.hires_worldwide?boolean | null
company.hours_full_time?integer | null
company.description_html?string | null
company.social_image_url?string | null
company.short_description?string | null
company.vacation_description?string | null
company.four_day_reference_url?string | null
company.flexibility_description?string | null
company.remote_team_description?string | null
company.schedule_type_description?string | null
job_countinteger
category_counts?object
hidden_fresh_count?integer | null

Fields marked ? are optional.

GETCompanies by slug jobs/companies/{slug}/jobs

With category, this uses the source's category-filtered paginated collection. Without category, it pages the open jobs embedded in the source company profile and marks pagination_mode=company_profile_embedded.

Input

slugRequiredPath · string

Source company slug returned by /companies or a job's company.slug.

Example: seatfrog

categoryOptionalQuery · string | null

Source job category; omit to use the company's unfiltered open-job list.

Example: marketing

pageOptionalQuery · integer, min: 1, default: 1

1-based source result page.

Example: 1

limitOptionalQuery · integer, min: 1, default: 25

Number of source jobs requested per page.

Example: 25

Response

jobsobject[]
jobs[].idstring
jobs[].slug?string, default:
jobs[].level?string | null
jobs[].stack?object[]
jobs[].stack[].id?string | null
jobs[].stack[].name?string | null
jobs[].stack[].slug?string | null
jobs[].titlestring
jobs[].posted?integer | null
jobs[].salary?string | null
jobs[].company?object
jobs[].company.id?string | null
jobs[].company.name?string | null
jobs[].company.slug?string | null
jobs[].company.updated?string | null
jobs[].company.inserted?string | null
jobs[].company.logo_url?string | null
jobs[].company.hires_worldwide?boolean | null
jobs[].category?string | null
jobs[].inserted?string | null
jobs[].locations?object[]
jobs[].locations[].id?string | null
jobs[].locations[].city?string | null
jobs[].locations[].state?string | null
jobs[].locations[].country?string | null
jobs[].locations[].latitude?number | null
jobs[].locations[].continent?string | null
jobs[].locations[].longitude?number | null
jobs[].locations[].is_primary?boolean | null
jobs[].locations[].work_arrangement?string | null
jobs[].timezones?string[]
jobs[].company_id?string, default:
jobs[].is_expired?boolean | null
jobs[].company_name?string, default:
jobs[].salary_lower?integer | null
jobs[].salary_upper?integer | null
jobs[].salary_period?string | null
jobs[].schedule_type?string | null
jobs[].salary_currency?string | null
jobs[].work_life_score?integer | null
jobs[].work_arrangement?string | null
pageinteger
totalinteger
has_moreboolean
pagination_mode?string, default: source

Fields marked ? are optional.

GETFilters/filters

List observed job filters and counts

Input

No input parameters.

Response

rolesobject[]
countsobject
counts.levels?object
counts.categories?object
counts.schedule_types?object
counts.work_life_scores?object
counts.work_arrangements?object

Fields marked ? are optional.

GETJobs/jobs

Search and page through public job listings

Input

qOptionalQuery · string | null

Free-text role or keyword query, matched by the source.

Example: software engineer

locationOptionalQuery · string | null

Comma-separated source location values.

Example: United States

work_arrangementsOptionalQuery · string | null

Comma-separated source values such as remote, hybrid, onsite, or worldwide.

Example: remote

scheduleOptionalQuery · string | null

Comma-separated source schedule types.

Example: 4_day_week

categoryOptionalQuery · string | null

Comma-separated source job categories.

Example: engineering

levelOptionalQuery · string | null

Comma-separated source seniority levels.

Example: senior

near_locationOptionalQuery · string | null

Source-resolved location UUID. Use the `location.id` returned by /locations/resolve; this is distinct from the free-text location filter.

Example: 019d8d0c-84ad-74ed-8158-8c1fa9a90790

near_countryOptionalQuery · string | null

Source proximity country.

Example: United States

radiusOptionalQuery · integer | null

Source distance radius used with near_location, in source distance units.

Example: 25

office_cityOptionalQuery · string | null

Source office-city filter; unlike near_location, this is source free text for an office city.

Example: New York

timezoneOptionalQuery · string | null

Source timezone filter passed unchanged to the job search.

Example: America/New_York

worldwide_onlyOptionalQuery · boolean | null

When true, request source worldwide-only jobs.

Example: true

benefitsOptionalQuery · string | null

Comma-separated source benefit identifiers.

Example: healthcare

skillsOptionalQuery · string | null

Comma-separated source skill identifiers.

Example: python

salary_minOptionalQuery · integer | null

Source salary floor in integer hundredths of the stated currency unit (for example 10,000,000 represents 100,000.00); use with the source currency context and do not compare currencies directly.

Example: 10000000

salary_maxOptionalQuery · integer | null

Source salary ceiling in integer hundredths of the stated currency unit; salary_period remains source-provided.

Example: 20000000

min_work_life_scoreOptionalQuery · integer | null

Minimum source work-life score.

Example: 80

posted_afterOptionalQuery · integer | null

Source posted-after Unix timestamp.

Example: 1790000000

roleOptionalQuery · string | null

Source role value; use /filters to discover current role labels.

Example: Software Engineer

filterOptionalQuery · string | null

Source filter expression, passed through unchanged.

Example: active

sortOptionalQuery · string | null

Source sort: best_match, nearest, work_life_score, date or newest, or salary. The source UI labels date/newest as Newest; both observed values are passed through.

Example: newest

pageOptionalQuery · integer, min: 1, default: 1

1-based source result page.

Example: 1

limitOptionalQuery · integer, min: 1, default: 25

Number of source results requested per page.

Example: 25

gatedOptionalQuery · boolean, default: true

Preserve the site's anonymous early-access gating behavior.

Example: true

one_per_companyOptionalQuery · boolean | null

When true, ask the source for at most one result per company.

Example: true

Response

jobsobject[]
jobs[].idstring
jobs[].slug?string, default:
jobs[].level?string | null
jobs[].stack?object[]
jobs[].stack[].id?string | null
jobs[].stack[].name?string | null
jobs[].stack[].slug?string | null
jobs[].titlestring
jobs[].posted?integer | null
jobs[].salary?string | null
jobs[].company?object
jobs[].company.id?string | null
jobs[].company.name?string | null
jobs[].company.slug?string | null
jobs[].company.updated?string | null
jobs[].company.inserted?string | null
jobs[].company.logo_url?string | null
jobs[].company.hires_worldwide?boolean | null
jobs[].category?string | null
jobs[].inserted?string | null
jobs[].locations?object[]
jobs[].locations[].id?string | null
jobs[].locations[].city?string | null
jobs[].locations[].state?string | null
jobs[].locations[].country?string | null
jobs[].locations[].latitude?number | null
jobs[].locations[].continent?string | null
jobs[].locations[].longitude?number | null
jobs[].locations[].is_primary?boolean | null
jobs[].locations[].work_arrangement?string | null
jobs[].timezones?string[]
jobs[].company_id?string, default:
jobs[].is_expired?boolean | null
jobs[].company_name?string, default:
jobs[].salary_lower?integer | null
jobs[].salary_upper?integer | null
jobs[].salary_period?string | null
jobs[].schedule_type?string | null
jobs[].salary_currency?string | null
jobs[].work_life_score?integer | null
jobs[].work_arrangement?string | null
meta?object
pageinteger
totalinteger
has_moreboolean

Fields marked ? are optional.

GETJobs by slug/jobs/{slug}

Open a full job posting by its source slug

Input

slugRequiredPath · string

Source job slug returned by /jobs.

Example: growth-marketing-lead-at-seatfrog-9c762ea1

Response

jobobject
job.idstring
job.live?boolean | null
job.role?string | null
job.slug?string, default:
job.level?string | null
job.stack?object[]
job.stack[].id?string | null
job.stack[].name?string | null
job.stack[].slug?string | null
job.titlestring
job.tools?object[]
job.tools[].id?string | null
job.tools[].name?string | null
job.tools[].slug?string | null
job.posted?integer | null
job.salary?string | null
job.skills?object[]
job.skills[].id?string | null
job.skills[].name?string | null
job.skills[].slug?string | null
job.company?object
job.company.id?string | null
job.company.name?string | null
job.company.slug?string | null
job.company.updated?string | null
job.company.inserted?string | null
job.company.logo_url?string | null
job.company.hires_worldwide?boolean | null
job.category?string | null
job.inserted?string | null
job.is_valid?boolean | null
job.language?string | null
job.apply_url?string | null
job.locations?object[]
job.locations[].id?string | null
job.locations[].city?string | null
job.locations[].state?string | null
job.locations[].country?string | null
job.locations[].latitude?number | null
job.locations[].continent?string | null
job.locations[].longitude?number | null
job.locations[].is_primary?boolean | null
job.locations[].work_arrangement?string | null
job.timezones?string[]
job.company_id?string, default:
job.expires_at?integer | null
job.is_expired?boolean | null
job.company_url?string | null
job.description?string | null
job.company_name?string, default:
job.location_raw?string | null
job.salary_lower?integer | null
job.salary_upper?integer | null
job.salary_period?string | null
job.schedule_type?string | null
job.salary_currency?string | null
job.work_life_score?integer | null
job.description_html?string | null
job.work_arrangement?string | null
job.hours_per_week_max?integer | null
job.hours_per_week_min?integer | null
job.application_extra_fields?object[]
companyobject
company.idstring
company.namestring
company.slugstring
company.country?string | null
company.updated?string | null
company.benefits?object | null
company.category?string | null
company.inserted?string | null
company.logo_url?string | null
company.vacation?integer | null
company.verified?boolean | null
company.continent?string | null
company.employees?integer | null
company.company_url?string | null
company.description?string | null
company.flexibility?string | null
company.company_size?string | null
company.four_day_off?string | null
company.linkedin_url?string | null
company.remote_level?string | null
company.schedule_type?string | null
company.hires_worldwide?boolean | null
company.hours_full_time?integer | null
company.description_html?string | null
company.social_image_url?string | null
company.short_description?string | null
company.vacation_description?string | null
company.four_day_reference_url?string | null
company.flexibility_description?string | null
company.remote_team_description?string | null
company.schedule_type_description?string | null
similar_jobs?object[]
similar_jobs[].idstring
similar_jobs[].slug?string, default:
similar_jobs[].level?string | null
similar_jobs[].stack?object[]
similar_jobs[].stack[].id?string | null
similar_jobs[].stack[].name?string | null
similar_jobs[].stack[].slug?string | null
similar_jobs[].titlestring
similar_jobs[].posted?integer | null
similar_jobs[].salary?string | null
similar_jobs[].company?object
similar_jobs[].company.id?string | null
similar_jobs[].company.name?string | null
similar_jobs[].company.slug?string | null
similar_jobs[].company.updated?string | null
similar_jobs[].company.inserted?string | null
similar_jobs[].company.logo_url?string | null
similar_jobs[].company.hires_worldwide?boolean | null
similar_jobs[].category?string | null
similar_jobs[].inserted?string | null
similar_jobs[].locations?object[]
similar_jobs[].locations[].id?string | null
similar_jobs[].locations[].city?string | null
similar_jobs[].locations[].state?string | null
similar_jobs[].locations[].country?string | null
similar_jobs[].locations[].latitude?number | null
similar_jobs[].locations[].continent?string | null
similar_jobs[].locations[].longitude?number | null
similar_jobs[].locations[].is_primary?boolean | null
similar_jobs[].locations[].work_arrangement?string | null
similar_jobs[].timezones?string[]
similar_jobs[].company_id?string, default:
similar_jobs[].is_expired?boolean | null
similar_jobs[].company_name?string, default:
similar_jobs[].salary_lower?integer | null
similar_jobs[].salary_upper?integer | null
similar_jobs[].salary_period?string | null
similar_jobs[].schedule_type?string | null
similar_jobs[].salary_currency?string | null
similar_jobs[].work_life_score?integer | null
similar_jobs[].work_arrangement?string | null

Fields marked ? are optional.

GETLocations/locations

Resolve familiar place text to source location choices

Input

qRequiredQuery · string

Partial city, region, or place text accepted by the source autocomplete.

Example: New York

typeOptionalQuery · string | null

Optional source place type passed through to autocomplete.

Example: (cities)

Response

predictionsobject[]
predictions[].place_idstring
predictions[].main_textstring
predictions[].descriptionstring
predictions[].secondary_text?string | null

Fields marked ? are optional.

GETLocations resolve/locations/resolve

Resolve a returned place choice into a source location

Input

place_idRequiredQuery · string

place_id returned unchanged by /locations.

Example: ChIJOwg_06VPwokRYv534QaPC8g

Response

locationobject
location.id?string | null
location.city?string | null
location.state?string | null
location.country?string | null
location.latitude?number | null
location.continent?string | null
location.longitude?number | null
location.is_primary?boolean | null
location.work_arrangement?string | null

Fields marked ? are optional.

Don’t see the endpoint you need?

Ask agent-data to add an endpoint or return more fields. Extensions are free and keep existing endpoints working.