# Preply Scraper - Online Tutors, Prices, Ratings & Reviews (`abotapi/preply-scraper`) Actor

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.

- **URL**: https://apify.com/abotapi/preply-scraper.md
- **Developed by:** [Abot API](https://apify.com/abotapi) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.40 / 1,000 tutor results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Preply Scraper

Collect online tutors from Preply (preply.com): hourly price, trial price, rating, reviews, lessons taught, languages, subjects, education, certificates and availability for any subject, filter or tutor link. One clean record per tutor, ready for market research and price monitoring.

### Why This Scraper?

- **Full tutor profiles.** With details on, each tutor carries the join date, last seen, response time, availability, education, work experience, certificates, specialties and the latest reviews.
- **Every price level.** Hourly price, trial lesson price and the US dollar price in one row, with the currency.
- **Reviews included.** Score, text, language and translations of the latest reviews, the star distribution and the rating breakdown per lesson aspect.
- **Three ways in.** Search by subject with filters, paste search or profile links, or mix them in one run.
- **Real filters.** Price range, keyword, specialties, sort order, country of birth, second language, native speakers, certified teachers and Super Tutors.
- **Price change tracking.** Schedule recurring runs and receive only new tutors and real price, availability or profile changes, optionally as compact rows.
- **Safe caps.** One clear item cap, with resume support for interrupted runs.

### Use Cases

- **Market research:** compare tutor prices, ratings and supply across subjects and countries.
- **Price monitoring:** track hourly prices and availability of a tutor group and get only the changes.
- **Lead lists for education products:** build a list of top rated tutors by subject, language and specialty.
- **Content and ranking analysis:** study which headlines, badges and specialties go with high ratings and many lessons.

### Data You Get

> Sample shape: values are illustrative placeholders, not from a live record.

| Field | Example |
| --- | --- |
| `id` | `0000000` |
| `fullName` | `Jane D.` |
| `publicUrl` | `preply.com/en/tutor/0000000` |
| `headline` | `Example headline` |
| `shortBio` | `Example biography` |
| `countryOfBirth` | `Example Country` |
| `countryCode` | `XX` |
| `price` | `25` |
| `currencyCode` | `USD` |
| `priceTrial` | `12.5` |
| `averageScore` | `4.9` |
| `numberReviews` | `100` |
| `totalLessons` | `1000` |
| `yearsOfExperience` | `5` |
| `isSuperTutor` | `true` |
| `hasAvailability` | `true` |
| `subjects` | `Subjects with badge and retention tier` |
| `languageLevels` | `Languages with level` |
| `specialtyTags` | `Specialties` |
| `educations` | `Education entries` |
| `certificates` | `Certificates` |
| `reviews` | `Latest reviews with score, text, language` |
| `reviewDistribution` | `Reviews per star` |
| `scrapedAt` | `2026-01-01T00:00:00Z` |

### How to Use

1. Pick a mode: search by subject, or paste Preply links.
2. Set the filters, the sort order and the maximum number of items.
3. Run the actor.
4. Download the dataset as JSON, CSV or Excel, or read it through the API.

**Search by subject:**

```json
{ "mode": "search", "subjects": ["english"], "minPrice": 10, "maxPrice": 20, "sortBy": "rating", "maxItems": 50 }
```

**Paste links:**

```json
{ "mode": "url", "urls": ["https://preply.com/en/online/english-tutors?searchText=ielts", "https://preply.com/en/tutor/1347910"], "maxItems": 100 }
```

Pages that carry no tutors, such as city pages, localized subject pages and the site map, are skipped with a warning.

**Recurring price monitoring:**

```json
{ "mode": "search", "subjects": ["english"], "incrementalMode": true, "changeScope": "priceAndStock", "compactUpdates": true, "maxItems": 500 }
```

#### Run it from your code

Python:

```python
from apify_client import ApifyClient
client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("<ACTOR_ID>").call(run_input={"mode": "search", "subjects": ["english"], "maxItems": 20})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["fullName"], item["price"], item["averageScore"])
```

JavaScript:

```javascript
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('<ACTOR_ID>').call({ mode: 'search', subjects: ['english'], maxItems: 20 });
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items.length);
```

#### Tips

- A search can be walked to page 99, which is 990 tutors. Add filters (price range, country, specialties) to reach tutors beyond that.
- Turn off Add profile details when the search card fields are enough: each profile page is a separate, larger read.
- Prices are shown in the currency of the connection country (US dollars by default). The US dollar price is also kept in `seoPriceUsd` when the search card carries it.
- Use Price and availability only with Compact update rows for the leanest monitoring feed.

### Send results into your apps (MCP connectors)

Optionally send a condensed summary of the results into Notion, Linear, Airtable or Apify through Model Context Protocol connectors. Authorize a connector once in your Apify integrations settings, then select it in the input. The full records always stay in the dataset.

### Input Parameters

| Parameter | Type | Default | Description |
| --- | --- | --- | --- |
| `mode` | string | search | Search by subject or paste links. |
| `subjects` | array | english | Subjects as in the site address, one per line. |
| `searchText` | string | empty | Keyword within the subject. |
| `specialties` | array | empty | Specialty codes such as testprep_ielts. |
| `sortBy` | string | relevance | Recommended, price low to high or high to low, most popular, most reviews, highest rating. |
| `minPrice` | integer | empty | Lowest hourly price in US dollars. |
| `maxPrice` | integer | empty | Highest hourly price in US dollars. |
| `countryOfBirth` | string | empty | Two letter country code of the tutor. |
| `alsoSpeaks` | string | empty | Language code the tutor also speaks. |
| `nativeSpeaker` | boolean | false | Native speakers only. |
| `certifiedOnly` | boolean | false | Certified teachers only. |
| `superTutorsOnly` | boolean | false | Super Tutors only. |
| `urls` | array | sample links | Tutor search or profile links. |
| `fetchDetails` | boolean | true | Adds the full profile: education, certificates, specialties, reviews and more. |
| `maxReviews` | integer | 20 | Latest reviews kept per tutor (0 skips reviews). |
| `maxPages` | integer | empty | Pages per search; does not cap the run on its own. |
| `maxItems` | integer | 20 | Maximum results; 0 means unlimited. |
| `proxy` | object | Apify Proxy | Connection settings. |
| `resumeFromRunId` | string | empty | Skip tutors already collected by an earlier run. |
| `incrementalMode` | boolean | false | Return only new or changed tutors. |
| `stateKey` | string | empty | Name a monitoring campaign. |
| `baselineDatasetId` | string | empty | Start incremental tracking from an earlier dataset. |
| `emitExpired` | boolean | false | Also return tutors that are no longer found, after a complete scan. |
| `changeScope` | string | all | All tracked fields, or price and availability only. |
| `compactUpdates` | boolean | false | Short UPDATED and EXPIRED rows with old and new values. |
| `expireAfterMissedScans` | integer | 1 | Complete scans a tutor must be missing before it expires. |
| `ignoreFieldsForChanges` | array | empty | Extra fields that never mark a tutor as updated. |
| `mcpConnectors` | array | empty | Connectors to send results to. |
| `notionParentPageUrl` | string | empty | Notion parent page. |
| `maxNotifyListings` | integer | 50 | Items exported per connector. |

#### Connection and plans

This site needs a residential Apify Proxy connection for reliable results, so the Residential group is selected by default. It is billed by traffic on your account, and each search page and profile page is about 2 MB, so keep Max items modest. If the selected connection is refused, the run switches to a backup connection on its own and says so in the log. Apify free plans do not include residential proxies: on a free plan the run continues on the backup connection and some pages may be unavailable. A single run caps its own residential traffic; once the cap is reached it continues on the standard connection, where more pages may be unavailable, and says so in the log. If you pick the datacenter group yourself, expect more missing pages: Residential is recommended for the most reliable results.

### Output Example

> Sample shape: values are illustrative placeholders, not from a live record.

```json
{
  "id": 0,
  "position": 1,
  "fullName": "Jane D.",
  "publicUrl": "https://preply.com/en/tutor/0000000",
  "headline": "Example headline",
  "countryOfBirth": "Example Country",
  "countryCode": "XX",
  "price": 25,
  "currencyCode": "USD",
  "priceTrial": 12.5,
  "averageScore": 4.9,
  "numberReviews": 100,
  "totalLessons": 1000,
  "isSuperTutor": true,
  "hasAvailability": true,
  "subjects": [{ "alias": "english", "name": "English", "topLessonsBadge": "TOP_5", "retentionTier": "HIGH" }],
  "languageLevels": [{ "language": "English", "levelCode": "C2", "level": "Proficient", "canSpeak": true }],
  "certificates": [{ "dates": "2020 - 2020", "certificate": "Example certificate", "verified": true }],
  "reviewDistribution": { "1": 0, "2": 0, "3": 0, "4": 1, "5": 38 },
  "reviews": [{ "id": "0", "score": 5, "content": "Example review", "created": "2026-01-01T00:00:00+00:00", "language": "en", "translations": [] }],
  "scrapedAt": "2026-01-01T00:00:00Z"
}
```

### Plan Requirement

A paid Apify plan is recommended: the residential connection this site needs is part of paid plans. Apify free plans have no residential proxies, so the run falls back to a backup connection where some pages may be unavailable. Billing follows the pricing shown on the Store page.

### FAQ

#### How much does a run cost?

You pay per run start, per tutor returned and, when details are on, per tutor whose profile page was read, plus one more unit for every 10 reviews delivered on that tutor (rounded up; Max reviews per tutor defaults to 20). Rows without profile data are not charged for details: compact update rows (Compact updates in monitoring mode) and tutors whose profile page could not be read. Set Max items to control the total.

#### Is it legal to scrape Preply?

The actor reads publicly visible tutor information. You are responsible for using the data in line with applicable law and the site terms.

#### Can I schedule runs?

Yes. Use Incremental mode on a schedule to receive only changes, and Price and availability only when prices are all you care about.

#### Why did a run return nothing?

The subject may not exist on the site, the filters may be too strict, or a pasted link may be a page without tutors. Try a broader subject or relax the filters.

#### Why do I get at most 990 tutors for one search?

The site serves 99 pages of 10 tutors per search. Split a large search with filters such as price range, country of birth or specialties.

#### Can I use it with AI tools?

Yes, through the Apify MCP server or the connectors above.

### 🔗 More scrapers you might like

Pair this actor with these related scrapers from the same team:

<table>
<tr><td>💼 <a href="https://apify.com/abotapi/superprof-tutor-scraper"><b>Superprof Scraper</b></a><br>Scrape Superprof tutors by subject and location, or paste tutor URLs. One rich record per...</td><td>📇 <a href="https://apify.com/abotapi/justia-lawyer-scraper"><b>Justia Lawyer Profiles, Reviews &amp; Office Locations Scraper</b></a><br>Scrape attorney profiles from the Justia Lawyer Directory. Extract names, contacts...</td></tr>
<tr><td>📱 <a href="https://apify.com/abotapi/trustmate-io-reviews-scraper"><b>TrustMate.io</b></a><br>Scrape complete company review histories from TrustMate.io. Paste company profile URLs...</td><td>🧩 <a href="https://apify.com/abotapi/duolingo-learner-scraper"><b>Duolingo Scraper</b></a><br>Scrape public Duolingo data without login. Extract learner profiles with streaks, XP and...</td></tr>
<tr><td>💼 <a href="https://apify.com/abotapi/jobs-cz-scraper"><b>Jobs.cz</b></a><br>Scrape Czech job listings from Jobs.cz. Search builder (keyword, location, field, salary...</td><td>📱 <a href="https://apify.com/abotapi/clutch-directory-scraper"><b>Clutch Scraper</b></a><br>Scrape Clutch company directories and profiles. Get names, ratings, review counts, hourly...</td></tr>
</table>

👉 [Browse all abotapi scrapers](https://apify.com/abotapi)

### 💬 Support

- 🐞 **Found a bug or a missing field?** Open a ticket on the [Issues tab](https://apify.com/abotapi/preply-scraper/issues/open). We usually reply within hours.
- 🛠️ **Need another site, extra fields or a private build?** Email <contact@abotapi.com>.
- ⭐ **Enjoying it?** A quick review on the actor page helps other users find it.

# Actor input Schema

## `mode` (type: `string`):

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.

## `subjects` (type: `array`):

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.

## `searchText` (type: `string`):

Optional. Narrows the subject to tutors that match this word or phrase in their profile, for example ielts or grammar.

## `specialties` (type: `array`):

Optional specialty codes as used by the site, for example testprep_ielts, bus_gen, conv_gen. A tutor must teach every listed specialty.

## `sortBy` (type: `string`):

Order of the results. Recommended keeps the site's own ranking.

## `minPrice` (type: `integer`):

Keep only tutors whose lesson price is at least this many US dollars per hour. Empty or 0 keeps all.

## `maxPrice` (type: `integer`):

Keep only tutors whose lesson price is at most this many US dollars per hour. Empty or 0 keeps all.

## `countryOfBirth` (type: `string`):

Optional two letter country code, for example GB or US. Keeps only tutors from that country.

## `alsoSpeaks` (type: `string`):

Optional language code, for example es or fr. Keeps only tutors who also speak that language.

## `nativeSpeaker` (type: `boolean`):

Keep only tutors who are native speakers of the subject language.

## `certifiedOnly` (type: `boolean`):

Keep only tutors with a verified teaching certificate.

## `superTutorsOnly` (type: `boolean`):

Keep only tutors with the Super Tutor badge.

## `urls` (type: `array`):

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.

## `fetchDetails` (type: `boolean`):

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.

## `maxReviews` (type: `integer`):

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.

## `maxPages` (type: `integer`):

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` (type: `integer`):

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.

## `proxy` (type: `object`):

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.

## `resumeFromRunId` (type: `string`):

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` (type: `boolean`):

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.

## `stateKey` (type: `string`):

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` (type: `string`):

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` (type: `boolean`):

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.

## `changeScope` (type: `string`):

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.

## `compactUpdates` (type: `boolean`):

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.

## `expireAfterMissedScans` (type: `integer`):

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.

## `ignoreFieldsForChanges` (type: `array`):

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.

## `mcpConnectors` (type: `array`):

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` (type: `string`):

URL (or id) of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors.

## `maxNotifyListings` (type: `integer`):

Cap on items written to each connector per run. Does not affect the dataset.

## Actor input object example

```json
{
  "mode": "search",
  "subjects": [
    "english"
  ],
  "sortBy": "relevance",
  "nativeSpeaker": false,
  "certifiedOnly": false,
  "superTutorsOnly": false,
  "urls": [
    "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"
  ],
  "fetchDetails": true,
  "maxReviews": 20,
  "maxItems": 20,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  },
  "incrementalMode": false,
  "emitExpired": false,
  "changeScope": "all",
  "compactUpdates": false,
  "expireAfterMissedScans": 1,
  "ignoreFieldsForChanges": [],
  "maxNotifyListings": 50
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

## `detail` (type: `string`):

No description

## `reviews` (type: `string`):

No description

## `changes` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "search",
    "subjects": [
        "english"
    ],
    "urls": [
        "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"
    ],
    "maxReviews": 20,
    "proxy": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    },
    "incrementalMode": false,
    "emitExpired": false,
    "compactUpdates": false,
    "expireAfterMissedScans": 1,
    "ignoreFieldsForChanges": []
};

// Run the Actor and wait for it to finish
const run = await client.actor("abotapi/preply-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "search",
    "subjects": ["english"],
    "urls": [
        "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",
    ],
    "maxReviews": 20,
    "proxy": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
    "incrementalMode": False,
    "emitExpired": False,
    "compactUpdates": False,
    "expireAfterMissedScans": 1,
    "ignoreFieldsForChanges": [],
}

# Run the Actor and wait for it to finish
run = client.actor("abotapi/preply-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "search",
  "subjects": [
    "english"
  ],
  "urls": [
    "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"
  ],
  "maxReviews": 20,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  },
  "incrementalMode": false,
  "emitExpired": false,
  "compactUpdates": false,
  "expireAfterMissedScans": 1,
  "ignoreFieldsForChanges": []
}' |
apify call abotapi/preply-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,abotapi/preply-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/Yn6XPBiUa2D95M3sh/builds/NmX0GH8SvOeOrXgON/openapi.json
