Text and Images API Reference

You can bold text on Quizlet by surrounding it with asterisks. Text typed as "*this is bold* but this is not" will appear on Quizlet as "this is bold but this is not."

You can also add images to sets on Quizlet. When you add or edit sets you can optionally send "image identifiers" to associate uploaded images to those sets. You can also add images when editing a single term in a set.

Only Quizlet PLUS members can upload images.
You can tell if a user is a PLUS member by checking account_type = "plus" when viewing the user.

This page only lists successful responses. For information about possible error responses, read the API Introduction.

Technical Notes on Uploading Images

  • The form encoding of the POST request must be multipart/form-data.
  • All images uploaded to our server are resized and stored with a maximum of 1024 pixels on the longest side (so there's no point in uploading huge files).
  • The maximum size per image is 5Mb (but, as per the previous point, there's no need for images anywhere near that large).
  • The total size of all images in a single request must be less than 20Mb.
  • If you exceed any size restrictions you will get a validation error explaining that the file size is too big (and no images will be saved).

It is recommended that you resize large files before uploading them to Quizlet for a few reasons:

  1. It will reduce the upload time and save the user's bandwidth.
  2. We only store images with 1024 pixels on the longest edge, so there is no quality advantage of sending large files.
  3. With an upper limit of 20Mb per request, you could upload 10 x 2Mb images vs 100 x 200Kb images!

To make the user experience better (and to avoid sending unnecessarily large amounts of data), the best practice is to check the image size and total size before posting images to our server.

Uploading Images

POSThttps://api.quizlet.com/2.0/imagesUpload one or more images


  • Requires a write_set-scoped access token authorized by a Quizlet Plus user.

When you upload one or more images to Quizlet, you get back an array of "image identifiers". You can use these identifiers when adding or editing sets to associate these images to the set(s). Image identifiers are based on the content of the image and last forever (so you can reuse the same identifier across sets if you want the same image).

Expand request fields

Required Parameters

imageData[]arrayAn array of one or more images.

Expand response fields

Image Object

id string Quizlet's unique ID for the image uploaded. These identifiers are used to associate terms to images when adding or editing sets.
url string The URL to the medium-size image on Quizlet. See the table below about image sizes.

An example of adding a new set with images

In the below example you can see a command-line cURL request to upload two images and create a new set with 3 terms (with only 2 of the terms containing images).

The first API call we make is to upload our two images:

curl -H "Authorization: Bearer MY_ACCESS_TOKEN" -i -X POST -F "whitespace=1" \
	 -F "imageData[]=@/path/to/images/milk.jpg" \
	 -F "imageData[]=@/path/to/images/peas.jpg" \

HTTP/1.1 200 Ok
Date: Tue, 26 Jul 2011 21:52:19 GMT
Server: Apache
Content-Length: 150
Content-Type: application/json
    "id": "aGFzaD04WEFtRGQxcVh5M2VLcXo2RW92S0t3JmFzcGVjdD0yNDB4MTYw",
    "url": "http:\/\/o.quizlet.com\/i\/8XAmDd1qXy3eKqz6EovKKw_m.jpg"
    "id": "aGFzaD00Q3RPNk5Ma3N2bnB2RFZVd1BPdlJBJmFzcGVjdD0yNDB4MTgw",
    "url": "http:\/\/o.quizlet.com\/i\/4CtO6NLksvnpvDVUwPOvRA_m.jpg"

We then make a second call to create a new set, using the image identifiers we received in the previous call. Notice that the second term has no image, so we specified an empty identifier:

curl -H "Authorization: Bearer MY_ACCESS_TOKEN" -i -X POST -F "whitespace=1" \
	-F "terms[]=lait" -F "definitions[]=milk" -F "images[]=aGFzaD04WEFtRGQxcVh5M2VLcXo2RW92S0t3JmFzcGVjdD0yNDB4MTYw" \
	-F "terms[]=invisibles" -F "definitions[]=invisible" -F "images[]=" \
	-F "terms[]=petits pois" -F "definitions[]=peas" -F "images[]=aGFzaD00Q3RPNk5Ma3N2bnB2RFZVd1BPdlJBJmFzcGVjdD0yNDB4MTgw" \
	-F "title=My first set with images via the API" \
	-F "lang_terms=fr" -F "lang_definitions=en" \

HTTP/1.1 201 Created
Location: http://api.quizlet.com/2.0/sets/7565059
Date: Tue, 26 Jul 2011 21:52:19 GMT
Server: Apache
Content-Length: 100
Content-Type: application/json
	"url": "https:\/\/quizlet.com\/7565059\/my-first-set-with-images-via-the-api-flash-cards\/",
	"term_count": 3,
	"set_id": 7565059

Image sizes

By default, the image URL provided is the "medium" size with a maximum side of 240 pixels. This is indicated in the URL with a suffix of _m.jpg.

You can change the image URL suffix to access the other sizes. The table below shows the different size available. For the examples below, we are using the fake filename of orange_picture.jpg (note in the response you would actually get the URL of orange_picture_m.jpg because the medium size is the default).

Size Dimensions Suffix Example
Thumbnail 100 pixels on longest side _t orange_picture_t.jpg
Small Square 75x75 pixels _s orange_picture_s.jpg
Medium (default) 240 pixels on longest side _m orange_picture_m.jpg
Large 500 pixels on longest side none orange_picture.jpg
Very Large 1024 pixels on longest side _b orange_picture.jpg

Images may come from different domains such as o.quizlet.com or farm1.staticflickr.com, but the size suffix (e.g. _m.jpg, etc) is standardized.