Get an Actor run's results

Get an Actor run's results

Returns the items an Actor run saved to a dataset, such as scraped records, a page at a time.

Pass the dataset ID the run returned (defaultDatasetId on the run object) and page with limit and offset. The API and the CLI can also return the items as CSV, JSONL, XLSX and other formats.

Set up

Use the first option your agent supports.

MCP (official, remote)

Add this server to your agent's MCP settings, then sign in when asked.

{ "mcpServers": { "apify": { "url": "https://mcp.apify.com" } } }

Call the MCP tool get-dataset-items.

Server URL: https://mcp.apify.com

CLI (official)

Install the command, then confirm it runs.

npm install -g apify-cli
apify --version

Run apify datasets get-items.

API (official)

• Base URL: https://api.apify.com/v2
• Endpoint: GET /datasets/{datasetId}/items
• Auth: send the header Authorization: Bearer $APIFY_TOKEN
• Get a key: https://console.apify.com/settings/integrations
• Docs: https://docs.apify.com/api/v2

Before doing anything else, make one read-only call to confirm access.

Rules

• Ask the user before anything that sends messages, costs money, or changes data.
• Never print API keys.