# Skool API — community discovery (search, categories, price, type, language), community about + plans, feeds, posts, comments, likes, members, leaderboards, classroom, calendar, reviews, in-community search and user profiles

> Skool's discovery directory with every filter it offers: keyword, category, price (free / paid / free trial), type (public / private), language (48 languages or all) and sort (trending or top). 30 communities per page with members, price, rating and review count. The directory serves at most 1000 communities per filter combination (34 pages); `total` is the directory's own count (it stops at 1000). Combine category × price × type × language to reach more.
> ReefAPI engine `skool` · 18 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/skool/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/skool/v1/search — 1 credit
Skool's discovery directory with every filter it offers: keyword, category, price (free / paid / free trial), type (public / private), language (48 languages or all) and sort (trending or top). 30 communities per page with members, price, rating and review count. The directory serves at most 1000 communities per filter combination (34 pages); `total` is the directory's own count (it stops at 1000). Combine category × price × type × language to reach more.

**Parameters:**
- `query` (string, optional) — Keyword matched against community names and descriptions.
- `category` (string, optional) — Category slug, name or id from `categories` (31 categories). Browsing only: with `query` Skool ignores the category (measured), so the pair is refused.
- `price` (string, optional) — free, paid or free-trial. [one of: free, paid, free-trial]
- `type` (string, optional) — public or private communities. [one of: public, private]
- `language` (string, optional, default "english") — Community language: name (`spanish`) or ISO code (`es`), or `all`. Default english (the site's own default).
- `sort` (string, optional, default "trending") — trending (default) or top. Browsing only: with `query` results come in Skool's relevance order. [one of: trending, top]
- `page` (integer, optional, default 1) — Page of 30, 1-34 (the directory stops at 1000 results).

**Returns:** results[]{id, slug, name, url, description, members, is_free, price_cents, price_amount, price_currency, price_interval, membership_model, rating_average, review_count, logo_url, cover_url, color, initials, rank, created_at, updated_at} + total + total_capped + page + per_page + total_pages + has_more

**Example request body:**
```json
{
  "query": "fitness"
}
```

### POST https://api.reefapi.com/skool/v1/categories — 1 credit
The discovery directory's 31 categories (id, slug, name) and its 48 language filters — the values `search` accepts.

**Parameters:** none

**Returns:** categories[]{id, slug, name}, languages[]{name, display_name, code}

### POST https://api.reefapi.com/skool/v1/community — 2 credits
One community's about page in full: name, description and landing text, privacy, price and every membership tier with monthly / annual / one-time prices and benefits, members, online members, admins, posts, courses, lessons, rating and review count, owner profile with social links, levels with the share of members at each, feed channels with post counts, links, landing images and videos, join questions, rules, the first reviews, the 30-day leaderboard and members online now. Works for private communities too (their about page is public).

**Parameters:**
- `community` (string, required) — Community slug as in its skool.com link (`ai-automation-society`) or the link itself.

**Returns:** id, slug, name, url, description, landing_description, is_private, is_free, price_cents, price_amount, price_currency, price_interval, membership_model, membership_model_name, plans[]{tier, model, benefits[], prices{monthly|annual|one_time{price_cents, price_amount, price_currency, price_interval}}}, members, online_members, admins, posts, courses, lessons, rules_count, rules[]{title, content}, min_post_level, affiliate_percent, rating_average, review_count, owner{…user}, levels[], channels[]{id, name, description, posts}, links[], landing_media[], join_questions[], tabs{}, reviews[], leaderboard_30d, online_users[], logo_url, cover_url, created_at, updated_at

**Example request body:**
```json
{
  "community": "ai-automation-society"
}
```

### POST https://api.reefapi.com/skool/v1/posts — 1 credit
A public community's feed: 30 posts per page (page 1 also carries the pinned posts) with title, full text, author profile, channel, likes, comment count, last comment time, videos, attachments and recent commenters. Filter by channel; sort by the site's own orders: default (latest activity), new, or top of the day / week / month / year / all time. `pinned` is true for pinned posts (Skool flags them only in page 1's pinned block; a pinned post met again in its own slot on a later page, or in another sort, comes with also_listed_pinned_on_page_1=true once page 1 has been read in the last 15 minutes, otherwise pinned is null on those pages — rows stay unique by id). Private communities answer NOT_FOUND (members only).

**Parameters:**
- `community` (string, required) — Community slug as in its skool.com link (`ai-automation-society`) or the link itself.
- `channel` (string, optional) — Feed channel name or id (see `community` → channels).
- `sort` (string, optional, default "default") — default, new, top_day, top_week, top_month, top_year or top_all. [one of: default, new, top_day, top_week, top_month, top_year, top_all]
- `page` (integer, optional, default 1) — Page number, 1-based.

**Returns:** posts[]{id, slug, url, title, content, author{…}, channel_id, channel_name, pinned, likes, comments, last_comment_at, videos[], attachments[], contributors[], created_at, updated_at, edited_at, also_listed_pinned_on_page_1} + total + page + total_pages + has_more + pinned_known + pinned_ids + channels[]

**Example request body:**
```json
{
  "community": "ai-automation-society"
}
```

### POST https://api.reefapi.com/skool/v1/post — 1 credit
One post in full: title, text, author profile, channel, likes, comment count, videos, attachments (file name, type, size, dimensions, link), image preview, recent commenters, followers of the post and its timestamps.

**Parameters:**
- `post` (string, required) — Post link, or `<community>/<post-slug>`, or the post slug with `community` set.
- `community` (string, optional) — Community slug — only needed when `post` is a bare post slug.

**Returns:** id, slug, url, title, content, author{…}, channel_id, likes, comments, last_comment_at, videos[], attachments[], contributors[], post_followers, main_image_url, created_at, updated_at, edited_at, community_id

**Example request body:**
```json
{
  "post": "https://www.skool.com/ai-automation-society/new-video-the-simplest-way-to-make-money-online-with-claude-ai-in-2026"
}
```

### POST https://api.reefapi.com/skool/v1/comments — 2 credits
A post's comments, 25 top-level comments per page, each with its full reply thread (author profile, text, likes, attachments, timestamps). Page with `cursor` (the previous page's `next_cursor`); the first page also returns the pinned comment.

**Parameters:**
- `post` (string, required) — Post link, or `<community>/<post-slug>`, or the post slug with `community` set.
- `community` (string, optional) — Community slug — only needed when `post` is a bare post slug.
- `cursor` (string, optional) — `next_cursor` from the previous page; omit for the first page.

**Returns:** post{id, slug, url, title, comments}, comments[]{id, content, author{…}, likes, created_at, replies[]}, pinned_comment, next_cursor, has_more

**Example request body:**
```json
{
  "post": "https://www.skool.com/ai-automation-society/new-video-the-simplest-way-to-make-money-online-with-claude-ai-in-2026"
}
```

### POST https://api.reefapi.com/skool/v1/post_likes — 2 credits
Who liked a post: 20 profiles per page with bio, location, level, points and social links, plus the post's total like count. Page with `cursor`.

**Parameters:**
- `post` (string, required) — Post link, or `<community>/<post-slug>`, or the post slug with `community` set.
- `community` (string, optional) — Community slug — only needed when `post` is a bare post slug.
- `cursor` (string, optional) — `next_cursor` from the previous page.

**Returns:** post{id, slug, url, likes}, users[]{…user}, total, next_cursor, has_more

**Example request body:**
```json
{
  "post": "https://www.skool.com/ai-automation-society/new-video-the-simplest-way-to-make-money-online-with-claude-ai-in-2026"
}
```

### POST https://api.reefapi.com/skool/v1/members — 1 credit
Members of a public community with their profile (bio, location, level, points, social links, time zone, last online) and their membership (role, join request and approval dates). Filter: all members, admins or online now, and level 1-9; `total` is the count for that filter. Logged out, Skool shows the first 30 of each filter only (later pages repeat the first, measured) — use `search_community` with type=members to page through members by name.

**Parameters:**
- `community` (string, required) — Community slug as in its skool.com link (`ai-automation-society`) or the link itself.
- `filter` (string, optional, default "all") — all (default), admin or online. [one of: all, admin, online]
- `level` (integer, optional) — Only members at this level (1-9).

**Returns:** members[]{…user, membership{role, approved_at, requested_at, last_offline_at}} + total + members_total + admins_total + online_total

**Example request body:**
```json
{
  "community": "ai-automation-society"
}
```

### POST https://api.reefapi.com/skool/v1/leaderboard — 1 credit
A public community's leaderboards: top 10 of the last 7 days, the last 30 days and all time (rank, points, profile), plus every level with its name and the share of members at it.

**Parameters:**
- `community` (string, required) — Community slug as in its skool.com link (`ai-automation-society`) or the link itself.

**Returns:** last_7_days{rows[]{rank, points, user{…}}}, last_30_days{…}, all_time{…}, levels[]{number, name, title, percent_of_members, courses unlocked}

**Example request body:**
```json
{
  "community": "ai-automation-society"
}
```

### POST https://api.reefapi.com/skool/v1/courses — 1 credit
A public community's classroom: every course with title, description, cover, number of lessons, whether a logged-out visitor can open it, and its lock (level or tier) — then `course` for the lessons.

**Parameters:**
- `community` (string, required) — Community slug as in its skool.com link (`ai-automation-society`) or the link itself.

**Returns:** courses[]{id, name, url, title, description, lessons, has_access, privacy, min_access_level, cover_image_url, created_at, updated_at}

**Example request body:**
```json
{
  "community": "ai-automation-society"
}
```

### POST https://api.reefapi.com/skool/v1/course — 2 credits
One course with every set and lesson: titles, lesson text, video link, length and thumbnail, resources. Locked courses return the lesson titles only (that is all the site shows).

**Parameters:**
- `community` (string, optional) — Community slug — not needed when `course` is a classroom link.
- `course` (string, required) — 8-character course code from `courses` or a classroom link.

**Returns:** course{id, name, url, title, description, lessons, has_access, children[]{id, type, title, description, video_url, video_length_ms, resources, children[]}}

**Example request body:**
```json
{
  "course": "3d31807e"
}
```

### POST https://api.reefapi.com/skool/v1/events — 1 credit
A public community's calendar for one month: every event with title, description, start and end time (with the event's own UTC offset), time zone, location or call link, cover and occurrence id.

