{
  "openapi": "3.0.1",
  "info": {
    "title": "Skool Group Community Infos Scraper By Keyword Search",
    "description": "Skool Group Community Infos Scraper by Keyword Search extracts Skool groups matching keywords, including group names, descriptions, URLs, categories, member counts, creators, pricing, and community details. Ideal for community research, competitor analysis, and group discovery.",
    "version": "0.1",
    "x-build-id": "HecOceiNxFfatV3cI"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scrapier~skool-group-community-infos-scrape/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scrapier-skool-group-community-infos-scrape",
        "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/scrapier~skool-group-community-infos-scrape/runs": {
      "post": {
        "operationId": "runs-sync-scrapier-skool-group-community-infos-scrape",
        "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/scrapier~skool-group-community-infos-scrape/run-sync": {
      "post": {
        "operationId": "run-sync-scrapier-skool-group-community-infos-scrape",
        "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": {
          "searchKeywords": {
            "title": "🔍 Niche keywords to search",
            "type": "array",
            "description": "📝 One topic/keyword per line — searched against Skool's public discovery listing (`skool.com/discovery?q=`), the same search box Skool's own homepage uses.\n\n**Examples:** `ai automation`, `ecommerce`.\n\n✅ Runs alongside (not instead of) the **Community links to collect** field below — use either or both.",
            "items": {
              "type": "string"
            }
          },
          "maxCommunitiesPerKeyword": {
            "title": "🔢 Max communities per keyword",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "📄 How many matching communities to collect **per keyword**, ranked by Skool's own search order. Skool serves 30 hits/page and hard-caps every query at 1000 total matches.\n\n**Default is 30** (one search page).",
            "default": 30
          },
          "minMembers": {
            "title": "👥 Minimum members",
            "minimum": 0,
            "type": "integer",
            "description": "📉 Skip search hits with fewer members than this, using the member count Skool's search results already report. **Default is 100** — set to `0` to disable.",
            "default": 100
          },
          "publicOnly": {
            "title": "🆓 Free-to-join communities only",
            "type": "boolean",
            "description": "🔓 When **ON** (default), skip search hits that carry a paid-membership price tag (`displayPrice`) in Skool's own search result — i.e. communities anyone can join without paying. Skool's discovery listing only ever surfaces communities whose visibility is already public, so this is a price/paywall filter, not a hidden/unlisted-vs-listed one. Turn **OFF** to also include paid communities.",
            "default": true
          },
          "urls": {
            "title": "🔗 Community links to collect",
            "type": "array",
            "description": "📝 Paste **Skool community / group links** (one per line) — the base actor's original field, still fully functional.\n\n**Examples:**\n• `https://www.skool.com/your-group/about`\n• `your-group` (short name only)\n\n✅ **Bulk friendly** — add as many as you need; each one becomes its own row in the output table. Leave empty if you're only using keyword search above.",
            "items": {
              "type": "string"
            }
          },
          "proxyConfiguration": {
            "title": "🛡️ Proxy (optional)",
            "type": "object",
            "description": "🌐 **Only if the site is slow or picky** — turn this on for a smoother ride. Leave off for the simplest setup.\n\n🔁 When enabled, the actor tries the usual connection first, then extra options only if needed. Applies to both discovery search pages and about-page fetches."
          },
          "maxRetries": {
            "title": "🔁 Retry attempts",
            "minimum": 0,
            "maximum": 10,
            "type": "integer",
            "description": "⏱️ How many times to retry a single request when the network hiccups (not when data is missing). **Default is plenty for most runs.**",
            "default": 3
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}