{
  "openapi": "3.0.1",
  "info": {
    "title": "Skool Map Scraper",
    "description": "🗺️ Extract member locations & full profiles from any Skool community map GPS coordinates, names, bios, social links, level & points. 📍 Works on communities with 200,000+ members. Perfect for events, outreach & research 🎯",
    "version": "0.1",
    "x-build-id": "EosJFWOhpVbXylBPn"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/dz_omar~skool-map-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-dz_omar-skool-map-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/dz_omar~skool-map-scraper/runs": {
      "post": {
        "operationId": "runs-sync-dz_omar-skool-map-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/dz_omar~skool-map-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-dz_omar-skool-map-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",
        "required": [
          "communityUrl"
        ],
        "properties": {
          "communityUrl": {
            "title": "🗺️ Skool Community URLs",
            "type": "array",
            "description": "One or more Skool community URLs. Accepted formats:\n\n• https://www.skool.com/{slug}\n• https://www.skool.com/{slug}/-/map\n• Bare slug: my-community",
            "default": [
              "https://www.skool.com/ai-automation-society",
              "https://www.skool.com/learn-ai/-/map"
            ],
            "items": {
              "type": "string"
            }
          },
          "userPreviewConcurrency": {
            "title": "⚡ Parallel requests",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "How many user profile requests to fire simultaneously.\n\nDefault: 10. Reduce to 5 if you see rate-limit errors. Maximum: 20.",
            "default": 5
          },
          "maxMembersPerCommunity": {
            "title": "👥 Max members per community",
            "minimum": 10,
            "maximum": 10000000,
            "type": "integer",
            "description": "Maximum number of member profiles to extract from EACH community.\n\nExample: Set to 100 → extracts up to 100 members from each community URL.\n\nSet to 0 or leave empty to extract ALL members (no limit).",
            "default": 10
          },
          "filterCountries": {
            "title": "🌍 Filter by Country",
            "type": "array",
            "description": "Only extract members located in these countries.\n\nUses offline reverse-geocoding on member coordinates — no extra API calls needed.\n\n**Leave empty to extract ALL members regardless of country** (default behavior).\n\nSelect one or more countries to filter. Only members whose map pin falls within the selected countries will be extracted. This saves API calls and speeds up extraction significantly for large communities.",
            "items": {
              "type": "string",
              "enum": [
                "US",
                "CA",
                "GB",
                "AU",
                "NZ",
                "FR",
                "DE",
                "IT",
                "ES",
                "PT",
                "NL",
                "BE",
                "AT",
                "CH",
                "LU",
                "SE",
                "NO",
                "DK",
                "FI",
                "IS",
                "IE",
                "PL",
                "CZ",
                "SK",
                "HU",
                "RO",
                "BG",
                "HR",
                "SI",
                "RS",
                "BA",
                "MK",
                "ME",
                "AL",
                "XK",
                "GR",
                "CY",
                "MT",
                "LT",
                "LV",
                "EE",
                "UA",
                "MD",
                "BY",
                "RU",
                "TR",
                "IN",
                "PK",
                "BD",
                "LK",
                "NP",
                "CN",
                "JP",
                "KR",
                "TW",
                "HK",
                "MO",
                "SG",
                "MY",
                "ID",
                "TH",
                "VN",
                "PH",
                "MM",
                "KH",
                "LA",
                "SA",
                "AE",
                "QA",
                "KW",
                "BH",
                "OM",
                "JO",
                "LB",
                "IQ",
                "IL",
                "PS",
                "YE",
                "SY",
                "EG",
                "LY",
                "TN",
                "DZ",
                "MA",
                "NG",
                "GH",
                "KE",
                "TZ",
                "UG",
                "ET",
                "ZA",
                "CI",
                "SN",
                "CM",
                "AO",
                "MZ",
                "MG",
                "RW",
                "ZW",
                "ZM",
                "BW",
                "NA",
                "MW",
                "MX",
                "GT",
                "HN",
                "SV",
                "NI",
                "CR",
                "PA",
                "BZ",
                "BR",
                "AR",
                "CL",
                "CO",
                "PE",
                "VE",
                "EC",
                "BO",
                "PY",
                "UY",
                "GY",
                "SR",
                "CU",
                "DO",
                "HT",
                "JM",
                "TT",
                "PR",
                "IR",
                "AF",
                "UZ",
                "KZ",
                "KG",
                "TJ",
                "TM",
                "AZ",
                "GE",
                "AM",
                "MN"
              ],
              "enumTitles": [
                "🇺🇸 United States",
                "🇨🇦 Canada",
                "🇬🇧 United Kingdom",
                "🇦🇺 Australia",
                "🇳🇿 New Zealand",
                "🇫🇷 France",
                "🇩🇪 Germany",
                "🇮🇹 Italy",
                "🇪🇸 Spain",
                "🇵🇹 Portugal",
                "🇳🇱 Netherlands",
                "🇧🇪 Belgium",
                "🇦🇹 Austria",
                "🇨🇭 Switzerland",
                "🇱🇺 Luxembourg",
                "🇸🇪 Sweden",
                "🇳🇴 Norway",
                "🇩🇰 Denmark",
                "🇫🇮 Finland",
                "🇮🇸 Iceland",
                "🇮🇪 Ireland",
                "🇵🇱 Poland",
                "🇨🇿 Czechia",
                "🇸🇰 Slovakia",
                "🇭🇺 Hungary",
                "🇷🇴 Romania",
                "🇧🇬 Bulgaria",
                "🇭🇷 Croatia",
                "🇸🇮 Slovenia",
                "🇷🇸 Serbia",
                "🇧🇦 Bosnia & Herzegovina",
                "🇲🇰 North Macedonia",
                "🇲🇪 Montenegro",
                "🇦🇱 Albania",
                "🇽🇰 Kosovo",
                "🇬🇷 Greece",
                "🇨🇾 Cyprus",
                "🇲🇹 Malta",
                "🇱🇹 Lithuania",
                "🇱🇻 Latvia",
                "🇪🇪 Estonia",
                "🇺🇦 Ukraine",
                "🇲🇩 Moldova",
                "🇧🇾 Belarus",
                "🇷🇺 Russia",
                "🇹🇷 Turkey",
                "🇮🇳 India",
                "🇵🇰 Pakistan",
                "🇧🇩 Bangladesh",
                "🇱🇰 Sri Lanka",
                "🇳🇵 Nepal",
                "🇨🇳 China",
                "🇯🇵 Japan",
                "🇰🇷 South Korea",
                "🇹🇼 Taiwan",
                "🇭🇰 Hong Kong",
                "🇲🇴 Macau",
                "🇸🇬 Singapore",
                "🇲🇾 Malaysia",
                "🇮🇩 Indonesia",
                "🇹🇭 Thailand",
                "🇻🇳 Vietnam",
                "🇵🇭 Philippines",
                "🇲🇲 Myanmar",
                "🇰🇭 Cambodia",
                "🇱🇦 Laos",
                "🇸🇦 Saudi Arabia",
                "🇦🇪 UAE",
                "🇶🇦 Qatar",
                "🇰🇼 Kuwait",
                "🇧🇭 Bahrain",
                "🇴🇲 Oman",
                "🇯🇴 Jordan",
                "🇱🇧 Lebanon",
                "🇮🇶 Iraq",
                "🇮🇱 Israel",
                "🇵🇸 Palestine",
                "🇾🇪 Yemen",
                "🇸🇾 Syria",
                "🇪🇬 Egypt",
                "🇱🇾 Libya",
                "🇹🇳 Tunisia",
                "🇩🇿 Algeria",
                "🇲🇦 Morocco",
                "🇳🇬 Nigeria",
                "🇬🇭 Ghana",
                "🇰🇪 Kenya",
                "🇹🇿 Tanzania",
                "🇺🇬 Uganda",
                "🇪🇹 Ethiopia",
                "🇿🇦 South Africa",
                "🇨🇮 Côte d'Ivoire",
                "🇸🇳 Senegal",
                "🇨🇲 Cameroon",
                "🇦🇴 Angola",
                "🇲🇿 Mozambique",
                "🇲🇬 Madagascar",
                "🇷🇼 Rwanda",
                "🇿🇼 Zimbabwe",
                "🇿🇲 Zambia",
                "🇧🇼 Botswana",
                "🇳🇦 Namibia",
                "🇲🇼 Malawi",
                "🇲🇽 Mexico",
                "🇬🇹 Guatemala",
                "🇭🇳 Honduras",
                "🇸🇻 El Salvador",
                "🇳🇮 Nicaragua",
                "🇨🇷 Costa Rica",
                "🇵🇦 Panama",
                "🇧🇿 Belize",
                "🇧🇷 Brazil",
                "🇦🇷 Argentina",
                "🇨🇱 Chile",
                "🇨🇴 Colombia",
                "🇵🇪 Peru",
                "🇻🇪 Venezuela",
                "🇪🇨 Ecuador",
                "🇧🇴 Bolivia",
                "🇵🇾 Paraguay",
                "🇺🇾 Uruguay",
                "🇬🇾 Guyana",
                "🇸🇷 Suriname",
                "🇨🇺 Cuba",
                "🇩🇴 Dominican Republic",
                "🇭🇹 Haiti",
                "🇯🇲 Jamaica",
                "🇹🇹 Trinidad & Tobago",
                "🇵🇷 Puerto Rico",
                "🇮🇷 Iran",
                "🇦🇫 Afghanistan",
                "🇺🇿 Uzbekistan",
                "🇰🇿 Kazakhstan",
                "🇰🇬 Kyrgyzstan",
                "🇹🇯 Tajikistan",
                "🇹🇲 Turkmenistan",
                "🇦🇿 Azerbaijan",
                "🇬🇪 Georgia",
                "🇦🇲 Armenia",
                "🇲🇳 Mongolia"
              ]
            }
          },
          "email": {
            "title": "📧 Email (optional) ",
            "type": "string",
            "description": "Your Skool account email for automatic login.\n\n✅ Login succeeds → authenticated session created\n❌ Login fails → falls back to browser cookies below\n\n💡 Leave empty to skip and use browser cookies instead."
          },
          "password": {
            "title": "🔑 Password (optional)",
            "type": "string",
            "description": "Your Skool account password.\n\n🔒 Required only if using email above.\n\n⚠️ Stored as a secret — never logged or exposed."
          },
          "cookies": {
            "title": "🍪 Browser Cookies (optional)",
            "type": "array",
            "description": "Fallback if email+password login fails or is not provided.\n\n📋 How to get cookies:\n1. Install [Cookie-Editor](https://cookie-editor.com) or [Copy Cookies](https://chromewebstore.google.com/detail/copy-cookies/jcbpglbplpblnagieibnemmkiamekcdg)\n2. Log into skool.com\n3. Open extension → Export → JSON format\n4. Paste the JSON array here\n\n⚠️ Keep cookies private — they grant full access to your account."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}