ToolzerHub Docs

Search jobs (v1)

Returns startup job postings for role, location, or both — at least one is required. Slugs are lowercase-hyphenated, exactly as in a wellfound.com URL (software-engineer, san-francisco). remote is valid only on a role-only search; combined with location it is rejected.

1 credit / requestBilled only on success
GET
/v1/wellfound/jobs/search

Authorization

ApiKeyAuth
x-api-key<token>

In: header

Query Parameters

role?string

Wellfound role slug, as it appears in a /role/ URL. At least one of role or location is required.

Length1 <= length
location?string

Wellfound location slug, as it appears in a /location/ URL. At least one of role or location is required.

Length1 <= length
remote?boolean

Restrict to remote postings. Only valid on a role-only search — Wellfound has no remote variant of the location or role+location pages, so combining remote with location is rejected rather than silently ignored.

Defaultfalse
page?integer

Page of job rows to return. Send the previous response's next_page.

Range1 <= value <= 200
Default1
curl -X GET "https://example.com/v1/wellfound/jobs/search" \  -H "x-api-key: YOUR_API_KEY"
{  "data": {    "jobs": [      {        "id": "3061448",        "title": "Senior Software Engineer",        "slug": "senior-software-engineer",        "description": "string",        "compensation": "$110k – $155k",        "jobType": "full-time",        "remote": true,        "remoteConfig": null,        "locationNames": [          "San Francisco",          "New York City"        ],        "acceptedRemoteLocationNames": [          "string"        ],        "primaryRoleTitle": "Software Engineer",        "yearsExperienceMin": 3,        "yearsExperienceMax": 7,        "liveStartAt": 1755216000,        "atsSource": "AtsIntegration::Greenhouse::Listing",        "startup": {          "name": "Anthropic",          "id": "1234567",          "slug": "anthropic",          "logoUrl": "string",          "highConcept": "AI safety and research company",          "companySize": "SIZE_51_200",          "badges": [            null          ],          "property1": null,          "property2": null        },        "property1": null,        "property2": null      }    ],    "startups": [      {        "name": "Anthropic",        "id": "1234567",        "slug": "anthropic",        "logoUrl": "string",        "highConcept": "AI safety and research company",        "companySize": "SIZE_51_200",        "badges": [          null        ],        "property1": null,        "property2": null      }    ],    "count": 40,    "has_more": true,    "page": 1,    "next_page": 2  },  "details": {    "reason": "no_results",    "message": "string"  }}