**Parameters:**
- `community` (string, required) — Community slug as in its skool.com link (`ai-automation-society`) or the link itself.
- `month` (string, optional) — Month as YYYY-MM; default the current month.

**Returns:** month, time_zone, events[]{id, title, description, start_time, end_time, time_zone, location_type, location, cover_image_url, occurrence_id}, count

**Example request body:**
```json
{
  "community": "ai-automation-society"
}
```

### POST https://api.reefapi.com/skool/v1/event — 1 credit
One calendar event by id with its recurrence rule (frequency, interval, weekdays), first start and end, time zone and location.

**Parameters:**
- `event` (string, required) — 32-character event id from `events`.

**Returns:** id, title, description, start_time, end_time, time_zone, recurrence{frequency, interval, days}, location_type, location, cover_image_url, community_id

**Example request body:**
```json
{
  "event": "8c9c538406fb40358185a5c2aa3c8f47"
}
```

### POST https://api.reefapi.com/skool/v1/reviews — 2 credits
A community's member reviews: star rating, text, reviewer profile, member-since date and whether the reviewer is currently paying, up to 50 per page, sorted top (default) or most recent. Works for private communities.

**Parameters:**
- `community` (string, required) — Community slug as in its skool.com link (`ai-automation-society`) or the link itself.
- `sort` (string, optional, default "top") — top (default) or recent. [one of: top, recent]
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 20) — Reviews per page, 1-50.

