{
  "openapi": "3.0.1",
  "info": {
    "title": "Skillshare Scraper | All In One",
    "description": "Scrape Skillshare into clean class and instructor data. Pull titles, ratings, student counts, duration, level, language, topics, popularity ratings and full teacher profiles. Great for course research, catalog building, trend tracking and instructor outreach",
    "version": "1.0",
    "x-build-id": "gHztK3QSfWkmvgIsE"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/fatihtahta~skillshare-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-fatihtahta-skillshare-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/fatihtahta~skillshare-scraper/runs": {
      "post": {
        "operationId": "runs-sync-fatihtahta-skillshare-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/fatihtahta~skillshare-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-fatihtahta-skillshare-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": {
          "startUrls": {
            "title": "Start URLs (Search results, category pages, and classes)",
            "type": "array",
            "description": "Paste one or more Skillshare URLs to scrape directly. You can mix search results, category pages, and individual class pages in the same run. Use this when you already have specific URLs and want precise control.",
            "items": {
              "type": "string"
            }
          },
          "queries": {
            "title": "Search keywords",
            "type": "array",
            "description": "Enter one or more keywords to search on Skillshare (for example, a topic, skill, style, or tool). Use this if you don’t have URLs yet — the actor will find matching classes and save them to your dataset.",
            "items": {
              "type": "string"
            }
          },
          "difficultyLevel": {
            "title": "👷 Filter by Difficulty levels",
            "uniqueItems": true,
            "type": "array",
            "description": "Choose one or more difficulty levels to narrow the class results.",
            "items": {
              "type": "string",
              "enum": [
                "Beginner",
                "Intermediate",
                "Advanced",
                "Mixed"
              ],
              "enumTitles": [
                "🌱 Beginner — Just starting",
                "🚀 Intermediate — Some experience",
                "🏆 Advanced — Deep dive",
                "🎛️ Mixed — All levels (seperate field, not a combination of other fields)"
              ]
            }
          },
          "rating": {
            "title": "⭐ Filter by Minimum rating",
            "enum": [
              "All ratings",
              "3 stars and up",
              "4 stars and up",
              "5 stars"
            ],
            "type": "string",
            "description": "Set a minimum class rating. Choose “Any rating” to skip this filter.",
            "default": "All ratings"
          },
          "publishDate": {
            "title": "📅 Filter by Published date",
            "enum": [
              "",
              "Last Week",
              "Last Month",
              "Last 2 months",
              "Last Year"
            ],
            "type": "string",
            "description": "Limit results to classes published within a recent time window.",
            "default": ""
          },
          "language": {
            "title": "🌍 Filter by Course Language",
            "uniqueItems": true,
            "type": "array",
            "description": "Choose one or more languages for the class audio or subtitles.",
            "items": {
              "type": "string",
              "enum": [
                "Deutsch",
                "English",
                "Español",
                "Français",
                "Português"
              ],
              "enumTitles": [
                "🇩🇪 German — Deutsch",
                "🇺🇸 English — English",
                "🇪🇸 Spanish — Español",
                "🇫🇷 French — Français",
                "🇵🇹 Portuguese — Português"
              ]
            }
          },
          "duration": {
            "title": "⏱️ Filter by Class duration",
            "uniqueItems": true,
            "type": "array",
            "description": "Choose one or more duration ranges to narrow the results.",
            "items": {
              "type": "string",
              "enum": [
                "Under 30 mins",
                "30 mins to 1 hour",
                "1 to 2 hours",
                "Over 2 hours"
              ],
              "enumTitles": [
                "⏱️ Under 30 min — Quick",
                "⏱️ 30–60 min — Short",
                "⏱️ 1–2 hours — Medium",
                "⏱️ 2+ hours — Long"
              ]
            }
          },
          "software": {
            "title": "🧰 Filter by Software",
            "uniqueItems": true,
            "type": "array",
            "description": "Choose one or more software tools featured in the class.",
            "items": {
              "type": "string",
              "enum": [
                "Procreate",
                "Adobe Photoshop",
                "Adobe Illustrator",
                "Blender",
                "Adobe After Effects",
                "ChatGPT",
                "Canva",
                "Adobe Premiere Pro",
                "Adobe Lightroom",
                "Affinity Designer",
                "Microsoft Excel",
                "Ableton Live",
                "Cinema 4D",
                "DaVinci Resolve",
                "Unreal Engine",
                "Microsoft PowerPoint",
                "Adobe InDesign",
                "Figma",
                "Autodesk Maya",
                "Adobe Fresco",
                "iMovie",
                "Midjourney",
                "Final Cut Pro",
                "Adobe Substance 3D Painter",
                "Affinity Photo",
                "FL Studio",
                "Notion",
                "Logic Pro",
                "Unity",
                "ZBrush",
                "Adobe Camera Raw",
                "Procreate Dreams",
                "SketchUp",
                "Adobe XD",
                "Adobe Animate",
                "Krita",
                "Manga Studio",
                "Nomad Sculpt",
                "Autodesk 3ds Max",
                "Adobe Firefly",
                "Inkscape",
                "Trello",
                "Snapseed",
                "V-Ray",
                "Autodesk Fusion 360",
                "Rhinoceros 3D",
                "SolidWorks",
                "Adobe Acrobat",
                "AutoCAD",
                "OneNote",
                "Grasshopper",
                "Stop Motion Studio",
                "MediBang Pro",
                "Marvelous Designer",
                "Adobe Express",
                "Affinity Publisher",
                "Dragonframe",
                "F.lux",
                "KeyShot",
                "HoneyBook",
                "iFontMaker"
              ],
              "enumTitles": [
                "✍️ Procreate — Digital sketchbook",
                "🖼️ Adobe Photoshop — Photo editing",
                "🧩 Adobe Illustrator — Vector design",
                "🧊 Blender — 3D modeling",
                "🎞️ Adobe After Effects — Motion graphics",
                "🤖 ChatGPT — AI assistant",
                "🎨 Canva — Quick design",
                "🎬 Adobe Premiere Pro — Video editing",
                "📷 Adobe Lightroom — Photo workflow",
                "🧩 Affinity Designer — Vector design",
                "📊 Microsoft Excel — Spreadsheets",
                "🎛️ Ableton Live — Music production",
                "🎥 Cinema 4D — 3D animation",
                "🎚️ DaVinci Resolve — Color grading",
                "🕹️ Unreal Engine — Real-time 3D",
                "📽️ Microsoft PowerPoint — Presentations",
                "📄 Adobe InDesign — Page layout",
                "🧩 Figma — UI design",
                "🐉 Autodesk Maya — 3D animation",
                "🖌️ Adobe Fresco — Digital painting",
                "🎬 iMovie — Video editing",
                "✨ Midjourney — AI images",
                "🎬 Final Cut Pro — Video editing",
                "🧪 Adobe Substance 3D Painter — 3D texturing",
                "🖼️ Affinity Photo — Photo editing",
                "🎹 FL Studio — Music production",
                "🗂️ Notion — Notes & docs",
                "🎚️ Logic Pro — Music production",
                "🎮 Unity — Game engine",
                "🗿 ZBrush — Digital sculpting",
                "📸 Adobe Camera Raw — RAW processing",
                "🌙 Procreate Dreams — Animation",
                "🏠 SketchUp — 3D modeling",
                "🧩 Adobe XD — UX design",
                "🪄 Adobe Animate — 2D animation",
                "🎨 Krita — Digital painting",
                "📚 Manga Studio — Comic art",
                "🗿 Nomad Sculpt — 3D sculpting",
                "🏗️ Autodesk 3ds Max — 3D modeling",
                "🔥 Adobe Firefly — AI design",
                "🧩 Inkscape — Vector design",
                "🗒️ Trello — Project boards",
                "📱 Snapseed — Mobile photo edit",
                "💡 V-Ray — 3D rendering",
                "🛠️ Autodesk Fusion 360 — CAD modeling",
                "🦏 Rhinoceros 3D — NURBS modeling",
                "🧰 SolidWorks — CAD engineering",
                "📄 Adobe Acrobat — PDF tools",
                "📐 AutoCAD — CAD drafting",
                "📝 OneNote — Note taking",
                "🧠 Grasshopper — Parametric design",
                "🎬 Stop Motion Studio — Stop motion",
                "🖊️ MediBang Pro — Digital art",
                "🧵 Marvelous Designer — 3D apparel",
                "⚡ Adobe Express — Quick design",
                "📘 Affinity Publisher — Page layout",
                "🐲 Dragonframe — Stop motion",
                "🌙 F.lux — Screen warmth",
                "🔆 KeyShot — Product rendering",
                "📒 HoneyBook — Client management",
                "🔤 iFontMaker — Font creation"
              ]
            }
          },
          "material": {
            "title": "🧵 Filter by Materials used",
            "uniqueItems": true,
            "type": "array",
            "description": "Choose one or more materials commonly used in the class.",
            "items": {
              "type": "string",
              "enum": [
                "Watercolor Paint",
                "Watercolor Paper",
                "iPad",
                "Computer",
                "Acrylic Paint",
                "Paint Brush",
                "Graphite Pencil",
                "Gouache Paint",
                "Water Container",
                "Sketch Paper",
                "Water",
                "Colored Pencil",
                "Paint Palette",
                "Eraser",
                "Oil Paint",
                "Fine Liner Pens",
                "iPhone",
                "Drawing Tablet",
                "Mechanical Pencil",
                "Ballpoint Pen",
                "Scissors",
                "Brush Pen",
                "Water Brush",
                "Smartphone",
                "Masking Tape",
                "Yarn",
                "Fabric",
                "Stylus",
                "Ruler",
                "Clay",
                "Card Stock Paper",
                "Oil Pastel",
                "Bristol Paper",
                "Watercolor Pencil",
                "India Ink",
                "Canvas Board",
                "Washi Tape",
                "Charcoal",
                "Masking Fluid",
                "Water-Based Ink",
                "DSLR Camera",
                "Android",
                "Paint Pen",
                "Gel Pens",
                "Permanent Marker",
                "Soft Pastel",
                "Palette Knife",
                "Wire",
                "Glue Stick",
                "Alcohol Ink",
                "Sewing Machine",
                "Polymer Clay",
                "Crayons",
                "Pencil Sharpener",
                "Cardboard",
                "Sewing Thread",
                "Mirrorless Camera",
                "Dip Pen",
                "Felt-Tipped Pens",
                "Printer",
                "Tracing Paper",
                "Leather",
                "Resin",
                "Pastel Pencil",
                "Tapered Crochet Hooks",
                "Felt",
                "Sewing Needle",
                "Painter's Tape",
                "Embroidery Needle",
                "Cutting Mat",
                "Embroidery Floss",
                "Adhesive",
                "Cricut",
                "Gelli Plate",
                "Beads",
                "X-Acto Knife",
                "Calligraphy Pen",
                "Inline Crochet Hooks",
                "Scanner",
                "Tape Measure",
                "Wire Cutters",
                "Cotton Fabric",
                "Film Camera",
                "Acrylic Sheet",
                "Needle Nose Pliers",
                "Round Nose Pliers",
                "Gold Leaf",
                "Solder",
                "Varnish",
                "Chain Nose Jewelry Pliers",
                "Sandpaper",
                "Bone Folder",
                "Nylon Jaw Pliers",
                "Card Blanks",
                "Gesso",
                "String",
                "Buttons",
                "Lace",
                "Zipper",
                "Flat Nose Pliers"
              ],
              "enumTitles": [
                "🎨 Watercolor Paint — Transparent washes",
                "🧻 Watercolor Paper — Cold press",
                "📱 iPad — Digital drawing",
                "💻 Computer — Digital work",
                "🎨 Acrylic Paint — Fast drying",
                "🖌️ Paint Brush — Brush strokes",
                "✏️ Graphite Pencil — Sketching",
                "🎨 Gouache Paint — Opaque paint",
                "🪣 Water Container — Rinse cup",
                "🧻 Sketch Paper — Practice sheets",
                "💧 Water — Mixing medium",
                "🖍️ Colored Pencil — Layered color",
                "🎨 Paint Palette — Mixing colors",
                "🧽 Eraser — Corrections",
                "🎨 Oil Paint — Rich color",
                "🖊️ Fine Liner Pens — Precise lines",
                "📱 iPhone — Mobile capture",
                "🧾 Drawing Tablet — Pen input",
                "✏️ Mechanical Pencil — Consistent lines",
                "🖊️ Ballpoint Pen — Everyday ink",
                "✂️ Scissors — Cutting",
                "🖌️ Brush Pen — Flexible strokes",
                "💧 Water Brush — Built-in water",
                "📱 Smartphone — Mobile work",
                "🧻 Masking Tape — Clean edges",
                "🧶 Yarn — Fiber work",
                "🧵 Fabric — Textile base",
                "🖊️ Stylus — Digital pen",
                "📏 Ruler — Straight lines",
                "🧱 Clay — Sculpting",
                "🗂️ Card Stock Paper — Thick paper",
                "🖍️ Oil Pastel — Creamy sticks",
                "🧻 Bristol Paper — Smooth sheet",
                "🖍️ Watercolor Pencil — Water-activated",
                "🖤 India Ink — Deep black",
                "🖼️ Canvas Board — Rigid canvas",
                "🎏 Washi Tape — Decorative tape",
                "🖤 Charcoal — Soft shading",
                "🧪 Masking Fluid — Preserve whites",
                "💧 Water-Based Ink — Easy cleanup",
                "📷 DSLR Camera — Pro photos",
                "🤖 Android — Mobile device",
                "🖊️ Paint Pen — Opaque ink",
                "🖊️ Gel Pens — Smooth color",
                "🖊️ Permanent Marker — Bold lines",
                "🖍️ Soft Pastel — Blendable",
                "🔪 Palette Knife — Texture",
                "🧷 Wire — Armatures",
                "🧴 Glue Stick — Paper adhesive",
                "🍶 Alcohol Ink — Vibrant flows",
                "🧵 Sewing Machine — Stitching",
                "🧱 Polymer Clay — Bakeable",
                "🖍️ Crayons — Wax sticks",
                "🔪 Pencil Sharpener — Sharp points",
                "📦 Cardboard — Structural",
                "🧵 Sewing Thread — Stitching",
                "📷 Mirrorless Camera — Compact pro",
                "🪶 Dip Pen — Calligraphy",
                "🖊️ Felt-Tipped Pens — Marker tips",
                "🖨️ Printer — Printouts",
                "📄 Tracing Paper — See-through",
                "🧵 Leather — Durable hide",
                "🧪 Resin — Casting",
                "🖍️ Pastel Pencil — Chalk texture",
                "🧶 Tapered Crochet Hooks — Crochet",
                "🧵 Felt — Soft fabric",
                "🪡 Sewing Needle — Hand stitching",
                "🧻 Painter's Tape — Clean edges",
                "🪡 Embroidery Needle — Stitch details",
                "🟩 Cutting Mat — Protect surface",
                "🧵 Embroidery Floss — Stitch color",
                "🧴 Adhesive — Bonding",
                "✂️ Cricut — Cutting machine",
                "🟪 Gelli Plate — Gel printing",
                "📿 Beads — Jewelry",
                "🔪 X-Acto Knife — Precision cutting",
                "🖋️ Calligraphy Pen — Lettering",
                "🧶 Inline Crochet Hooks — Crochet",
                "📠 Scanner — Digitize",
                "📏 Tape Measure — Measuring",
                "✂️ Wire Cutters — Cut wire",
                "🧵 Cotton Fabric — Natural fiber",
                "🎞️ Film Camera — Analog photos",
                "🧊 Acrylic Sheet — Clear plastic",
                "🧰 Needle Nose Pliers — Tight spaces",
                "🧰 Round Nose Pliers — Loops",
                "✨ Gold Leaf — Gilding",
                "🧲 Solder — Metal join",
                "🧴 Varnish — Protective coat",
                "🧰 Chain Nose Jewelry Pliers — Jewelry work",
                "🪵 Sandpaper — Smoothing",
                "🦴 Bone Folder — Paper creasing",
                "🧰 Nylon Jaw Pliers — Delicate grip",
                "🗂️ Card Blanks — Greeting cards",
                "🪵 Gesso — Primer coat",
                "🧵 String — Tying",
                "🔘 Buttons — Fasteners",
                "🧵 Lace — Trim",
                "🤐 Zipper — Fastener",
                "🧰 Flat Nose Pliers — Flat grip"
              ]
            }
          },
          "original": {
            "title": "🏷️ Only include Original classes",
            "type": "boolean",
            "description": "Only include Skillshare Originals."
          },
          "staffPick": {
            "title": "🏷️ Only include Staff picks",
            "type": "boolean",
            "description": "Only include Staff Pick classes."
          },
          "topTeacher": {
            "title": "🏷️ Only include Top Teacher classes only",
            "type": "boolean",
            "description": "Only include classes taught by Top Teachers."
          },
          "limit": {
            "title": "Maximum classes to save (per query)",
            "minimum": 10,
            "type": "integer",
            "description": "Stop the run after this many classes have been saved for each query. Use a smaller number for quick sampling and testing, or increase it for deeper coverage.",
            "default": 50000
          },
          "proxyConfiguration": {
            "title": "Proxy configuration (recommended)",
            "type": "object",
            "description": "Optional connection settings that can improve reliability on larger runs or during busy periods. The default configuration works well for most users — adjust only if you need extra stability.",
            "default": {
              "useApifyProxy": true,
              "apifyProxyGroups": [
                "RESIDENTIAL"
              ]
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}