{
  "openapi": "3.0.1",
  "info": {
    "title": "Preply Scraper - Online Tutors, Prices, Ratings & Reviews",
    "description": "Scrape Preply (preply.com) online tutor profiles by subject, filters or URL. Extract hourly rates, ratings, student reviews, lessons taught, languages, subjects, education, certificates and tutor availability. Ideal for tutor research, price comparison and market analysis.",
    "version": "0.1",
    "x-build-id": "NmX0GH8SvOeOrXgON"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/abotapi~preply-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-abotapi-preply-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/abotapi~preply-scraper/runs": {
      "post": {
        "operationId": "runs-sync-abotapi-preply-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/abotapi~preply-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-abotapi-preply-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": [
          "mode"
        ],
        "properties": {
          "mode": {
            "title": "What do you want to scrape?",
            "enum": [
              "search",
              "url"
            ],
            "type": "string",
            "description": "Search lists tutors by subject and filters. URL mode scrapes the Preply links you paste (tutor search pages or tutor profiles) and ignores the search fields.",
            "default": "search"
          },
          "subjects": {
            "title": "Subjects",
            "type": "array",
            "description": "One subject per line, as in the site address: english, spanish, french, german, math, piano, and so on. Each subject is walked page by page, 10 tutors per page, until Max items is reached. A subject the site does not list is reported and skipped.",
            "default": [
              "english"
            ],
            "items": {
              "type": "string"
            }
          },
          "searchText": {
            "title": "Keyword within the subject",
            "type": "string",
            "description": "Optional. Narrows the subject to tutors that match this word or phrase in their profile, for example ielts or grammar."
          },
          "specialties": {
            "title": "Specialties",
            "type": "array",
            "description": "Optional specialty codes as used by the site, for example testprep_ielts, bus_gen, conv_gen. A tutor must teach every listed specialty.",
            "items": {
              "type": "string"
            }
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "relevance",
              "price_lowest",
              "price_highest",
              "popularity",
              "reviews",
              "rating"
            ],
            "type": "string",
            "description": "Order of the results. Recommended keeps the site's own ranking.",
            "default": "relevance"
          },
          "minPrice": {
            "title": "Minimum price per hour (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only tutors whose lesson price is at least this many US dollars per hour. Empty or 0 keeps all."
          },
          "maxPrice": {
            "title": "Maximum price per hour (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only tutors whose lesson price is at most this many US dollars per hour. Empty or 0 keeps all."
          },
          "countryOfBirth": {
            "title": "Tutor country of birth",
            "type": "string",
            "description": "Optional two letter country code, for example GB or US. Keeps only tutors from that country."
          },
          "alsoSpeaks": {
            "title": "Tutor also speaks",
            "type": "string",
            "description": "Optional language code, for example es or fr. Keeps only tutors who also speak that language."
          },
          "nativeSpeaker": {
            "title": "Native speakers only",
            "type": "boolean",
            "description": "Keep only tutors who are native speakers of the subject language.",
            "default": false
          },
          "certifiedOnly": {
            "title": "Certified teachers only",
            "type": "boolean",
            "description": "Keep only tutors with a verified teaching certificate.",
            "default": false
          },
          "superTutorsOnly": {
            "title": "Super Tutors only",
            "type": "boolean",
            "description": "Keep only tutors with the Super Tutor badge.",
            "default": false
          },
          "urls": {
            "title": "Preply links",
            "type": "array",
            "description": "Preply links, one per line. Accepted: a tutor search link (preply.com/en/online/english-tutors, including page, priceRange, searchText, tags, sort, additional, CoB and tl; a page beyond 1 starts there) and a tutor profile link (preply.com/en/tutor/1347910, localized and tracking-parameter variants too). Pages that carry no tutors (city pages, localized subject pages, the sitemap, the data endpoint) are skipped with a warning. Filter fields are ignored in this mode.",
            "default": [
              "https://preply.com/en/online/english-tutors",
              "https://preply.com/en/online/english-tutors?page=2",
              "https://preply.com/en/online/english-tutors?priceRange=10-20",
              "https://preply.com/en/online/english-tutors?searchText=ielts",
              "https://preply.com/en/online/english-tutors?tags=testprep_ielts",
              "https://preply.com/en/online/math-tutors",
              "https://preply.com/en/tutor/1347910",
              "https://preply.com/es/tutor/1347910",
              "https://preply.com/en/tutor/1347910?utm_source=x&sid=1",
              "https://preply.com/tutor/1347910",
              "https://preply.com/en/london/english-tutors",
              "https://preply.com/es/online/profesores-de-ingles",
              "https://m.preply.com/en/online/english-tutors",
              "https://preply.com/sitemap.xml"
            ],
            "items": {
              "type": "string"
            }
          },
          "fetchDetails": {
            "title": "Add profile details",
            "type": "boolean",
            "description": "Open each tutor profile to add the join date, last seen, response time, education, work experience, certificates, specialties, per subject standing, rating breakdown, the latest reviews and recommended tutors. Off returns the search card fields only. Profile links always open the profile.",
            "default": true
          },
          "maxReviews": {
            "title": "Max reviews per tutor",
            "minimum": 0,
            "maximum": 1000,
            "type": "integer",
            "description": "Latest reviews kept on each tutor row when profile details are on. Default 20; 0 skips reviews. Every 10 reviews delivered (rounded up) add one profile details unit to the bill.",
            "default": 20
          },
          "maxPages": {
            "title": "Max pages per search",
            "minimum": 0,
            "type": "integer",
            "description": "Optional. Search result pages to walk per subject or link. This does not cap the run by default: empty or 0 means no page limit and it defers to Max items, which is the one default cap (20). The site serves at most 99 pages per search."
          },
          "maxItems": {
            "title": "Max items",
            "minimum": 0,
            "type": "integer",
            "description": "The single default cap of the run: maximum tutors to return across the whole run (default 20). Max pages has no finite default and defers to this field. 0 means no limit. In incremental mode, unchanged tutors count toward this number.",
            "default": 20
          },
          "proxy": {
            "title": "Proxy",
            "type": "object",
            "description": "Proxy settings. The default is Apify Proxy with the Residential group, which this site needs for reliable results. Residential traffic is billed by data on your account and each page is large (about 2 MB), so keep Max items modest. If the selected connection is refused, the run switches to a backup connection on its own.",
            "default": {
              "useApifyProxy": true,
              "apifyProxyGroups": [
                "RESIDENTIAL"
              ]
            }
          },
          "resumeFromRunId": {
            "title": "Resume from run ID",
            "type": "string",
            "description": "Run ID (or dataset ID) of a previous run of this Actor. Tutors already collected there are skipped, so this run returns only the delta. Leave empty for a normal run. For recurring monitoring of the same search, use Incremental mode instead."
          },
          "incrementalMode": {
            "title": "Incremental changes for scheduled runs",
            "type": "boolean",
            "description": "For recurring tutor monitoring. A tutor is returned as NEW the first time and as UPDATED when a tracked field changes: hourly price, trial price, availability, name, headline, bio, country, subjects and their badges, languages, specialties, education, work experience, certificates, tags, video. Unchanged tutors are not returned or billed. Never compared: search position, online status, last seen, activity counters (lessons, students, bookings, leads), review count and rating, response time, reviews, recommended tutors, image links, run time stamp. State is kept per tracked search or link set (runs with and without profile details are tracked separately), or per State key when you set one.",
            "default": false
          },
          "stateKey": {
            "title": "State key",
            "type": "string",
            "description": "Optional name for a monitoring campaign. Runs sharing a key share their incremental state. Leave empty to scope it automatically to the search or links."
          },
          "baselineDatasetId": {
            "title": "Start from an existing dataset (incremental mode only)",
            "type": "string",
            "description": "Optional. Pick the dataset of an earlier full run of this Actor so the first incremental run returns only tutors that changed since then. Pick it unedited. Only used on the first run for a state key and not combined with Resume."
          },
          "emitExpired": {
            "title": "Emit expired tutors (incremental mode only)",
            "type": "boolean",
            "description": "Off by default. Also returns tutors that were tracked before and are no longer found, marked EXPIRED. Only produced after a complete scan, never when Max items, Max pages, a pasted page beyond 1 or a profile link or Resume limited the run. These synthetic rows are returned and billed, so leave it off unless you need expiry tracking.",
            "default": false
          },
          "changeScope": {
            "title": "What counts as a change (incremental mode only)",
            "enum": [
              "all",
              "priceAndStock"
            ],
            "type": "string",
            "description": "All fields (default): any change to the tracked fields returns an UPDATED row. Price and availability only: only price changes (hourly, trial, USD price), availability changes and per subject badge changes return an UPDATED row; name, bio, languages and other details never do.",
            "default": "all"
          },
          "compactUpdates": {
            "title": "Compact update rows (incremental mode only)",
            "type": "boolean",
            "description": "Off by default. When on, UPDATED and EXPIRED rows are short: tutor id, url, name, current price and availability, plus priceChanges and variantChanges with the old and new value of each moved field. NEW rows always carry the complete record.",
            "default": false
          },
          "expireAfterMissedScans": {
            "title": "Expire after N missed full scans (incremental mode only)",
            "minimum": 1,
            "maximum": 30,
            "type": "integer",
            "description": "Only used with Emit expired tutors. A tutor is marked EXPIRED only after it was missing from this many complete scans in a row (default 1). Raise it so a tutor that briefly drops out of the results is not reported as gone.",
            "default": 1
          },
          "ignoreFieldsForChanges": {
            "title": "Ignore fields when detecting changes (incremental mode only)",
            "type": "array",
            "description": "Extra field names that must not mark a tutor as UPDATED in incremental mode. Position, counters, online status, reviews and image links are already ignored. Use a dotted name such as subjects.retentionTier to ignore one key inside every subject entry while keeping the other subject keys compared.",
            "items": {
              "type": "string"
            }
          },
          "mcpConnectors": {
            "title": "Pipe results into your apps (optional)",
            "type": "array",
            "description": "Optionally send the scraped results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize a connector once under Apify Settings, Integrations, then select it here. The connector receives a condensed summary per item; the full record stays in the dataset. Leave empty to skip."
          },
          "notionParentPageUrl": {
            "title": "Notion parent page (Notion connector only)",
            "type": "string",
            "description": "URL (or id) of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors."
          },
          "maxNotifyListings": {
            "title": "Max items to export per connector",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Cap on items written to each connector per run. Does not affect the dataset.",
            "default": 50
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}