# Apify Actors/Actor runs API

**Canonical:** https://apis.io/apis/apify/apify-actors-actor-runs-api/  
**Provider:** Apify — https://apis.io/providers/apify/  
**Base URL:** https://api.apify.com  
**Documentation:** https://apify.com

Apify Actors/Actor runs API is one of 42 APIs that [Apify](https://apis.io/providers/apify/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Actors/Actor runs. The published artifact set on APIs.io includes an OpenAPI specification.

The API endpoints in this section allow you to manage your Apify Actors runs. Some API endpoints return run objects. If a run object includes usage costs in dollars, note that these values are calculated based on your effective unit pricing at the time of the query. As a result, the dollar amounts should be treated as informational only and not as exact figures. For completed runs, aggregated fields such as `stats` or dollar usage totals are eventually consistent and update within a few seconds. For values that must match finalized totals, wait about 10 seconds after the run completed, then fetch the run again. For more information about platform usage and resource calculations, see the [Usage and Resources documentation](https://docs.apify.com/platform/actors/running/usage-and-resources#usage).

## Operations (11)

| Method | Path | Summary |
|---|---|---|
| GET | `/v2/actors/{actorId}/runs` | Get list of runs |
| POST | `/v2/actors/{actorId}/runs` | Run Actor |
| POST | `/v2/actors/{actorId}/run-sync` | Run Actor synchronously and return key-value store record |
| GET | `/v2/actors/{actorId}/run-sync` | Run Actor synchronously without input |
| POST | `/v2/actors/{actorId}/run-sync-get-dataset-items` | Run Actor synchronously and get dataset items |
| GET | `/v2/actors/{actorId}/run-sync-get-dataset-items` | Run Actor synchronously without input and get dataset items |
| POST | `/v2/actors/{actorId}/runs/{runId}/resurrect` | Resurrect run |
| GET | `/v2/actors/{actorId}/runs/last` | Get last run |
| GET | `/v2/actors/{actorId}/runs/{runId}` | Get run |
| POST | `/v2/actors/{actorId}/runs/{runId}/abort` | Abort run |
| POST | `/v2/actors/{actorId}/runs/{runId}/metamorph` | Metamorph run |

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/apify/openapi/apify-actors-actor-runs-api-openapi.yml

## Other Apify APIs (12)

- [Apify Actor Runs API](https://apis.io/apis/apify/apify-actor-runs-api/)
- [Apify Actors API](https://apis.io/apis/apify/apify-actors-api/)
- [Apify Datasets API](https://apis.io/apis/apify/apify-datasets-api/)
- [Apify Key-Value Stores API](https://apis.io/apis/apify/apify-key-value-stores-api/)
- [Apify Request Queues API](https://apis.io/apis/apify/apify-request-queues-api/)
- [Apify Users API](https://apis.io/apis/apify/apify-users-api/)
- [Apify Actor builds API](https://apis.io/apis/apify/apify-actor-builds-api/)
- [Apify Actor tasks API](https://apis.io/apis/apify/apify-actor-tasks-api/)
- [Apify Actors/Actor builds API](https://apis.io/apis/apify/apify-actors-actor-builds-api/)
- [Apify Actors/Actor versions API](https://apis.io/apis/apify/apify-actors-actor-versions-api/)
- [Apify Actors/Webhook collection API](https://apis.io/apis/apify/apify-actors-webhook-collection-api/)
- [Apify Default dataset API](https://apis.io/apis/apify/apify-default-dataset-api/)

## Tags

Actors/Actor runs

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/apify/apify-actors-actor-runs-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/apify/.