# Search Greenhouse jobs Search and filter a public Greenhouse board with bounded local pagination. - Platform: [Greenhouse Jobs](https://docs.upscrape.com/docs/platforms/greenhouse) - Capability ID: `greenhouse.jobs.search` - Cost: 1 credit per request - Maximum runtime: 45 seconds - Execute endpoint: `POST https://data.upscrape.com/execute` ## Request Use the exact public capability ID in the shared execute envelope. ```bash curl --request POST \ --url https://data.upscrape.com/execute \ --header "Authorization: Bearer $UPSCRAPE_API_KEY" \ --header "Content-Type: application/json" \ --header "Prefer: wait=30" \ --data '{ "input": { "board": "airbnb", "include_content": false, "include_questions": false, "page": 1, "per_page": 3, "query": "engineer", "remote_only": false }, "capability": "greenhouse.jobs.search" }' ``` ## Input | Field | Type | Required | Description | | --- | --- | --- | --- | | `board` | `string` | Yes | Public US Greenhouse board token or HTTPS boards.greenhouse.io / job-boards.greenhouse.io board, job, or embed URL. Custom domains and EU URLs are not resolved. | | `departments` | `array` | No | Case-insensitive exact department names; a job may match any supplied value. | | `include_content` | `boolean` | No | Include normalized plain-text description and decoded description_html. HTML is untrusted and must be sanitized before rendering. Default: `false`. | | `include_questions` | `boolean` | No | Hydrate general, location, demographic, and compliance form definitions for the returned page; adds one detail request per returned job. Default: `false`. | | `location` | `string` | No | Case-insensitive substring of the published job location, applied locally before pagination. | | `offices` | `array` | No | Case-insensitive exact office names; a job may match any supplied value. | | `page` | `integer` | No | One-based page applied locally after filtering. From 1 to 10000. Default: `1`. | | `per_page` | `integer` | No | Maximum matching jobs returned on this page. From 1 to 100. Default: `25`. | | `published_after` | `string` | No | Inclusive lower publication bound as YYYY-MM-DD or RFC3339. | | `published_before` | `string` | No | Inclusive upper publication bound as YYYY-MM-DD or RFC3339. | | `query` | `string` | No | Case-insensitive text matched against title, company, location, departments, offices, and included content. | | `remote_only` | `boolean` | No | Prefer explicit Workplace Type metadata: Remote is included; Hybrid/Onsite is excluded. Otherwise infer from public title, location, or included description. Default: `false`. | ### Example input ```json { "board": "airbnb", "include_content": false, "include_questions": false, "page": 1, "per_page": 3, "query": "engineer", "remote_only": false } ``` ## Response Successful output is returned in `results[0].data`. Raw platform output is intentionally open-ended and may evolve with the upstream source. ### Illustrative sample output This example shows one response. Values and optional fields vary with the data available. ```json { "board": "airbnb", "has_more": true, "jobs": [ { "absolute_url": "https://careers.airbnb.com/positions/8074765?gh_jid=8074765", "company_name": "Airbnb", "data_compliance": [ { "demographic_data_consent_applies": false, "requires_consent": false, "requires_processing_consent": false, "requires_retention_consent": false, "type": "gdpr" } ], "employer_workplace_type": "Remote", "id": "8074765", "internal_job_id": "3498553", "language": "en", "location": "United States", "metadata": [ { "id": "9245691", "name": "Is this job part of ACC?", "value": false, "value_type": "yes_no" }, { "id": "10216612", "name": "Workplace Type", "value": "Remote", "value_type": "single_select" } ], "published_at": "2026-07-21T12:57:59-04:00", "remote": true, "remote_basis": "employer_declared", "requisition_id": "ONE", "title": "Engineering Manager, Cloud & Data Security", "updated_at": "2026-07-21T12:57:59-04:00" }, { "absolute_url": "https://careers.airbnb.com/positions/7760914?gh_jid=7760914", "company_name": "Airbnb", "data_compliance": [ { "demographic_data_consent_applies": false, "requires_consent": false, "requires_processing_consent": false, "requires_retention_consent": false, "type": "gdpr" } ], "employer_workplace_type": "Remote", "id": "7760914", "internal_job_id": "3400214", "language": "en", "location": "China", "metadata": [ { "id": "9245691", "name": "Is this job part of ACC?", "value": false, "value_type": "yes_no" }, { "id": "10216612", "name": "Workplace Type", "value": "Remote", "value_type": "single_select" } ], "published_at": "2026-03-29T21:47:23-04:00", "remote": true, "remote_basis": "employer_declared", "requisition_id": "ONE", "title": "Engineering Manager, Community Support Engineering", "updated_at": "2026-07-24T02:38:03-04:00" }, { "absolute_url": "https://careers.airbnb.com/positions/7532824?gh_jid=7532824", "company_name": "Airbnb", "data_compliance": [ { "demographic_data_consent_applies": false, "requires_consent": false, "requires_processing_consent": false, "requires_retention_consent": false, "type": "gdpr" } ], "employer_workplace_type": "Hybrid", "id": "7532824", "internal_job_id": "3336258", "language": "en", "location": "London, United Kingdom", "metadata": [ { "id": "9245691", "name": "Is this job part of ACC?", "value": false, "value_type": "yes_no" }, { "id": "10216612", "name": "Workplace Type", "value": "Hybrid", "value_type": "single_select" } ], "published_at": "2026-01-23T11:33:08-05:00", "remote": false, "remote_basis": "employer_declared", "requisition_id": "ONE", "title": "Engineering Manager, Guest & Host", "updated_at": "2026-07-28T13:05:25-04:00" } ], "page": 1, "per_page": 3, "query": "engineer", "total_matches": 53 } ``` ### Illustrative output fields Derived from the sample above for orientation only. These fields are not a fixed response schema. | Path | Observed type | Example | | --- | --- | --- | | `board` | `string` | airbnb | | `has_more` | `boolean` | true | | `jobs` | `array` | 3 items | | `jobs` | `array` | 3 items | | `page` | `integer` | 1 | | `per_page` | `integer` | 3 | | `query` | `string` | engineer | | `total_matches` | `integer` | 53 | ## Execution behavior A `200` response completed inline. A `202` response was queued; poll `GET /jobs/{id}` until the job reaches `completed` or `failed`. Use an `Idempotency-Key` when retrying must not create a duplicate logical job. ## Related documentation - [Authentication](https://docs.upscrape.com/docs/api/authentication) - [Jobs and results](https://docs.upscrape.com/docs/api/jobs) - [Errors and retries](https://docs.upscrape.com/docs/api/errors) - [Idempotency](https://docs.upscrape.com/docs/api/idempotency)