{
"openapi": "3.0.1",
"info": {
"title": "VS Code Marketplace Scraper ยท Extensions, Installs & Publishers",
"description": "Scrape Visual Studio Code Marketplace extensions, install counts, publishers, ratings, categories, tags, and versions via official gallery API. Returns addressable extension dataset records.",
"version": "1.0",
"x-build-id": "XeGVaot4UWcQCpFUs"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/reapx~vscode-marketplace-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-reapx-vscode-marketplace-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/reapx~vscode-marketplace-scraper/runs": {
"post": {
"operationId": "runs-sync-reapx-vscode-marketplace-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/reapx~vscode-marketplace-scraper/run-sync": {
"post": {
"operationId": "run-sync-reapx-vscode-marketplace-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": {
"search": {
"title": "Search Keyword",
"type": "string",
"description": "Specify a search query string to filter VS Code extensions by keyword (e.g., python, react, copilot). Leave empty to disable keyword filtering and return all extensions matching other criteria.
Note: Broader searches match more extensions, increasing run duration and pay-per-event costs."
},
"category": {
"title": "Extension Category",
"enum": [
"",
"Programming Languages",
"Themes",
"Linters",
"Debuggers",
"Formatters",
"Snippets",
"Testing",
"Extension Packs",
"Data Science",
"Machine Learning",
"Keymaps",
"SCM Providers",
"Notebooks",
"Visualization",
"Other"
],
"type": "string",
"description": "Filter VS Code extensions by primary category in the Visual Studio Code Marketplace (e.g., Programming Languages, Themes, Linters, Debuggers). Leave empty to include extensions from all categories.
Selecting broad categories increases returned extension volume and total event charges."
},
"publisher": {
"title": "Publisher Name",
"pattern": "^[a-zA-Z0-9_-]{0,80}$",
"type": "string",
"description": "Specify a VS Code Marketplace publisher handle to restrict results to extensions created by that specific publisher (e.g., ms-python, ms-vscode, github, redhat). Leave empty to include extensions from all publishers."
},
"tag": {
"title": "Tag Keyword",
"type": "string",
"description": "Filter extensions by specific tag metadata assigned in the marketplace manifest (e.g., python, javascript, docker, linter, ai). Leave empty to ignore tag restrictions during extraction."
},
"sortBy": {
"title": "Sort Order",
"enum": [
"Installs",
"Relevance",
"LastUpdated",
"ReleaseDate",
"AverageRating",
"TrendingDaily",
"TrendingWeekly",
"TrendingMonthly"
],
"type": "string",
"description": "Select the sorting metric for extension results: Installs (most downloaded), Relevance (keyword relevance), LastUpdated (recently updated), ReleaseDate (newest), AverageRating (highest rated), or trending metrics. Default is Installs."
},
"minInstalls": {
"title": "Minimum Installs Filter",
"minimum": 0,
"type": "integer",
"description": "Set a minimum threshold for extension install counts (e.g., 10000). Extensions with fewer installs than this threshold will be excluded. Leave as 0 to include extensions regardless of download count."
},
"maxItems": {
"title": "Maximum Extensions",
"minimum": 1,
"maximum": 10000,
"type": "integer",
"description": "Specify the maximum total number of extension records to extract and push to the default dataset (1 to 10,000). The higher the number, the longer the run takes and the more it costs in pay-per-event fees.
The higher the number, the longer the run takes and the more you are charged, because you pay per row returned.",
"default": 50
}
}
},
"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
}
}
}
}
}
}
}
}
}
}