{
"openapi": "3.0.1",
"info": {
"title": "Teachable Scraper - Courses, Prices & Instructors",
"description": "Extract every course from any Teachable school: title, price, original price, currency, instructor, enrolled students, rating, reviews and the section-by-section curriculum. Reads both catalogue layouts and custom domains. Paste a school URL or specific course URLs. Export JSON, CSV or Excel.",
"version": "1.0",
"x-build-id": "eSp2QveAdECZug6ZL"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/silentflow~teachable-scraper-ppr/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-silentflow-teachable-scraper-ppr",
"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/silentflow~teachable-scraper-ppr/runs": {
"post": {
"operationId": "runs-sync-silentflow-teachable-scraper-ppr",
"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/silentflow~teachable-scraper-ppr/run-sync": {
"post": {
"operationId": "run-sync-silentflow-teachable-scraper-ppr",
"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": {
"schoolUrls": {
"title": "🏫 School URLs",
"type": "array",
"description": "Teachable schools to scrape. Paste whichever URL shows the courses in your browser: the homepage (https://yourschool.teachable.com), the /courses page, the /l/products catalogue, or a custom domain.
Both catalogue styles Teachable serves are read, so a school works whether it was built on the older grid or the newer one. A typical school lists between 5 and 40 courses.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"courseUrls": {
"title": "🔗 Course URLs",
"type": "array",
"description": "Direct course pages, when you already know which courses you want. Both page styles are accepted: /p/course-name and /l/pdp/course-name.
Use this to monitor a fixed set of courses instead of walking a catalogue that reorders itself. You can combine these with School URLs in the same run.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"scrapeDetails": {
"title": "📚 Scrape course details",
"type": "boolean",
"description": "Open each course page for its price, currency, instructor, rating, reviews and lesson outline.
Leave it on for complete rows. Turn it off to map a school fast: you still get every course's title, link, thumbnail and description from one page read, and the run finishes in seconds.",
"default": true
},
"scrapeSalesPage": {
"title": "📝 Include sales page copy",
"type": "boolean",
"description": "Also return the sales page text in salesPageContent, for positioning and messaging analysis.
Adds nothing to the run length, since the page is already being read. Off by default because most people do not need the marketing copy in their rows.",
"default": false
},
"maxItems": {
"title": "🔢 Maximum courses",
"minimum": 1,
"maximum": 5000,
"type": "integer",
"description": "Stop after this many courses. Set it to the size of the job: run length tracks this number almost exactly when course details are on.
It counts courses, not pages, and applies to the whole run, so raise it when you add more schools.",
"default": 100
},
"maxRequestRetries": {
"title": "🔁 Attempts per page",
"minimum": 0,
"maximum": 10,
"type": "integer",
"description": "How many times to attempt a page that does not answer the first time. The default suits almost every school.",
"default": 5
},
"requestTimeoutSecs": {
"title": "⏱️ Page timeout (seconds)",
"minimum": 10,
"maximum": 120,
"type": "integer",
"description": "How long to wait for one page. Raise it for a school with very large course pages.",
"default": 30
},
"proxyType": {
"title": "🌐 Connection",
"enum": [
"none",
"datacenter",
"residential"
],
"type": "string",
"description": "Teachable serves its pages without one, so None is the default and the cheapest choice. Change it only if your runs come back empty.",
"default": "none"
}
}
},
"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
}
}
}
}
}
}
}
}
}
}