**Returns:** reviews[]{id, rating, body, created_at, member_since, member_currently_paying, reviewer{…}}, rating_average, review_count, page, has_more

**Example request body:**
```json
{
  "community": "ai-automation-society"
}
```

### POST https://api.reefapi.com/skool/v1/search_community — 1 credit
Search inside one public community, as its own search box does: posts (10 per page), members (10 per page, with their membership) or lessons (matching course lessons). Up to 100 pages (1000 results) — the site's own cap.

**Parameters:**
- `community` (string, required) — Community slug as in its skool.com link (`ai-automation-society`) or the link itself.
- `query` (string, required) — Text to search for (cannot be empty).
- `type` (string, optional, default "posts") — posts (default), members or lessons. [one of: posts, members, lessons]
- `page` (integer, optional, default 1) — Page, 1-100.

**Returns:** type, results[] (posts / members / lessons), total, page, total_pages, has_more, totals{posts, members, lessons}

**Example request body:**
```json
{
  "community": "ai-automation-society",
  "query": "fitness"
}
```

### POST https://api.reefapi.com/skool/v1/user — 1 credit
A Skool user's public profile: name, handle, bio, location, social links, followers, following, contributions, communities they own and are a member of (with members and price), one year of daily activity counts, last online, time zone, join date.

**Parameters:**
- `user` (string, required) — Skool handle (`@nateherk` or `nateherk`), profile link, or 32-character user id.

**Returns:** id, handle, name, url, bio, location, picture_url, website_url, instagram_url, linkedin_url, twitter_url, youtube_url, facebook_url, followers, following, contributions, communities_total, communities_owned[], communities_member_of[], daily_activity{start_date, end_date, counts[]}, last_offline_at, time_zone, joined_skool_at

**Example request body:**
```json
{
  "user": "@nateherk"
}
```

### POST https://api.reefapi.com/skool/v1/user_followers — 1 credit
A user's followers or the people they follow, with full profiles, and the total count. Logged out Skool shows the first 30 only (later pages repeat the first, measured).

**Parameters:**
- `user` (string, required) — Skool handle (`@nateherk` or `nateherk`), profile link, or 32-character user id.
- `type` (string, optional, default "followers") — followers (default) or following. [one of: followers, following]

**Returns:** user{id, handle, name, url}, type, total, users[]{…user}

**Example request body:**
```json
{
  "user": "@nateherk"
}
```

### POST https://api.reefapi.com/skool/v1/user_posts — 1 credit
Posts one user wrote inside one public community, newest first, 10 per page, with the total.

**Parameters:**
- `user` (string, required) — Skool handle (`@nateherk` or `nateherk`), profile link, or 32-character user id.
- `community` (string, required) — Community slug as in its skool.com link (`ai-automation-society`) or the link itself.
- `page` (integer, optional, default 1) — Page number, 1-based.

**Returns:** posts[]{…post}, total, page, total_pages, has_more

**Example request body:**
```json
{
  "community": "ai-automation-society",
  "user": "@nateherk"
}
```

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=skool
- Human docs page: https://reefapi.com/docs/skool
- Overview page: https://reefapi.com/skool-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
