(Unofficial) Duolingo API (No Auth)
This api will get your Duolingo profile's metadata. Will not require any authentication. You will only need your username or profile ID.
To find your profile ID...
- log into duolingo.com through your browser.
- Right-click, inspect on your profile picture.
- and then it should be the string of numbers after the
/avatars/
path
Usage
const Duolingo = require('duolingo-api');
const credential = {
username: 'JohnDoe1',
id: 123456789
};
// can also be {username: 'JohnDoe1}, or {id: 123456789}
let duolingo = new Duolingo(credential);
Only one identifier is required, either username
or id
.
username
property can be empty or omitted, if you are providing an id
.
id
property can be empty or omitted, if you are providing a username
.
Get By Fields
const availableFields = [
"name", "emailVerified", "learningLanguage", "globalAmbassadorStatus",
"username", "streak", "canUseModerationTools", "hasPhoneNumber",
"observedClassroomIds", "joinedClassroomIds", "courses",
"privacySettings", "bio", "inviteURL", "id", "hasPlus",
"roles", "_achievements", "currentCourseId", "creationDate",
"picture", "fromLanguage", "hasFacebookId", "optionalFeatures",
"hasRecentActivity15", "hasGoogleId", "totalXp", "achievements"
];
If you want to see an example of what each fields' data populates, look at UnauthenticatedFullResponse.json
If you're only wanting a select number of fields, create an array of fields that you want.
Then use getDataByFields()
method.
In this example, I only want the totalXp
and courses
fields.
async function getMyFields() {
const myFields = ['totalXp', 'courses'];
return await duolingo.getDataByFields(myFields);
}
getMyFields.then(data => {
console.log('My Fields Data: ', data);
// My Fields Data: {
// "courses": [
// {
// "placementTestAvailable": false,
// "healthEnabled": false,
// "learningLanguage": "ja",
// "crowns": 102,
// "xp": 6751,
// "id": "DUOLINGO_JA_EN",
// "authorId": "duolingo",
// "fromLanguage": "en",
// "title": "Japanese",
// "preload": false
// }
// ],
// "totalXp": 15385
// };
});
Get All (raw) Metadata
If you just want all the metadata (as-is) available to you, then use the getMetadata()
method.
async function getMetadata() {
return await duolingo.getRawData();
}
getMetadata.then(data => {
console.log('My Metadata: ', data);
});
The data would print out something similar to UnauthenticatedFullResponse.json.
The output is the raw format/values of what the duolingo unauthenticated response will give.
Get All (processed) Metadata
Some things it doesn't include is friendlier display names for your achievements, and the legacy levels that it once had. Levels eventually got replaced by Crowns on how Duolingo would track progress.
async function getMetadata() {
return await duolingo.getProcessedData();
}
getMetadata.then(data => {
console.log('My Processed Metadata: ', data);
});
data
will give a result similar to UnauthenticatedProcessedResponse.json.
Endpoints
// Gets raw metadata from duolingo. No pre/post-processing
duolingo.getRawData();
// Gets processed metadata from duolingo. Post-processing of adding display name for achievements,
// Adding level for each course and adding total level based on XP.
duolingo.getProcessedData();
// Gets selected fields metadata
let fields = [];
duolingo.getDataByFields();
// Identifies which level based on xp.
let xp = 1650; // or "1650"
duolingo.translateXpToLevels(xp);
// Adds a "level" property to a list of objects, as long as "xp" field is present.
let courses = [];
duolingo.addLevelToCourses(courses);
// Adds a "displayName" property to a list of objects, as long as "name" field is present.
let achievements = [];
duolingo.translateAchievements(achievements);
Extra Info
- legacy/modern achievements
- based on my observation, most of the achievements being passed back by noauth/auth responses; it is still using legacy and doesn't include the current implementation of achievements.
- experience to level table
- this table was used on how I converted XP to Levels when calling
getProcessedMetadata()
- this table was used on how I converted XP to Levels when calling