Udemy Course Catalog & Instructor Finder

Scrape Udemy course catalog data — search by keyword, browse categories and topics, fetch specific course URLs, or pull an instructor's full portfolio. Every course record can include current and list price, discounts, ratings, subscriber counts, full section/lecture curriculum, learning outcomes, requirements, certificate and caption details, badges, dates, category IDs, and instructor profiles. No account, cookies, API key, or proxy setup is required.

What this actor does

• Four modes: search, browse, byCourseUrls, byInstructors
• The filters buyers use: level, free/paid, language, minimum rating, video length, quizzes, practice tests, coding exercises, role-play, certification prep, and closed-caption languages
• Full course records: price and discount objects, subscriber and review counts, curriculum sections, description, outcomes, requirements, target audience, certificate, captions, badges, dates, category IDs, and instructor details
• Instructor portfolios: a profile record with course/student/review totals and social links, followed by every course the instructor teaches
• Pagination: up to 250 courses per request and a 10,000-course cap per search or browse slice, with honest status messages when a slice is capped
• Empty fields are omitted — a course without a headline, discount, or badge simply will not carry that key

Output per course

• courseId — Udemy's numeric course ID
• title, headline, publishedTitle — course title, tagline, and URL slug
• url, imageUrl — absolute course page and CDN image URLs
• isPaid — true for paid courses, false for free ones
• price, priceNumeric, priceCurrency — current price as shown and as a number
• listPrice, listPriceNumeric — pre-discount price when Udemy reports a discount
• discountPrice, discountPriceNumeric, discountPercent — active sale price and saving
• avgRating, numReviews, numSubscribers — rating and social proof
• numLectures, numSections, numQuizzes, numPracticeTests, numCodingExercises, numAssignments
• contentLengthMin, contentInfo, contentInfoShort — total video length in minutes and as displayed
• level — All Levels, Beginner, Intermediate, or Expert
• hasCertificate, hasClosedCaption, captionLanguages[]
• primaryCategory, primaryCategoryId, primaryCategoryUrl
• primarySubcategory, primarySubcategoryId, primarySubcategoryUrl
• locale, language — course locale code and language name
• instructors[], primaryInstructor, instructorsDetail[] — names plus ID, title, image, and URL per instructor
• createdAt, publishedAt, lastUpdated — ISO dates
• description — plain-text course description
• whatYouWillLearn[], requirements[], targetAudiences[], badges[]
• curriculum[] — sections with title and items carrying title, type, isFree, and isPreviewable
• recordType: "course", siteName: "Udemy", scrapedAt

Output per instructor (mode = byInstructors)

• instructorId, name, title, description
• imageUrl, url
• numCourses, numStudents, numReviews
• socialLinks — populated social/profile links
• recordType: "instructor", scrapedAt

Input

Field	Type	Default	Description
mode	string	search	search, browse, byCourseUrls, or byInstructors
searchQueries	array	["python"]	Keywords to search (mode=search)
category	select	any	Top-level category to browse (mode=browse)
subcategory	select	any	Subcategory to browse; takes precedence over category (mode=browse)
topics	array	–	Topic slugs or URLs, e.g. python (mode=browse)
browseUrls	array	–	Category, subcategory, or topic URLs to merge (mode=browse)
courseUrls	array	["complete-python-bootcamp"]	Course URLs, slugs, or numeric IDs (mode=byCourseUrls)
instructorIds	array	–	Instructor usernames, profile URLs, or numeric IDs (mode=byInstructors)
level	select	any	All Levels, Beginner, Intermediate, or Expert
price	select	any	Free or paid courses
language	select	any	Course language
minAverageRating	number	–	Minimum average rating (0–5)
videoLength	select	any	0–1, 1–3, 3–6, 6–12, or 12+ hours
mustHaveQuiz	boolean	false	Only courses with quizzes
mustHavePracticeTest	boolean	false	Only courses with practice tests
mustHaveCodingExercise	boolean	false	Only courses with coding exercises
mustHaveRoleplay	boolean	false	Only courses with role-play exercises
isCertificationPrep	boolean	false	Only certification-preparation courses
closedCaptionLanguages	array	–	Required caption languages, e.g. ["EN", "ES"]; append _CC for human-authored captions (e.g. EN_CC)
sortBy	select	RELEVANCE	RELEVANCE, RATING, REVIEWS, or TIME
maxItems	integer	50	Maximum records to return (1–10,000)
includeDetails	boolean	true	Fetch full price, subscriber, date, and outcome data for search/browse results
includeCurriculum	boolean	true	Fetch each course's section and lecture list
includeInstructorProfile	boolean	true	Emit an instructor profile before their courses; it counts toward maxItems (mode=byInstructors)

