# Get list of Actors in store ``` GET https://api.apify.com/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 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` ### 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:** `1` * **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:** `1` * **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\ nullable\ **Example:** `https://...` * **userPictureUrl** string,null\ nullable\ **Example:** `https://...` * **url** string,null\ 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\\ **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)` ### Status 405 Method not allowed. ``` { "error": { "type": "method-not-allowed", "message": "This API end-point can only be accessed using the following HTTP methods: OPTIONS,GET" } } ``` **Schema** * **error** object required * **type** string required\ **Example:** `run-failed` * **message** string required\ **Example:** `Actor run did not succeed (run ID: 55uatRrZib4xbZs, status: FAILED)` ### Status 429 Too many requests - rate limit exceeded. ``` { "error": { "type": "rate-limit-exceeded", "message": "You have exceeded the rate limit. Please try again later." } } ``` **Schema** * **error** object required * **type** string required\ **Example:** `run-failed` * **message** string required\ **Example:** `Actor run did not succeed (run ID: 55uatRrZib4xbZs, status: FAILED)`