Actor builds6

Actor runs10

Actor tasks15

Actors9

Actors/Actor builds6

Actors/Actor runs11

Actors/Actor versions13

Actors/Webhook collection1

Default dataset6

Default key-value store9

Default request queue15

Last Actor run's abort1

Last Actor run's default dataset6

Last Actor run's default key-value store9

Last Actor run's default request queue15

Last Actor run's log1

Last Actor run's metamorph1

Last Actor run's reboot1

Last Actor task run's abort1

Last Actor task run's default dataset6

Last Actor task run's default key-value store9

Last Actor task run's default request queue15

Last Actor task run's log1

Last Actor task run's metamorph1

Last Actor task run's reboot1

Logs1

Schedules7

Storage/Datasets9

Storage/Key-value stores12

Storage/Request queues7

Storage/Request queues/Requests5

Storage/Request queues/Requests locks5

Store1

Tools4

Tools/Encoding2

Users5

Users/Usage6

Webhooks/Webhook dispatches2

Webhooks/Webhooks7

Actors

Get list of Actors

Changed on Oct 27, 2026

Gets the list of all Actors that the user created or used. The response is a list of objects, where each object contains a basic information about a single Actor.

To only get Actors created by the user, add the my=1 query parameter.

The endpoint supports pagination using the limit and offset parameters and it will not return more than 1000 records.

By default, the records are sorted by the createdAt field in ascending order, therefore you can use pagination to incrementally fetch all Actors while new ones are still being created. To sort the records in descending order, use the desc=1 parameter.

You can also sort by your last run by using the sortBy=stats.lastRunStartedAt query parameter. In this case, descending order means the most recently run Actor appears first.

get/v2/actors

Request

Base URL
https://api.apify.com
Auth
- HTTP bearer
- or API key in query parameter token

Query parameters

myboolean

Example:true

If true or 1 then the returned list only contains Actors owned by the user. The default value is false.

offsetnumber double

Number of items that should be skipped at the start. The default value is 0.

limitnumber double

Example:1000

Maximum number of items to return. The default value as well as the maximum is 1000.

descboolean

Example:true

If true or 1 then the objects are sorted by the createdAt field in descending order. By default, they are sorted in ascending order.

sortBy'createdAt' | 'stats.lastRunStartedAt'

Example:createdAt

Field to sort the records by. The default is createdAt. You can also use stats.lastRunStartedAt to sort by the most recently ran Actors.

Response

Example response

{
  "data": {
    "total": 1,
    "limit": 1000,
    "count": 1,
    "items": [
      {
        "id": "br9CKmk457",
        "createdAt": "2019-10-29T07:34:24.202Z",
        "modifiedAt": "2019-10-30T07:34:24.202Z",
        "name": "MyAct",
        "username": "janedoe",
        "title": "Hello World Example",
        "stats": {
          "totalBuilds": 9,
          "totalRuns": 16,
          "totalUsers": 6,
          "totalUsers7Days": 2,
          "totalUsers30Days": 6,
          "totalUsers90Days": 6,
          "totalMetamorphs": 2,
          "lastRunStartedAt": "2019-07-08T14:01:05.546Z",
          "actorReviewCount": 69,
          "actorReviewRating": 4.7,
          "bookmarkCount": 1269,
          "publicActorRunStats30Days": {
            "ABORTED": 2542,
            "FAILED": 1234,
            "SUCCEEDED": 732805,
            "TIMED-OUT": 12556,
            "TOTAL": 749137
          }
        }
      }
    ]
  }
}

Changes

Oct 27, 2026ec76185eb934 Revision changes
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
Oct 20, 202616b486b0397a Revision changes
- warning
  added the new full-permissions-require-verified-owner enum value to the / response property for the response status
- warning
  added the new full-permissions-require-verified-owner enum value to the / response property for the response status
- warning
  added the new full-permissions-require-verified-owner enum value to the / response property for the response status
- warning
  added the new full-permissions-require-verified-owner enum value to the / response property for the response status
- warning
  added the new full-permissions-require-verified-owner enum value to the / response property for the response status
- warning
  added the new input-validation-timed-out enum value to the / response property for the response status
- warning
  added the new input-validation-timed-out enum value to the / response property for the response status
- warning
  added the new input-validation-timed-out enum value to the / response property for the response status
- warning
  added the new input-validation-timed-out enum value to the / response property for the response status
- warning
  added the new input-validation-timed-out enum value to the / response property for the response status
- warning
  added the new mcp-connector-actor-not-allowed enum value to the / response property for the response status
- warning
  added the new mcp-connector-actor-not-allowed enum value to the / response property for the response status
- warning
  added the new mcp-connector-actor-not-allowed enum value to the / response property for the response status
- warning
  added the new mcp-connector-actor-not-allowed enum value to the / response property for the response status
- warning
  added the new mcp-connector-actor-not-allowed enum value to the / response property for the response status
- warning
  added the new more-public-actors-require-verified-owner enum value to the / response property for the response status
- warning
  added the new more-public-actors-require-verified-owner enum value to the / response property for the response status
- warning
  added the new more-public-actors-require-verified-owner enum value to the / response property for the response status
- warning
  added the new more-public-actors-require-verified-owner enum value to the / response property for the response status
- warning
  added the new more-public-actors-require-verified-owner enum value to the / response property for the response status
- warning
  added the new readme-required enum value to the / response property for the response status
- warning
  added the new readme-required enum value to the / response property for the response status
- warning
  added the new readme-required enum value to the / response property for the response status
- warning
  added the new readme-required enum value to the / response property for the response status
- warning
  added the new readme-required enum value to the / response property for the response status
- warning
  added the new schemas-required enum value to the / response property for the response status
- warning
  added the new schemas-required enum value to the / response property for the response status
- warning
  added the new schemas-required enum value to the / response property for the response status
- warning
  added the new schemas-required enum value to the / response property for the response status
- warning
  added the new schemas-required enum value to the / response property for the response status
- warning
  added the new standby-deployment-invalid enum value to the / response property for the response status
- warning
  added the new standby-deployment-invalid enum value to the / response property for the response status
- warning
  added the new standby-deployment-invalid enum value to the / response property for the response status
- warning
  added the new standby-deployment-invalid enum value to the / response property for the response status
- warning
  added the new standby-deployment-invalid enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-account enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-account enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-account enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-account enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-account enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-actor enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-actor enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-actor enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-actor enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-actor enum value to the / response property for the response status

Operation history (5 revisions)