# Nurse Jobs in the US API (`aspen-technology-labs-inc/nurse-jobs-us-api`) Actor

Find US nursing job postings by role, location, company, salary, posting age, employment type, and seniority. Built for nurse recruiting, workforce research, and healthcare labor-market analysis.

- **URL**: https://apify.com/aspen-technology-labs-inc/nurse-jobs-us-api.md
- **Developed by:** [Aspen Technology Labs, Inc.](https://apify.com/aspen-technology-labs-inc) (community)
- **Categories:** Jobs, Developer tools, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.20 / 1,000 job records

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## US Nursing Jobs API - JobsIndex by Aspen Tech Labs

Access US nursing jobs through the JobsIndex API, built by Aspen Tech Labs. JobsIndex aggregates 6M+ active US job listings daily from over 175K employer source sites, sourced directly from company career pages and ATS platforms, not scraped from job boards. The nursing job category alone covers over 650,000 active US job postings from 18,500+ unique employer domains, updated every day.

Approximately 60% of nursing jobs come directly from employers such as health systems and hospital networks such as Trinity Health, DaVita, and Addus, with the remaining 40% sourced from recruitment agencies and staffing firms. This gives you full market coverage across both direct-hire and agency-sourced nursing roles.

This Actor covers the full breadth of US nurse and nursing roles, from registered nurse (RN) and licensed practical nurse (LPN) to nurse practitioner, LVN, nurse anesthetist, and travel nurse positions. Within each role type, data is organized into granular subcategories by specialty: cardiology, critical care, behavioral health, dialysis, bone marrow, brain injury, correctional, and many more. Travel nurse variants are also included across role types.

This Actor serves two primary use cases: teams that want to publish nursing job listings on their platform, and teams that need structured nursing workforce data for matching algorithms, AI model training, or healthcare workforce intelligence.

### What You Can Use It For

- Power a niche healthcare job board, nurse recruiting platform, or niche travel nurse jobs site with fresh jobs across all major US nursing roles and specialties
- Feed a matching platform with structured nursing data, filterable by role, subcategory, location, salary, or posting age
- Monitor nursing hiring demand across US states, cities, and metro areas, useful for healthcare workforce planning, market research, or sales intelligence
- Analyze advertised salary and seniority signals across RN, LPN, NP, and travel nurse roles by location and specialty
- Collect structured US nursing jobs for training datasets, research, or product development

### Built-In Search Preset

This Actor is fixed internally to `country=United States` and `category=Nursing`. Both fields are shown in the input example, and the runtime always enforces those values even if different values are submitted. Users can narrow the search by nursing role, location, salary, company, posting age, employment type, or seniority.

### Quick Start

```json
{
  "title": "nurse",
  "size": 5
}
````

### Input Parameters

| Parameter | Description | Example |
|---|---|---|
| `salary` | Salary amount or range filter. | `20h-30h` |
| `what` | Main job search query. Supports keywords, boolean logic, exact phrases, and field-targeted search such as `@title registered nurse` or `@(title,description) (ICU)`. | `nurse` |
| `where` | Free-text location search. Supports place names, boolean logic, and field-targeted search such as `@country United States` or `@(city,metro_area) (Denver)`. Prefer structured location fields for exact filters. | `Boston` |
| `country` | Fixed preset. Runtime always uses `United States`; changes are ignored. | `United States` |
| `region` | State, province, or region. | `California` |
| `city` | City filter. | `New York` |
| `postal_code` | Postal or ZIP code filter. | `90210` |
| `metro_area` | Metropolitan area filter. | `Denver-Aurora-Centennial, CO` |
| `title` | Job title filter. | `Registered Nurse` |
| `company_name` | Company name filter. | `Mayo Clinic` |
| `company_domain` | Company website domain. | `mayoclinic.org` |
| `category` | Fixed preset. Runtime always uses `Nursing`; changes are ignored. | `Nursing` |
| `sub_category` | More specific nursing role. | `Registered Nurse` |
| `industry` | Company industry filter. | `Health Care Services` |
| `posted` | Relative posting age or ISO date. | `1w` |
| `employment_type` | Employment type. | `Full-Time` |
| `remote` | Work arrangement filter. Supported values: `remote`, `on-site`, `hybrid`. | `remote` |
| `seniority` | Seniority level. | `Senior` |
| `page` | Page number, starting from 0. | `0` |
| `size` | Number of results per page. Default 5, min 1, max 100. | `5` |

### Salary Filter Format

Use:

```text
NUMBER[UNIT]
```

or:

```text
NUMBER[UNIT]-NUMBER[UNIT]
```

Supported units:

- `h` - per hour
- `d` - per day
- `w` - per week
- `m` - per month
- `y` - per year

Examples:

- `20h-30h` - hourly rate between 20 and 30
- `35h` - fixed hourly rate
- `20h-200000y` - range from hourly to yearly comparison

### Advanced Filters

`what` and `where` support plain-text search, boolean logic, and field-targeted search.

If no field is provided, the API expands the search across a default set of relevant fields.

Plain keyword examples:

```text
what = registered nurse OR travel nurse
where = United States
```

Field-specific examples:

```text
what = @title registered nurse OR travel nurse
where = @country United States
```

Multi-field examples:

```text
what = @(title,description) (ICU)
what = @(title,title_raw,description) (registered nurse OR travel nurse)
what = @(title,description) (nurse AND practitioner)

where = @(country,region,city,metro_area,county,sub_city) (United States)
where = @(city,region,metro_area) (San Francisco OR California)
where = @(city,region,metro_area) (California)
```

When using `where`, avoid sending separate structured location parameters for the same request unless you want those structured parameters to take priority. For example, `country`, `region`, `city`, `postal_code`, and `metro_area` can override or narrow `where`.

Common job/content fields for `what`:

- `title`, `title_raw`, `description`, `reference`
- `category`, `sub_category`, `seniority`, `industry`, `company_type`
- `company_name`, `company_domain`, `company_name_raw`
- `employment_type`, `remote`, `language`
- `posted`, `posted_raw`, `expired`
- `url_source`, `url_apply`
- `salary_value`, `salary_currency`, `salary_unit`
- `id`

Common location fields for `where`:

- `country`, `region`, `city`, `metro_area`, `county`, `sub_city`, `postal_code`

### Location Filtering

For precise location matching, use structured filters exposed for this Actor:

- `region`
- `city`
- `postal_code`
- `metro_area`

Use `where` only as a free-text location search when the structured location filters above are not set. If `where` is provided together with structured location filters, the structured filters take priority and `where` may be ignored or deprioritized.

### Limits and Pagination

This Actor uses the JobsIndex jobs API. Results are paginated with `page` and `size`.

| Parameter | Default | Min | Max |
|---|---:|---:|---|
| `page` | 0 | 0 | Depends on `size` and the item cap |
| `size` | 5 | 1 | 100 |

Invalid `page` or `size` values can return `400 Invalid page or size parameters`.

#### Item Caps

The maximum number of retrievable jobs depends on the query shape:

| Query shape | Max items | Effective max `size` | Over-size behavior |
|---|---:|---:|---|
| No company filter | 1000 | 100 | Validation error; not silently capped |
| Company filter with the Actor preset and/or another keyword or filter | 20 | 20 | Silent cap with capping metadata |

A company filter means `company_name`, `company_domain`, or a company field referenced inside `what`. Another keyword or filter means anything in `what` other than `company_*`, or a value in fields such as `title`, `category`, `sub_category`, `industry`, `posted`, `salary`, `employment_type`, or `seniority` where available on this Actor.

Because this Actor always applies the built-in `country=United States` and `category=Nursing` preset, company-filtered requests are treated as company plus an additional filter and use the 20-item effective cap.

When a company-filtered request asks for `size` greater than the effective cap, the API returns up to the capped number of results instead of erroring. The response metadata includes:

- `size_requested` - the original requested `size`
- `size_capped_by` - `"company|keywords"` for the 20-item cap

On uncapped responses, `size_requested` and `size_capped_by` are not present.

No-company-filter requests are not silently capped. If the request exceeds the 1000-item retrieval window, the API can return `400 Item limit reached. Maximum of 1000 items can be retrieved`.

#### Free-Text Query Limits

`what` and, where available, `where` support advanced matching syntax but have safety limits:

| Limit | Value | Error behavior |
|---|---:|---|
| Raw URL length before decoding | 700 characters | `400 'what' or 'where' parameters exceed 700 characters` |
| Decoded text length | 500 characters | `400 MATCH input exceeds length limit` |
| Combined operator characters: `?`, `+`, pipe, `@` | 20 | `400 Too many MATCH operators` |
| Unsafe SQL-like keywords | blocked | `400 Unsafe MATCH expression` |

Unsupported characters may be normalized before search. Unbalanced quotes and trailing `@` characters may be stripped.

#### Field Validation

Invalid filter values can return `400 Invalid value for parameter: <name>`. Common validation examples include malformed company domains, invalid dates or relative `posted` values, invalid salary format, invalid job IDs, unsupported location formats, or overly long field values.

### Output

Each run stores job records in the default Apify dataset. The dataset schema includes an `Overview` table for the most useful fields and a `Raw data (all fields)` table for the complete JobsIndex record.

Example dataset item:

```json
{
  "id": "3956505510037809027",
  "title": "Registered Nurse - Emergency Room",
  "company_name": "Example Health System",
  "category": "Nursing",
  "sub_category": "Registered Nurse",
  "country": "United States",
  "region": "Texas",
  "city": "Fort Worth",
  "salary_value": "42.00-55.00",
  "salary_currency": "USD",
  "salary_unit": "HOUR",
  "employment_type": "Full-Time",
  "remote": "remote",
  "posted": "2026-04-20",
  "url_apply": "https://example.com/apply"
}
```

Field availability depends on the source job posting.

### Custom Jobs Data

For custom job data needs, bulk downloads, or tailored job feeds, contact us via our [website](https://jobsindex.com/) or by [email](mailto:inquiry+apify@aspentechlabs.com). You can also explore [JobMarketPulse](https://jobmarketpulse.com/), our next-generation labor and job market intelligence platform.

# Actor input Schema

## `salary` (type: `string`):

Salary amount/range filter. Format: 1-9 digits followed by y, m, w, d, or h; optional range A-B. Examples: 20h-30h, 35h, 20h-200000y.

## `what` (type: `string`):

Main job search query. Supports keywords, exact phrases, boolean logic (AND, OR, NOT or &, |, !), and field targeting. Maximum 700 raw URL chars or 500 decoded chars. Examples: python developer OR junior javascript, "data scientist", @(title) (manager).

## `where` (type: `string`):

Free-text location search. Use only when structured location fields such as country, region, city, postal\_code, or metro\_area are not set; structured fields take priority. Maximum 700 raw URL chars or 500 decoded chars.

## `country` (type: `string`):

Fixed preset for this Actor. The runtime always uses United States; changing this value in input is ignored.

## `region` (type: `string`):

State, province, or region. Maximum 80 characters.

## `city` (type: `string`):

City filter. Maximum 100 characters.

## `postal_code` (type: `string`):

Postal or ZIP code. Maximum 20 characters.

## `metro_area` (type: `string`):

Metropolitan area filter. Maximum 100 characters. Example: Denver-Aurora-Centennial, CO.

## `title` (type: `string`):

Job title filter. Maximum 200 characters.

## `company_name` (type: `string`):

Company name filter. Company filters reduce the retrievable item cap; see README.

## `company_domain` (type: `string`):

Company website domain in valid DNS form, for example ibm.com. Company filters reduce the retrievable item cap; see README.

## `category` (type: `string`):

Fixed preset for this Actor. The runtime always uses Nursing; changing this value in input is ignored.

## `sub_category` (type: `string`):

More specific nursing role. Examples include Registered Nurse, Licensed Practical Nurse, and Nurse Practitioner.

## `industry` (type: `string`):

Company industry. Maximum 100 characters. Example: Food Products or Hotels and Restaurants.

## `posted` (type: `string`):

Relative posting age, such as 1h, 1d, 1w, 1m, or an ISO date: YYYY, YYYY-MM, YYYY-MM-DD.

## `employment_type` (type: `string`):

Employment type, for example Full-Time. Comma-separated values are supported; each value can be up to 31 characters.

## `remote` (type: `string`):

Work arrangement filter. Supported values: remote, on-site, hybrid.

## `seniority` (type: `string`):

Seniority level, for example Junior, Middle, Senior. Comma-separated values are supported; each value can be up to 31 characters.

## `page` (type: `integer`):

Page number. Starts from 0. Pagination is capped by query shape: no company filter up to 1000 items, company filter with another filter up to 20 items, company filter only up to 5 items.

## `size` (type: `integer`):

Number of results per page. Default 5, min 1, max 100. Effective maximum can be lower for company-filtered queries; see README.

## Actor input object example

```json
{
  "salary": "",
  "what": "",
  "where": "",
  "country": "United States",
  "region": "",
  "city": "",
  "postal_code": "",
  "metro_area": "",
  "title": "",
  "company_name": "",
  "company_domain": "",
  "category": "Nursing",
  "sub_category": "",
  "industry": "",
  "posted": "",
  "employment_type": "",
  "remote": "",
  "seniority": "",
  "page": 0,
  "size": 5
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `meta` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("aspen-technology-labs-inc/nurse-jobs-us-api").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("aspen-technology-labs-inc/nurse-jobs-us-api").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call aspen-technology-labs-inc/nurse-jobs-us-api --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=aspen-technology-labs-inc/nurse-jobs-us-api",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Nurse Jobs in the US API",
        "description": "Find US nursing job postings by role, location, company, salary, posting age, employment type, and seniority. Built for nurse recruiting, workforce research, and healthcare labor-market analysis.",
        "version": "0.1",
        "x-build-id": "IvVb0uYzfI38uj9ry"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/aspen-technology-labs-inc~nurse-jobs-us-api/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-aspen-technology-labs-inc-nurse-jobs-us-api",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/aspen-technology-labs-inc~nurse-jobs-us-api/runs": {
            "post": {
                "operationId": "runs-sync-aspen-technology-labs-inc-nurse-jobs-us-api",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/aspen-technology-labs-inc~nurse-jobs-us-api/run-sync": {
            "post": {
                "operationId": "run-sync-aspen-technology-labs-inc-nurse-jobs-us-api",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "salary": {
                        "title": "Salary filter",
                        "type": "string",
                        "description": "Salary amount/range filter. Format: 1-9 digits followed by y, m, w, d, or h; optional range A-B. Examples: 20h-30h, 35h, 20h-200000y.",
                        "default": ""
                    },
                    "what": {
                        "title": "Job search query",
                        "type": "string",
                        "description": "Main job search query. Supports keywords, exact phrases, boolean logic (AND, OR, NOT or &, |, !), and field targeting. Maximum 700 raw URL chars or 500 decoded chars. Examples: python developer OR junior javascript, \"data scientist\", @(title) (manager).",
                        "default": ""
                    },
                    "where": {
                        "title": "Free-text location query",
                        "type": "string",
                        "description": "Free-text location search. Use only when structured location fields such as country, region, city, postal_code, or metro_area are not set; structured fields take priority. Maximum 700 raw URL chars or 500 decoded chars.",
                        "default": ""
                    },
                    "country": {
                        "title": "Country",
                        "type": "string",
                        "description": "Fixed preset for this Actor. The runtime always uses United States; changing this value in input is ignored.",
                        "default": "United States"
                    },
                    "region": {
                        "title": "Region",
                        "type": "string",
                        "description": "State, province, or region. Maximum 80 characters.",
                        "default": ""
                    },
                    "city": {
                        "title": "City",
                        "type": "string",
                        "description": "City filter. Maximum 100 characters.",
                        "default": ""
                    },
                    "postal_code": {
                        "title": "Postal code",
                        "type": "string",
                        "description": "Postal or ZIP code. Maximum 20 characters.",
                        "default": ""
                    },
                    "metro_area": {
                        "title": "Metro area",
                        "type": "string",
                        "description": "Metropolitan area filter. Maximum 100 characters. Example: Denver-Aurora-Centennial, CO.",
                        "default": ""
                    },
                    "title": {
                        "title": "Job title",
                        "type": "string",
                        "description": "Job title filter. Maximum 200 characters.",
                        "default": ""
                    },
                    "company_name": {
                        "title": "Company name",
                        "type": "string",
                        "description": "Company name filter. Company filters reduce the retrievable item cap; see README.",
                        "default": ""
                    },
                    "company_domain": {
                        "title": "Company domain",
                        "type": "string",
                        "description": "Company website domain in valid DNS form, for example ibm.com. Company filters reduce the retrievable item cap; see README.",
                        "default": ""
                    },
                    "category": {
                        "title": "Category",
                        "type": "string",
                        "description": "Fixed preset for this Actor. The runtime always uses Nursing; changing this value in input is ignored.",
                        "default": "Nursing"
                    },
                    "sub_category": {
                        "title": "Sub-category",
                        "type": "string",
                        "description": "More specific nursing role. Examples include Registered Nurse, Licensed Practical Nurse, and Nurse Practitioner.",
                        "default": ""
                    },
                    "industry": {
                        "title": "Industry",
                        "type": "string",
                        "description": "Company industry. Maximum 100 characters. Example: Food Products or Hotels and Restaurants.",
                        "default": ""
                    },
                    "posted": {
                        "title": "Posted time frame",
                        "type": "string",
                        "description": "Relative posting age, such as 1h, 1d, 1w, 1m, or an ISO date: YYYY, YYYY-MM, YYYY-MM-DD.",
                        "default": ""
                    },
                    "employment_type": {
                        "title": "Employment type",
                        "type": "string",
                        "description": "Employment type, for example Full-Time. Comma-separated values are supported; each value can be up to 31 characters.",
                        "default": ""
                    },
                    "remote": {
                        "title": "Remote / work arrangement",
                        "enum": [
                            "",
                            "remote",
                            "on-site",
                            "hybrid"
                        ],
                        "type": "string",
                        "description": "Work arrangement filter. Supported values: remote, on-site, hybrid.",
                        "default": ""
                    },
                    "seniority": {
                        "title": "Seniority",
                        "type": "string",
                        "description": "Seniority level, for example Junior, Middle, Senior. Comma-separated values are supported; each value can be up to 31 characters.",
                        "default": ""
                    },
                    "page": {
                        "title": "Page number",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Page number. Starts from 0. Pagination is capped by query shape: no company filter up to 1000 items, company filter with another filter up to 20 items, company filter only up to 5 items.",
                        "default": 0
                    },
                    "size": {
                        "title": "Page size",
                        "minimum": 1,
                        "maximum": 100,
                        "type": "integer",
                        "description": "Number of results per page. Default 5, min 1, max 100. Effective maximum can be lower for company-filtered queries; see README.",
                        "default": 5
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
