# Search Ashby jobs

Search, filter, and page through listed jobs on one public Ashby board.

- Platform: [Ashby Jobs](https://docs.upscrape.com/docs/platforms/ashby)
- Capability ID: `ashby.jobs.search`
- Cost: 1 credit per request
- Maximum runtime: 30 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 YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Prefer: wait=30" \
  --data '{
  "input": {
    "board_slug": "ashby",
    "max_pages": 1,
    "page": 1,
    "page_size": 5,
    "query": "Engineer"
  },
  "capability": "ashby.jobs.search"
}'
```

## Input

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `board_slug` | `string` | Yes | The final path segment from jobs.ashbyhq.com/<board_slug>. |
| `employment_type` | `string` | No | Ashby's public employment-type enum. |
| `location` | `string` | No | Case-insensitive text matched against primary and secondary locations. |
| `max_pages` | `integer` | No | Maximum number of consecutive local result pages to return. |
| `page` | `integer` | No |  |
| `page_size` | `integer` | No |  |
| `posted_after` | `string` | No | Return jobs published strictly after this RFC 3339 timestamp. |
| `query` | `string` | No | Case-insensitive text matched against title, department, team, and description. |
| `team` | `string` | No | Case-insensitive team filter. |
| `workplace_type` | `string` | No | Ashby's public workplace-type enum. |

### Example input

```json
{
  "board_slug": "ashby",
  "max_pages": 1,
  "page": 1,
  "page_size": 5,
  "query": "Engineer"
}
```

## 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 redacted fixture is an example, not a fixed response schema.

```json
{
  "board_slug": "ashby",
  "company": "Ashby",
  "has_more": true,
  "jobs": [
    {
      "address": {
        "country": "European Union"
      },
      "apply_url": "https://jobs.ashbyhq.com/ashby/7458d4e9-da2e-47bd-98cb-adfda43d42b2/application",
      "board_slug": "ashby",
      "collected_at": "2026-08-24T18:44:45.06671805Z",
      "company": "Ashby",
      "compensation": {
        "components": [
          {
            "interval": "NONE",
            "type": "EquityPercentage"
          },
          {
            "currency_code": "EUR",
            "interval": "1 YEAR",
            "type": "Bonus"
          },
          {
            "currency_code": "EUR",
            "interval": "1 YEAR",
            "maximum": 185000,
            "minimum": 110000,
            "type": "Salary"
          }
        ],
        "salary_summary": "€110K - €185K",
        "summary": "€110K – €185K • Offers Equity • Offers Bonus",
        "tiers": [
          {
            "components": [
              {
                "interval": "NONE",
                "type": "EquityPercentage"
              },
              {
                "currency_code": "EUR",
                "interval": "1 YEAR",
                "type": "Bonus"
              },
              {
                "currency_code": "EUR",
                "interval": "1 YEAR",
                "maximum": 185000,
                "minimum": 110000,
                "type": "Salary"
              }
            ],
            "id": "f1284fac-20e9-4ed0-9a10-776d526a636c",
            "summary": "€110K – €185K • Offers Equity • Offers Bonus",
            "title": "EU"
          }
        ]
      },
      "content_hash": "[redacted:token]",
      "department": "Engineering",
      "description": "[redacted:public-job-description]",
      "employment_type": "FullTime",
      "id": "7458d4e9-da2e-47bd-98cb-adfda43d42b2",
      "is_listed": true,
      "is_remote": true,
      "job_url": "https://jobs.ashbyhq.com/ashby/7458d4e9-da2e-47bd-98cb-adfda43d42b2",
      "location": "Remote - European Union",
      "published_at": "2024-03-04T14:29:08.532+00:00",
      "secondary_locations": [
        {
          "location": "Spain"
        },
        {
          "location": "Italy"
        },
        {
          "location": "Germany"
        }
      ],
      "team": "EMEA Engineering",
      "title": "Engineering Manager - EU",
      "workplace_type": "Remote"
    },
    {
      "address": {
        "country": "United States"
      },
      "apply_url": "https://jobs.ashbyhq.com/ashby/f40ef345-82a8-4956-9150-193b4fdf8183/application",
      "board_slug": "ashby",
      "collected_at": "2026-08-24T18:44:45.066820392Z",
      "company": "Ashby",
      "compensation": {
        "components": [
          {
            "interval": "1 YEAR",
            "type": "EquityPercentage"
          },
          {
            "currency_code": "USD",
            "interval": "1 YEAR",
            "maximum": 210000,
            "minimum": 150000,
            "type": "Salary"
          }
        ],
        "salary_summary": "$150K - $210K",
        "summary": "$150K – $210K • Offers Equity • Multiple Ranges",
        "tiers": [
          {
            "components": [
              {
                "interval": "NONE",
                "type": "EquityPercentage"
              },
              {
                "currency_code": "USD",
                "interval": "1 YEAR",
                "maximum": 210000,
                "minimum": 180000,
                "type": "Salary"
              }
            ],
            "id": "871fc919-3423-4f62-aa0a-d7e8889d8cd9",
            "summary": "$180K – $210K • Offers Equity",
            "title": "US: San Francisco & New York"
          },
          {
            "components": [
              {
                "interval": "NONE",
                "type": "EquityPercentage"
              },
              {
                "currency_code": "USD",
                "interval": "1 YEAR",
                "maximum": 190000,
                "minimum": 160000,
                "type": "Salary"
              }
            ],
            "id": "422b825b-a712-4462-a022-221032dfa1e7",
            "summary": "$160K – $190K • Offers Equity",
            "title": "US: LA, Boston, Seattle, D.C."
          },
          {
            "components": [
              {
                "interval": "NONE",
                "type": "EquityPercentage"
              },
              {
                "currency_code": "USD",
                "interval": "1 YEAR",
                "maximum": 180000,
                "minimum": 150000,
                "type": "Salary"
              }
            ],
            "id": "f4756289-eec4-4963-9d0e-c95a02806c07",
            "summary": "$150K – $180K • Offers Equity",
            "title": "US: All Other Locations"
          }
        ]
      },
      "content_hash": "[redacted:token]",
      "department": "Design",
      "description": "[redacted:public-job-description]",
      "employment_type": "FullTime",
      "id": "f40ef345-82a8-4956-9150-193b4fdf8183",
      "is_listed": true,
      "is_remote": true,
      "job_url": "https://jobs.ashbyhq.com/ashby/f40ef345-82a8-4956-9150-193b4fdf8183",
      "location": "Remote - US",
      "published_at": "2025-12-05T22:43:22.147+00:00",
      "secondary_locations": [
        {
          "location": "Austin"
        },
        {
          "location": "Los Angeles"
        },
        {
          "location": "Portland"
        }
      ],
      "team": "Design",
      "title": "Senior Product Designer",
      "workplace_type": "Remote"
    },
    {
      "address": {
        "country": "United Kingdom"
      },
      "apply_url": "https://jobs.ashbyhq.com/ashby/d573471b-2005-482c-9fbf-d1df9550cb57/application",
      "board_slug": "ashby",
      "collected_at": "2026-08-24T18:44:45.066853283Z",
      "company": "Ashby",
      "compensation": {
        "components": [
          {
            "interval": "NONE",
            "maximum": 0.16,
            "type": "EquityPercentage"
          },
          {
            "currency_code": "GBP",
            "interval": "1 YEAR",
            "maximum": 200000,
            "minimum": 110000,
            "type": "Salary"
          }
        ],
        "salary_summary": "£110K - £200K",
        "summary": "£110K – £200K",
        "tiers": [
          {
            "components": [
              {
                "currency_code": "GBP",
                "interval": "1 YEAR",
                "maximum": 200000,
                "minimum": 110000,
                "type": "Salary"
              }
            ],
            "id": "e4d74e59-a5e9-4d24-b85f-6c40b5fa4674",
            "summary": "£110K – £200K",
            "title": "UK"
          }
        ]
      },
      "content_hash": "[redacted:token]",
      "department": "Engineering",
      "description": "[redacted:public-job-description]",
      "employment_type": "FullTime",
      "id": "d573471b-2005-482c-9fbf-d1df9550cb57",
      "is_listed": true,
      "is_remote": true,
      "job_url": "https://jobs.ashbyhq.com/ashby/d573471b-2005-482c-9fbf-d1df9550cb57",
      "location": "United Kingdom",
      "published_at": "2025-04-01T14:39:51.428+00:00",
      "secondary_locations": [
        {
          "location": "Cardiff"
        },
        {
          "location": "Birmingham"
        },
        {
          "location": "Bristol"
        }
      ],
      "team": "EMEA Engineering",
      "title": "Engineering Manager - UK",
      "workplace_type": "Remote"
    }
  ],
  "max_pages": 1,
  "next_page": 2,
  "page": 1,
  "page_size": 5,
  "pages_returned": 1,
  "total_pages": 10,
  "total_results": 46
}
```
### Illustrative output fields

Derived from the sample above for orientation only. These fields are not a fixed response schema.

| Path | Observed type | Example |
| --- | --- | --- |
| `board_slug` | `string` | ashby |
| `company` | `string` | Ashby |
| `has_more` | `boolean` | true |
| `jobs` | `array` | 3 items |
| `jobs` | `array` | 3 items |
| `max_pages` | `integer` | 1 |
| `next_page` | `integer` | 2 |
| `page` | `integer` | 1 |
| `page_size` | `integer` | 5 |
| `pages_returned` | `integer` | 1 |
| `total_pages` | `integer` | 10 |
| `total_results` | `integer` | 46 |

## 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)
