Skip to main content

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 items to return. The default value as well as the maximum is 1000.


    Example: 1000
    offset double

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


    Example: 0
    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
    responseFormat string

    Possible values: [full, agent]

    Controls the shape of the response. Use full (default) for the complete response including image URLs and all fields. Use agent for a reduced field set optimized for LLM consumers, which only includes id, title, name, username, description, notice, badge, categories, and minimal stats.


    Default value: full
    Example: agent
    includeUnrunnableActors boolean

    By default, search results exclude Actors that are not safe to run automatically (e.g. Actors from developers who haven't passed KYC, or full-permission Actors without a large user base). Set to true to bypass this safety filtering and include all Actors in the results.


    Default value: false
    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"
            },
            "isWhiteListedForAgenticPayments": 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"
            },
            "isWhiteListedForAgenticPayments": false
          }
        ]
      }
    }