{
  "openapi": "3.0.1",
  "info": {
    "title": "VK Groups Scraper",
    "description": "Get public VK (VKontakte) communities, groups and public pages with members count, contacts and links. From $2.50 per 1,000 groups, no VK login needed, only matching groups are charged. Running cost is extra (usually under $0.001 per run). Keyword search finds about 20-40 groups per keyword.",
    "version": "1.1",
    "x-build-id": "11eCLqqXTpNHMII6R"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/khadinakbar~vk-groups-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-khadinakbar-vk-groups-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/khadinakbar~vk-groups-scraper/runs": {
      "post": {
        "operationId": "runs-sync-khadinakbar-vk-groups-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/khadinakbar~vk-groups-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-khadinakbar-vk-groups-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": {
          "targets": {
            "title": "VK group targets",
            "type": "array",
            "description": "Use this when you already know the VK community URL, handle, or numeric group ID. Accepts 'vk', 'https://vk.com/vkvideo', 'vk.ru/vkmusic', 'club1', 'public1' or '-1'. Read from VK's official API: full row with member count, activity, links and contacts in seconds. Not for user profiles, member lists, wall posts or video URLs.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "searchQueries": {
            "title": "Search queries",
            "type": "array",
            "description": "Use this when you want to discover VK communities by keyword, one phrase per line, for example 'gaming' or 'маркетинг'. Without a token, communities are found through public web search (often 20-40 per keyword), each is verified with VK, and only those mentioning the keyword are kept. With vkAccessToken, VK's own search is used. Put known communities in targets instead.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "maxGroups": {
            "title": "Max groups",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Use this to cap the total number of billable group records saved across targets and searches. Example: 50 returns at most 50 group rows. Defaults to 50 and is clamped to 1-1000 at runtime. Not a page count; each saved VK group is one billable event. Free Apify plan runs return up to 25 results per run.",
            "default": 50
          },
          "maxGroupsPerSearch": {
            "title": "Max groups per search",
            "minimum": 1,
            "maximum": 250,
            "type": "integer",
            "description": "Use this to limit how many communities each keyword can add before the Actor moves to the next search query. Example: 25 keeps broad terms from consuming the whole run. Defaults to 25 and is clamped to maxGroups and 250. Not used for direct targets. Without a VK token most keywords find 20-40 communities.",
            "default": 25
          },
          "groupType": {
            "title": "Group type",
            "enum": [
              "any",
              "group",
              "page",
              "event"
            ],
            "type": "string",
            "description": "Use this to keep only one kind of VK community: 'group' (regular groups), 'page' (public pages, usually brands and media) or 'event'. Defaults to 'any'. Filtered-out communities are not saved and not billed.",
            "default": "any"
          },
          "sortBy": {
            "title": "Sort keyword results",
            "enum": [
              "relevance",
              "members"
            ],
            "type": "string",
            "description": "Use 'members' to get the biggest communities first for each keyword, or 'relevance' (default) to keep the search order. Applied before maxGroupsPerSearch trims the list. Not used for direct targets.",
            "default": "relevance"
          },
          "includeAddresses": {
            "title": "Include full address list",
            "type": "boolean",
            "description": "Use this when you need every physical address of a community, with coordinates and phone number, for example for shops or offices. Defaults to false. The main address is always included without this option. Adds a little run time for communities that list addresses, at no extra result fee.",
            "default": false
          },
          "vkAccessToken": {
            "title": "VK access token",
            "type": "string",
            "description": "Optional. Not needed for known communities. Paste your own VK user access token (from a VK app at dev.vk.com) only if you want keyword search through VK's own community search, which finds far more groups than the public index. The token is never written to the dataset, OUTPUT, RUN_SUMMARY or logs. It is not your VK password."
          },
          "includeRawData": {
            "title": "Include raw VK data",
            "type": "boolean",
            "description": "Use this when you need the raw VK API group object for debugging or custom parsing. Defaults to false for smaller, cleaner exports. Not needed for spreadsheet exports or MCP clients.",
            "default": false
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Optional backup network route. The Actor reaches VK's API through Apify's datacenter proxy first; if that fails it uses this proxy (default: Apify Residential in Russia). Leave as is unless you have a tested route.",
            "default": {
              "useApifyProxy": true,
              "apifyProxyGroups": [
                "RESIDENTIAL"
              ],
              "apifyProxyCountry": "RU"
            }
          }
        }
      },
      "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}