4DayWeek Jobs API
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.
Endpoint health
Loading verification…
Connect your agent
Connect through MCP so your agent can find this API, read its docs, and call its endpoints.
Add the server from your terminal.
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcpIn 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 keySign 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.
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 | nullFree-text company name query.
Example: Seatfrog
countryOptionalQuery · string | nullComma-separated source country values.
Example: United Kingdom
remoteOptionalQuery · string | nullComma-separated source remote-level values.
Example: fully-remote
hires_worldwideOptionalQuery · boolean | nullWhen true, request companies that hire worldwide.
Example: true
scheduleOptionalQuery · string | nullComma-separated source schedule types.
Example: 4_day_week
sizeOptionalQuery · string | nullSource company-size filter.
Example: small
benefitsOptionalQuery · string | nullComma-separated source benefit identifiers.
Example: healthcare
categoryOptionalQuery · string | nullSource company category.
Example: Travel
sortOptionalQuery · string | nullSource company sort value.
Example: jobs
has_jobsOptionalQuery · boolean | nullWhen true, limit to companies with open jobs.
Example: true
pageOptionalQuery · integer, min: 1, default: 11-based source result page.
Example: 1
limitOptionalQuery · integer, min: 1, default: 25Number of source companies requested per page.
Example: 25
rotation_seedOptionalQuery · integer | nullOptional source rotation seed for stable browsing.
Example: 1
Response
pageintegertotalintegerhas_morebooleancompaniesobject[]companies[].idstringcompanies[].namestringcompanies[].slugstringcompanies[].country?string | nullcompanies[].benefits?object | nullcompanies[].logo_url?string | nullcompanies[].vacation?integer | nullcompanies[].employees?integer | nullcompanies[].job_count?integer | nullcompanies[].company_url?string | nullcompanies[].remote_level?string | nullcompanies[].schedule_type?string | nullcompanies[].hires_worldwide?boolean | nullcompanies[].hours_full_time?integer | nullcompanies[].work_life_score?integer | nullcompanies[].social_image_url?string | nullcompanies[].short_description?string | nullFields marked ? are optional.
GETCompanies by slug/companies/{slug}
Open a company profile and its current open jobs
Input
slugRequiredPath · stringSource company slug returned by /companies or a job's company.slug.
Example: seatfrog
Response
jobsobject[]jobs[].idstringjobs[].slug?string, default: jobs[].level?string | nulljobs[].stack?object[]jobs[].stack[].id?string | nulljobs[].stack[].name?string | nulljobs[].stack[].slug?string | nulljobs[].titlestringjobs[].posted?integer | nulljobs[].salary?string | nulljobs[].company?objectjobs[].company.id?string | nulljobs[].company.name?string | nulljobs[].company.slug?string | nulljobs[].company.updated?string | nulljobs[].company.inserted?string | nulljobs[].company.logo_url?string | nulljobs[].company.hires_worldwide?boolean | nulljobs[].category?string | nulljobs[].inserted?string | nulljobs[].locations?object[]jobs[].locations[].id?string | nulljobs[].locations[].city?string | nulljobs[].locations[].state?string | nulljobs[].locations[].country?string | nulljobs[].locations[].latitude?number | nulljobs[].locations[].continent?string | nulljobs[].locations[].longitude?number | nulljobs[].locations[].is_primary?boolean | nulljobs[].locations[].work_arrangement?string | nulljobs[].timezones?string[]jobs[].company_id?string, default: jobs[].is_expired?boolean | nulljobs[].company_name?string, default: jobs[].salary_lower?integer | nulljobs[].salary_upper?integer | nulljobs[].salary_period?string | nulljobs[].schedule_type?string | nulljobs[].salary_currency?string | nulljobs[].work_life_score?integer | nulljobs[].work_arrangement?string | nullcompanyobjectcompany.idstringcompany.namestringcompany.slugstringcompany.country?string | nullcompany.updated?string | nullcompany.benefits?object | nullcompany.category?string | nullcompany.inserted?string | nullcompany.logo_url?string | nullcompany.vacation?integer | nullcompany.verified?boolean | nullcompany.continent?string | nullcompany.employees?integer | nullcompany.company_url?string | nullcompany.description?string | nullcompany.flexibility?string | nullcompany.company_size?string | nullcompany.four_day_off?string | nullcompany.linkedin_url?string | nullcompany.remote_level?string | nullcompany.schedule_type?string | nullcompany.hires_worldwide?boolean | nullcompany.hours_full_time?integer | nullcompany.description_html?string | nullcompany.social_image_url?string | nullcompany.short_description?string | nullcompany.vacation_description?string | nullcompany.four_day_reference_url?string | nullcompany.flexibility_description?string | nullcompany.remote_team_description?string | nullcompany.schedule_type_description?string | nulljob_countintegercategory_counts?objecthidden_fresh_count?integer | nullFields 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 · stringSource company slug returned by /companies or a job's company.slug.
Example: seatfrog
categoryOptionalQuery · string | nullSource job category; omit to use the company's unfiltered open-job list.
Example: marketing
pageOptionalQuery · integer, min: 1, default: 11-based source result page.
Example: 1
limitOptionalQuery · integer, min: 1, default: 25Number of source jobs requested per page.
Example: 25
Response
jobsobject[]jobs[].idstringjobs[].slug?string, default: jobs[].level?string | nulljobs[].stack?object[]jobs[].stack[].id?string | nulljobs[].stack[].name?string | nulljobs[].stack[].slug?string | nulljobs[].titlestringjobs[].posted?integer | nulljobs[].salary?string | nulljobs[].company?objectjobs[].company.id?string | nulljobs[].company.name?string | nulljobs[].company.slug?string | nulljobs[].company.updated?string | nulljobs[].company.inserted?string | nulljobs[].company.logo_url?string | nulljobs[].company.hires_worldwide?boolean | nulljobs[].category?string | nulljobs[].inserted?string | nulljobs[].locations?object[]jobs[].locations[].id?string | nulljobs[].locations[].city?string | nulljobs[].locations[].state?string | nulljobs[].locations[].country?string | nulljobs[].locations[].latitude?number | nulljobs[].locations[].continent?string | nulljobs[].locations[].longitude?number | nulljobs[].locations[].is_primary?boolean | nulljobs[].locations[].work_arrangement?string | nulljobs[].timezones?string[]jobs[].company_id?string, default: jobs[].is_expired?boolean | nulljobs[].company_name?string, default: jobs[].salary_lower?integer | nulljobs[].salary_upper?integer | nulljobs[].salary_period?string | nulljobs[].schedule_type?string | nulljobs[].salary_currency?string | nulljobs[].work_life_score?integer | nulljobs[].work_arrangement?string | nullpageintegertotalintegerhas_morebooleanpagination_mode?string, default: sourceFields marked ? are optional.
GETFilters/filters
List observed job filters and counts
Input
No input parameters.
Response
rolesobject[]countsobjectcounts.levels?objectcounts.categories?objectcounts.schedule_types?objectcounts.work_life_scores?objectcounts.work_arrangements?objectFields marked ? are optional.
GETJobs/jobs
Search and page through public job listings
Input
qOptionalQuery · string | nullFree-text role or keyword query, matched by the source.
Example: software engineer
locationOptionalQuery · string | nullComma-separated source location values.
Example: United States
work_arrangementsOptionalQuery · string | nullComma-separated source values such as remote, hybrid, onsite, or worldwide.
Example: remote
scheduleOptionalQuery · string | nullComma-separated source schedule types.
Example: 4_day_week
categoryOptionalQuery · string | nullComma-separated source job categories.
Example: engineering
levelOptionalQuery · string | nullComma-separated source seniority levels.
Example: senior
near_locationOptionalQuery · string | nullSource-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 | nullSource proximity country.
Example: United States
radiusOptionalQuery · integer | nullSource distance radius used with near_location, in source distance units.
Example: 25
office_cityOptionalQuery · string | nullSource office-city filter; unlike near_location, this is source free text for an office city.
Example: New York
timezoneOptionalQuery · string | nullSource timezone filter passed unchanged to the job search.
Example: America/New_York
worldwide_onlyOptionalQuery · boolean | nullWhen true, request source worldwide-only jobs.
Example: true
benefitsOptionalQuery · string | nullComma-separated source benefit identifiers.
Example: healthcare
skillsOptionalQuery · string | nullComma-separated source skill identifiers.
Example: python
salary_minOptionalQuery · integer | nullSource 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 | nullSource salary ceiling in integer hundredths of the stated currency unit; salary_period remains source-provided.
Example: 20000000
min_work_life_scoreOptionalQuery · integer | nullMinimum source work-life score.
Example: 80
posted_afterOptionalQuery · integer | nullSource posted-after Unix timestamp.
Example: 1790000000
roleOptionalQuery · string | nullSource role value; use /filters to discover current role labels.
Example: Software Engineer
filterOptionalQuery · string | nullSource filter expression, passed through unchanged.
Example: active
sortOptionalQuery · string | nullSource 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: 11-based source result page.
Example: 1
limitOptionalQuery · integer, min: 1, default: 25Number of source results requested per page.
Example: 25
gatedOptionalQuery · boolean, default: truePreserve the site's anonymous early-access gating behavior.
Example: true
one_per_companyOptionalQuery · boolean | nullWhen true, ask the source for at most one result per company.
Example: true
Response
jobsobject[]jobs[].idstringjobs[].slug?string, default: jobs[].level?string | nulljobs[].stack?object[]jobs[].stack[].id?string | nulljobs[].stack[].name?string | nulljobs[].stack[].slug?string | nulljobs[].titlestringjobs[].posted?integer | nulljobs[].salary?string | nulljobs[].company?objectjobs[].company.id?string | nulljobs[].company.name?string | nulljobs[].company.slug?string | nulljobs[].company.updated?string | nulljobs[].company.inserted?string | nulljobs[].company.logo_url?string | nulljobs[].company.hires_worldwide?boolean | nulljobs[].category?string | nulljobs[].inserted?string | nulljobs[].locations?object[]jobs[].locations[].id?string | nulljobs[].locations[].city?string | nulljobs[].locations[].state?string | nulljobs[].locations[].country?string | nulljobs[].locations[].latitude?number | nulljobs[].locations[].continent?string | nulljobs[].locations[].longitude?number | nulljobs[].locations[].is_primary?boolean | nulljobs[].locations[].work_arrangement?string | nulljobs[].timezones?string[]jobs[].company_id?string, default: jobs[].is_expired?boolean | nulljobs[].company_name?string, default: jobs[].salary_lower?integer | nulljobs[].salary_upper?integer | nulljobs[].salary_period?string | nulljobs[].schedule_type?string | nulljobs[].salary_currency?string | nulljobs[].work_life_score?integer | nulljobs[].work_arrangement?string | nullmeta?objectpageintegertotalintegerhas_morebooleanFields marked ? are optional.
GETJobs by slug/jobs/{slug}
Open a full job posting by its source slug
Input
slugRequiredPath · stringSource job slug returned by /jobs.
Example: growth-marketing-lead-at-seatfrog-9c762ea1
Response
jobobjectjob.idstringjob.live?boolean | nulljob.role?string | nulljob.slug?string, default: job.level?string | nulljob.stack?object[]job.stack[].id?string | nulljob.stack[].name?string | nulljob.stack[].slug?string | nulljob.titlestringjob.tools?object[]job.tools[].id?string | nulljob.tools[].name?string | nulljob.tools[].slug?string | nulljob.posted?integer | nulljob.salary?string | nulljob.skills?object[]job.skills[].id?string | nulljob.skills[].name?string | nulljob.skills[].slug?string | nulljob.company?objectjob.company.id?string | nulljob.company.name?string | nulljob.company.slug?string | nulljob.company.updated?string | nulljob.company.inserted?string | nulljob.company.logo_url?string | nulljob.company.hires_worldwide?boolean | nulljob.category?string | nulljob.inserted?string | nulljob.is_valid?boolean | nulljob.language?string | nulljob.apply_url?string | nulljob.locations?object[]job.locations[].id?string | nulljob.locations[].city?string | nulljob.locations[].state?string | nulljob.locations[].country?string | nulljob.locations[].latitude?number | nulljob.locations[].continent?string | nulljob.locations[].longitude?number | nulljob.locations[].is_primary?boolean | nulljob.locations[].work_arrangement?string | nulljob.timezones?string[]job.company_id?string, default: job.expires_at?integer | nulljob.is_expired?boolean | nulljob.company_url?string | nulljob.description?string | nulljob.company_name?string, default: job.location_raw?string | nulljob.salary_lower?integer | nulljob.salary_upper?integer | nulljob.salary_period?string | nulljob.schedule_type?string | nulljob.salary_currency?string | nulljob.work_life_score?integer | nulljob.description_html?string | nulljob.work_arrangement?string | nulljob.hours_per_week_max?integer | nulljob.hours_per_week_min?integer | nulljob.application_extra_fields?object[]companyobjectcompany.idstringcompany.namestringcompany.slugstringcompany.country?string | nullcompany.updated?string | nullcompany.benefits?object | nullcompany.category?string | nullcompany.inserted?string | nullcompany.logo_url?string | nullcompany.vacation?integer | nullcompany.verified?boolean | nullcompany.continent?string | nullcompany.employees?integer | nullcompany.company_url?string | nullcompany.description?string | nullcompany.flexibility?string | nullcompany.company_size?string | nullcompany.four_day_off?string | nullcompany.linkedin_url?string | nullcompany.remote_level?string | nullcompany.schedule_type?string | nullcompany.hires_worldwide?boolean | nullcompany.hours_full_time?integer | nullcompany.description_html?string | nullcompany.social_image_url?string | nullcompany.short_description?string | nullcompany.vacation_description?string | nullcompany.four_day_reference_url?string | nullcompany.flexibility_description?string | nullcompany.remote_team_description?string | nullcompany.schedule_type_description?string | nullsimilar_jobs?object[]similar_jobs[].idstringsimilar_jobs[].slug?string, default: similar_jobs[].level?string | nullsimilar_jobs[].stack?object[]similar_jobs[].stack[].id?string | nullsimilar_jobs[].stack[].name?string | nullsimilar_jobs[].stack[].slug?string | nullsimilar_jobs[].titlestringsimilar_jobs[].posted?integer | nullsimilar_jobs[].salary?string | nullsimilar_jobs[].company?objectsimilar_jobs[].company.id?string | nullsimilar_jobs[].company.name?string | nullsimilar_jobs[].company.slug?string | nullsimilar_jobs[].company.updated?string | nullsimilar_jobs[].company.inserted?string | nullsimilar_jobs[].company.logo_url?string | nullsimilar_jobs[].company.hires_worldwide?boolean | nullsimilar_jobs[].category?string | nullsimilar_jobs[].inserted?string | nullsimilar_jobs[].locations?object[]similar_jobs[].locations[].id?string | nullsimilar_jobs[].locations[].city?string | nullsimilar_jobs[].locations[].state?string | nullsimilar_jobs[].locations[].country?string | nullsimilar_jobs[].locations[].latitude?number | nullsimilar_jobs[].locations[].continent?string | nullsimilar_jobs[].locations[].longitude?number | nullsimilar_jobs[].locations[].is_primary?boolean | nullsimilar_jobs[].locations[].work_arrangement?string | nullsimilar_jobs[].timezones?string[]similar_jobs[].company_id?string, default: similar_jobs[].is_expired?boolean | nullsimilar_jobs[].company_name?string, default: similar_jobs[].salary_lower?integer | nullsimilar_jobs[].salary_upper?integer | nullsimilar_jobs[].salary_period?string | nullsimilar_jobs[].schedule_type?string | nullsimilar_jobs[].salary_currency?string | nullsimilar_jobs[].work_life_score?integer | nullsimilar_jobs[].work_arrangement?string | nullFields marked ? are optional.
GETLocations/locations
Resolve familiar place text to source location choices
Input
qRequiredQuery · stringPartial city, region, or place text accepted by the source autocomplete.
Example: New York
typeOptionalQuery · string | nullOptional source place type passed through to autocomplete.
Example: (cities)
Response
predictionsobject[]predictions[].place_idstringpredictions[].main_textstringpredictions[].descriptionstringpredictions[].secondary_text?string | nullFields marked ? are optional.
GETLocations resolve/locations/resolve
Resolve a returned place choice into a source location
Input
place_idRequiredQuery · stringplace_id returned unchanged by /locations.
Example: ChIJOwg_06VPwokRYv534QaPC8g
Response
locationobjectlocation.id?string | nulllocation.city?string | nulllocation.state?string | nulllocation.country?string | nulllocation.latitude?number | nulllocation.continent?string | nulllocation.longitude?number | nulllocation.is_primary?boolean | nulllocation.work_arrangement?string | nullFields 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.
An account is required to submit an extension. Prepare your request, then sign in to build.