Example: keyword search with quality filters

{
  "mode": "search",
  "searchQueries": ["python", "data science"],
  "level": "BEGINNER",
  "minAverageRating": 4.5,
  "videoLength": "MEDIUM",
  "sortBy": "RATING",
  "maxItems": 100
}

Example: browse a subcategory with curriculum

{
  "mode": "browse",
  "subcategory": "8",
  "price": "PAID",
  "language": "EN",
  "includeCurriculum": true,
  "maxItems": 50
}

Example: fetch specific courses by URL

{
  "mode": "byCourseUrls",
  "courseUrls": [
    "https://www.udemy.com/course/complete-python-bootcamp/",
    "100-days-of-code",
    "567828"
  ],
  "includeCurriculum": true,
  "maxItems": 3
}

Example: an instructor's full portfolio

{
  "mode": "byInstructors",
  "instructorIds": ["joseportilla"],
  "includeInstructorProfile": true,
  "maxItems": 50
}

Use cases

• Course market research — compare prices, discounts, ratings, and subscriber counts across a category
• Curriculum benchmarking — compare section and lecture structure across competing courses
• Instructor scouting — pull a teacher's full catalog and audience size before a partnership
• Deal monitoring — track list prices, sale prices, and discount percentages over time
• Learning-path planning — build a shortlist of courses by language, level, duration, and learning outcomes
• Catalog enrichment — add Udemy course metadata, badges, and captions to an internal catalog

FAQ

Do I need a Udemy account, cookies, or an API key? No. The actor reads publicly available course and instructor information without signing in.

Do I need to configure a proxy? No. The actor connects to Udemy automatically; there is nothing to set up.

How many courses can I get in one run? maxItems supports up to 10,000. Udemy also caps a single search or browse slice at 10,000 results, so use several queries or browse targets (categories/topics) to reach more.

How long does a large run take? Each course needs one detail request, and includeCurriculum adds one more. The actor paces requests to stay under Udemy's rate limits, so a run that enriches thousands of courses with details and curriculum can take a long time. For very large collections, turn off includeDetails/includeCurriculum or split the work into several queries or browse slices.

Why is review text not included? Udemy hides most review bodies from signed-out visitors. Aggregate rating and review counts are included, but review text requires a login and is outside this actor's cookieless scope.

Why are some fields missing from a record? Not every course has a discount, badge, subcategory, caption track, or extra content type. Empty values are omitted instead of written as null.

Which currency are prices in? Prices are the anonymous price Udemy serves the actor's connection, and priceCurrency reports the ISO code Udemy returns for that price (most often USD, but a proxy exit in another region can return EUR or another currency). Numeric fields use the same currency as price; no local-currency conversion is performed.

Why is listPrice missing on most courses? Udemy only reports a list price while a discount is active. Outside a sale, the current price and list price are the same, so only price is present.

Can I get an instructor profile for a numeric ID? Username and profile-URL inputs return the profile record plus courses. Numeric IDs still return all taught courses, but Udemy does not expose the profile page for a numeric ID alone.

Why does numLectures differ from the number of curriculum items? Udemy's course header counts video lectures, while the curriculum also lists quizzes, coding exercises, articles, and assignments. numSections and the item-level type values show the full structure.

Is this affiliated with Udemy? No. This is an independent, third-party actor that reads publicly available Udemy data.