⚠️ Important Notice (January 2025)
The Udemy Affiliate API (v2.0) has been discontinued as of January 1, 2025, according to Udemy’s official documentation.

As a result, Pydemy is no longer functional, since it depends on the discontinued API.

This repository remains available for educational and archival purposes only.
Future updates may explore compatibility with alternative APIs or platforms.

---

Pydemy provides a convenient way to interact with the Udemy Affiliate API from your Python applications. You can use Pydemy to search for courses, retrieve course details, fetch reviews, and potentially explore other functionalities offered by the API.

Udemy API Support

Pydemy currently supports the Udemy Affiliate API v2.0. This API allows developers to access public information about Udemy courses.

Note: The Udemy Instructor API, which provides functionalities specific to course creation and management, is not currently supported by Pydemy.

Main Features

• Synchronous and Asynchronous API Requests: Choose between synchronous and asynchronous interactions with the Udemy API. This flexibility caters to different development needs and preferences. To enhance application performance, for example, employ asynchronous calls for non-blocking activities.
• Search for Courses: Quickly find courses using a variety of parameters, such as price filters, categories, or keywords.
• Get Detailed Course Information: Get in-depth information on a particular course, such as the title, curriculum, teacher, ratings, and more.
• Get Course Reviews: By retrieving and examining reviews for a specific course, you can learn a great deal about the experiences of students.
• Use Pydantic for Data Management and Validation: The pydemy library makes extensive use of the potent Pydantic library. It offers an organized method of working with the data and guarantees that the information obtained from the Udemy API is accurate. This facilitates robust interactions with the Udemy API and makes programming easier.

Getting Started

1. Obtain API Credentials: Visit Udemy API Clients to create a new API client and obtain your clientID and clientSecret.

2. Installation: Install the library using pip:

   pip install pydemy

3. Usage: Import the UdemyClient class:

   from pydemy import UdemyClient

   Initialize the client with your API credentials:

   client_id = "YOUR_CLIENT_ID"
   client_secret = "YOUR_CLIENT_SECRET"
   
   client = UdemyClient(client_id=client_id, client_secret=client_secret)

Quickstart

Here is an example that demonstrates how to get started with using the UdemyClient to retrieve information about public courses.

For more in-depth examples and usage scenarios, be sure to check out the examples folder.

client = UdemyClient(client_id="YOUR_CLIENT_ID", client_secret="YOUR_CLIENT_SECRET")

# Get a list of public courses (replace '4534650' with a specific course ID for details)
courses = client.get_public_curriculum_list(course_id=4534650)

# Print course titles
for course in courses:
    print(course.title)

Contributing

We welcome contributions from the community! If you have bug fixes, improvements, or new features, feel free to submit a pull request. For detailed guidelines on contributing, please refer to the CONTRIBUTING.rst file.

Here's a brief overview:

• Fork the repository.
• Create a new branch for your changes.
• Implement your changes and add unit tests if applicable.
• Follow consistent coding style.
• Submit a pull request with a clear description of your changes.

License

This project is licensed under the MIT License - see the LICENSE.md file for details.