Get list of Actors in store

GET 
/v2/store

Gets the list of public Actors in Apify Store. You can use search parameter to search Actors by string in title, name, description, username and readme. If you need detailed info about a specific Actor, use the Get Actor endpoint.

The endpoint supports pagination using the limit and offset parameters. It will not return more than 1,000 records.

Request

Query Parameters

limit double
Maximum number of elements to return. The default and maximum value is 1,000.

Example: 99
offset double
Number of elements that should be skipped at the start. The default value is 0.

Example: 10
search string
String to search by. The search runs on the following fields: title, name, description, username, readme.

Example: web scraper
sortBy string
Specifies the field by which to sort the results. The supported values are relevance (default), popularity, newest and lastUpdate.

Example: 'popularity'
category string
Filters the results by the specified category.

Example: 'AI'
username string
Filters the results by the specified username.

Example: 'apify'
pricingModel string
Possible values: [FREE, FLAT_PRICE_PER_MONTH, PRICE_PER_DATASET_ITEM, PAY_PER_EVENT]
Only return Actors with the specified pricing model.

Example: FREE
allowsAgenticUsers boolean
If true, only return Actors that allow agentic users. If false, only return Actors that do not allow agentic users.

Example: true

Status 200

Response Headers

{
  "data": {
    "total": 100,
    "offset": 0,
    "limit": 1000,
    "desc": false,
    "count": 1,
    "items": [
      {
        "id": "zdc3Pyhyz3m8vjDeM",
        "title": "My Public Actor",
        "name": "my-public-actor",
        "username": "jane35",
        "userFullName": "Jane Doe",
        "description": "My public Actor!",
        "pictureUrl": "https://...",
        "userPictureUrl": "https://...",
        "url": "https://...",
        "stats": {
          "totalBuilds": 9,
          "totalRuns": 16,
          "totalUsers": 6,
          "totalUsers7Days": 2,
          "totalUsers30Days": 6,
          "totalUsers90Days": 6,
          "totalMetamorphs": 2,
          "lastRunStartedAt": "2019-07-08T14:01:05.546Z"
        },
        "currentPricingInfo": {
          "pricingModel": "FREE"
        },
        "isWhiteListedForAgenticPayment": true
      },
      {
        "id": "zdc3Pyhyz3m8vjDeM",
        "title": "My Public Actor",
        "name": "my-public-actor",
        "username": "jane35",
        "userFullName": "Jane H. Doe",
        "categories": [
          "MARKETING",
          "LEAD_GENERATION"
        ],
        "description": "My public Actor!",
        "pictureUrl": "https://...",
        "userPictureUrl": "https://...",
        "url": "https://...",
        "stats": {
          "totalBuilds": 9,
          "totalRuns": 16,
          "totalUsers": 6,
          "totalUsers7Days": 2,
          "totalUsers30Days": 6,
          "totalUsers90Days": 6,
          "totalMetamorphs": 2,
          "lastRunStartedAt": "2019-07-08T14:01:05.546Z"
        },
        "currentPricingInfo": {
          "pricingModel": "FREE"
        },
        "isWhiteListedForAgenticPayment": false
      }
    ]
  }
}

Schema

• data object required

  Common pagination fields for list responses.

  • total integer required

    The total number of items available across all pages.

    Possible values: >= 0

    
    Example: 2
  • offset integer required

    The starting position for this page of results.

    Possible values: >= 0

    
    Example: 0
  • limit integer required

    The maximum number of items returned per page.

    Possible values: >= 1

    
    Example: 1000
  • desc boolean required

    Whether the results are sorted in descending order.

    
    Example: false
  • count integer required

    The number of items returned in this response.

    Possible values: >= 0

    
    Example: 2
  • items object[] required

    • id string required
      Example: zdc3Pyhyz3m8vjDeM
    • title string required
      Example: My Public Actor
    • name string required
      Example: my-public-actor
    • username string required
      Example: jane35
    • userFullName string required
      Example: Jane H. Doe
    • description string required
      Example: My public actor!
    • categories string[]
      Example: ["MARKETING","LEAD_GENERATION"]
    • notice string
    • pictureUrl string,null<uri> nullable
      Example: https://...
    • userPictureUrl string,null<uri> nullable
      Example: https://...
    • url string,null<uri> nullable
      Example: https://...
    • stats object required

      • totalBuilds integer
        Example: 9
      • totalRuns integer
        Example: 16
      • totalUsers integer
        Example: 6
      • totalUsers7Days integer
        Example: 2
      • totalUsers30Days integer
        Example: 6
      • totalUsers90Days integer
        Example: 6
      • totalMetamorphs integer
        Example: 2
      • lastRunStartedAt string<date-time>
        Example: 2019-07-08T14:01:05.546Z
    • currentPricingInfo object required

      • pricingModel string required
        Example: FREE
    • isWhiteListedForAgenticPayment boolean | null nullable

      Whether the Actor is whitelisted for agentic payment processing.

    • readmeSummary string

      A brief, LLM-generated readme summary

Status 400

Bad request - invalid input parameters or request body.

{
  "error": {
    "type": "invalid-input",
    "message": "Invalid input: The request body contains invalid data."
  }
}

Schema

• error object required

  • type string required
    Example: run-failed
  • message string required
    Example: Actor run did not succeed (run ID: 55uatRrZib4xbZs, status: FAILED)