Medium.Client 0.4.2

.NET 6.0
dotnet add package Medium.Client --version 0.4.2
NuGet\Install-Package Medium.Client -Version 0.4.2
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Medium.Client" Version="0.4.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Medium.Client --version 0.4.2
#r "nuget: Medium.Client, 0.4.2"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Medium.Client as a Cake Addin
#addin nuget:?package=Medium.Client&version=0.4.2

// Install Medium.Client as a Cake Tool
#tool nuget:?package=Medium.Client&version=0.4.2

NuGet Version Downloads

Unofficial Medium API .NET SDK

This SDK was developed based on Unofficial Medium API.


Install the package from Medium.Client.


You need to have a Rapid API account and subscribe to the Medium API. Follow the steps from the official documentation here.


After installing the NuGet package in your project you just need to use the following extension method to add the medium client interfaces to your service collection.


Once you have the API Key from Rapid API, you just need to add it in the following variable in your settings file or as an environment variable.

    "Medium": {
        "ApiKey": "your-key"

Supported API endpoints

API Reference

All the existing endpoints are supported by this SDK. There are some additional features to simplify the API calls. For example, the API provides an endpoint to get the user info based on the user identifier. This SDK has an additional method to get this info but is based on a username. This avoids having 2 method calls. However, in reality, the SDK will make that 2 API calls.

// 2 method calls
var userId = await _mediumClient.Users.GetIdByUsernameAsync("username");
var userInfo = await _mediumClient.Users.GetInfoByIdAsync(userId);

// 1 method call
var userInfo2 = await _mediumClient.Users.GetInfoByUsernameAsync("username");

How to use it?

In your class, you have 2 options to use the Medium client functionalities.

  • Option 1 (using the main IMediumClient interface)
public class MyService
    private readonly IMediumClient _mediumClient;

    public Worker(IMediumClient mediumClient)
        _mediumClient = mediumClient;

    public async Task ExecuteAsync()
        var user = await _mediumClient.Users.GetListsByUserIdAsync("user-id");
        var article = await _mediumClient.Articles.GetResponsesAsync("article-id");
  • Option 2 (using the specific interface)
public class MyService
    private readonly IUserClient _userClient;

    public Worker(IUserClient userClient)
        _userClient = userClient;

    public async Task ExecuteAsync()
        var user = await _userClient.GetListsByUserIdAsync("user-id");

Roadmap ✈️

  • Add in memory mock client implementation to simplify the development. With this, we can try the SDK without having Rapid API access.

  • Add retry policy.

Give me a star if you like it ⭐



Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed. 
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
0.4.2 103 7/13/2023
0.4.1 91 7/12/2023
0.4.0 96 7/12/2023
0.3.0 92 7/11/2023