{
  "openapi": "3.0.1",
  "info": {
    "title": "Apify Store Scraper",
    "description": "Extract actor data from Apify Store using the official search API. Filter by category, pricing model, developer or keyword. Sort by popularity, newest or last updated. Get titles, stats, pricing, ratings and categories for any actor.",
    "version": "0.0",
    "x-build-id": "ajqK00d3yy3IsJbUF"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/extractmaster01~apify-store-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-extractmaster01-apify-store-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/extractmaster01~apify-store-scraper/runs": {
      "post": {
        "operationId": "runs-sync-extractmaster01-apify-store-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/extractmaster01~apify-store-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-extractmaster01-apify-store-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "query": {
            "title": "Search Query",
            "type": "string",
            "description": "Text to search across actor titles, names, descriptions, and README files. Leave empty to return all actors."
          },
          "maxItems": {
            "title": "Maximum Results",
            "minimum": 1,
            "maximum": 25000,
            "type": "integer",
            "description": "Maximum number of actors to extract. The Apify Store has 24,000+ actors — set to 25000 to get the full catalog.",
            "default": 100
          },
          "sortBy": {
            "title": "Sort By",
            "enum": [
              "relevance",
              "mostPopular",
              "newest",
              "lastUpdated"
            ],
            "type": "string",
            "description": "How to order the results.",
            "default": "relevance"
          },
          "categories": {
            "title": "Categories",
            "type": "array",
            "description": "Filter by one or more categories. Results include actors matching ANY of the selected categories.",
            "items": {
              "type": "string",
              "enum": [
                "AI",
                "AGENTS",
                "AUTOMATION",
                "BUSINESS",
                "DEVELOPER_TOOLS",
                "EDUCATION",
                "ECOMMERCE",
                "FOR_CREATORS",
                "INTEGRATIONS",
                "JOBS",
                "LEAD_GENERATION",
                "MARKETING",
                "MCP_SERVERS",
                "NEWS",
                "OPEN_SOURCE",
                "OTHER",
                "REAL_ESTATE",
                "SEO_TOOLS",
                "SOCIAL_MEDIA",
                "SPORTS",
                "TRAVEL",
                "VIDEOS"
              ],
              "enumTitles": [
                "AI",
                "Agents",
                "Automation",
                "Business",
                "Developer Tools",
                "Education",
                "E-commerce",
                "For Creators",
                "Integrations",
                "Jobs",
                "Lead Generation",
                "Marketing",
                "MCP Servers",
                "News",
                "Open Source",
                "Other",
                "Real Estate",
                "SEO Tools",
                "Social Media",
                "Sports",
                "Travel",
                "Videos"
              ]
            }
          },
          "pricingModel": {
            "title": "Pricing Model",
            "type": "array",
            "description": "Filter by pricing model. Results include actors matching ANY of the selected models.",
            "items": {
              "type": "string",
              "enum": [
                "FREE",
                "PAY_PER_EVENT",
                "PRICE_PER_DATASET_ITEM",
                "PAY_PER_USAGE",
                "FLAT_PRICE_PER_MONTH"
              ],
              "enumTitles": [
                "Free",
                "Pay Per Event",
                "Pay Per Result",
                "Pay Per Usage",
                "Monthly Flat Rate (deprecated)"
              ]
            }
          },
          "managedBy": {
            "title": "Maintained By",
            "enum": [
              "ALL",
              "APIFY",
              "COMMUNITY"
            ],
            "type": "string",
            "description": "Filter by who maintains the actor.",
            "default": "ALL"
          },
          "username": {
            "title": "Developer Username",
            "type": "string",
            "description": "Filter actors by a specific developer's Apify username."
          },
          "actorId": {
            "title": "Actor ID",
            "type": "string",
            "description": "Fetch a specific actor by its unique Apify ID."
          },
          "minRating": {
            "title": "Minimum Rating",
            "minimum": 1,
            "maximum": 5,
            "type": "number",
            "description": "Only include actors with an average rating equal to or above this value (1–5 scale)."
          },
          "minUsers": {
            "title": "Minimum Total Users",
            "minimum": 1,
            "type": "integer",
            "description": "Only include actors with at least this many total users."
          },
          "minBookmarks": {
            "title": "Minimum Bookmarks",
            "minimum": 1,
            "type": "integer",
            "description": "Only include actors with at least this many bookmarks."
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}