<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>The Quizlet Blog &#187; The Quizlet API</title>
	<atom:link href="http://quizlet.com/blog/archives/category/faqs/the-quizlet-api/feed" rel="self" type="application/rss+xml" />
	<link>http://quizlet.com/blog</link>
	<description>Quizlet's founder discusses feature updates, news, and Quizlet's principles</description>
	<lastBuildDate>Sun, 18 Oct 2009 00:16:56 +0000</lastBuildDate>
	<generator>http://wordpress.org/?v=2.8.6</generator>
	<language>en</language>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
			<item>
		<title>FAQ: The Quizlet Flashcards API</title>
		<link>http://quizlet.com/blog/archives/403</link>
		<comments>http://quizlet.com/blog/archives/403#comments</comments>
		<pubDate>Mon, 29 Jun 2009 20:10:55 +0000</pubDate>
		<dc:creator>Andrew</dc:creator>
				<category><![CDATA[FAQs]]></category>
		<category><![CDATA[The Quizlet API]]></category>

		<guid isPermaLink="false">http://quizlet.com/blog/?p=403</guid>
		<description><![CDATA[The Quizlet API lets developers interested in building a flashcard application use Quizlet&#8217;s vast content database of about 30 million flashcards. As the #1 flashcard library on the Internet, Quizlet has more flashcards in more subjects than anyone else, all easily searchable and downloadable. The Quizlet API lets you search for and download Quizlet flashcard [...]]]></description>
			<content:encoded><![CDATA[<p>The Quizlet API lets developers interested in building a flashcard application use Quizlet&#8217;s vast content database of about 30 million flashcards. As the #1 flashcard library on the Internet, Quizlet has more flashcards in more subjects than anyone else, all easily searchable and downloadable. The Quizlet API lets you search for and download Quizlet flashcard sets for use in your own application. Check out what the API can do by going to the <a href="/faqs/sets-api-developer-documentation/">Flashcards API developer documentation</a>.</p>
<p>Things you might build with the Quizlet API:</p>
<ol>
<li>Mobile applications (iPhone, Android, WebOS, Blackberry, etc.)</li>
<li>Desktop applications (plug Quizlet into your desktop application)</li>
<li>A screensaver</li>
<li>A learning game</li>
<li>A mashup with other datatypes (Youtube videos, Flickr images, etc)</li>
<li>Your own crazy idea!</li>
</ol>
<p>The Quizlet API is free to developers, and requires a free developer key to use. Use of the API requires your consent to our <a href="http://quizlet.com/faqs/api-terms-of-service/">API terms of service</a> and <a href="http://quizlet.com/faqs/api-branding-and-attribution/">Branding and Attribution guidelines</a>.</p>
<p>To obtain a developer key,</p>
<ol>
<li><a href="/sign_up/">Register for a regular Quizlet account</a></li>
<li><a href="/api_dashboard/">Sign up for a developer key</a></li>
</ol>
<p>Already have a key? Make sure you&#8217;re logged in, then access your <a href="/api_dashboard/">API dashboard</a>.</p>
<p>We can&#8217;t wait to see what you build!</p>
]]></content:encoded>
			<wfw:commentRss>http://quizlet.com/blog/archives/403/feed</wfw:commentRss>
		<slash:comments>6</slash:comments>
		</item>
		<item>
		<title>FAQ: API Terms of Service</title>
		<link>http://quizlet.com/blog/archives/397</link>
		<comments>http://quizlet.com/blog/archives/397#comments</comments>
		<pubDate>Mon, 29 Jun 2009 19:44:32 +0000</pubDate>
		<dc:creator>Andrew</dc:creator>
				<category><![CDATA[The Quizlet API]]></category>

		<guid isPermaLink="false">http://quizlet.com/blog/?p=397</guid>
		<description><![CDATA[Last modified June 30, 2009
The following Terms of Service (ToS) for the Quizlet API is subject to change at any time and for any reason, without notice, and we expect it to evolve as the API evolves. If you&#8217;re going to invest time in using this API we strongly recommend you read it and keep [...]]]></description>
			<content:encoded><![CDATA[<p><em>Last modified June 30, 2009</em></p>
<p>The following Terms of Service (ToS) for the Quizlet API is subject to change at any time and for any reason, without notice, and we expect it to evolve as the API evolves. If you&#8217;re going to invest time in using this API we strongly recommend you read it and keep current with any changes. If you disagree with any of the terms of this agreement, we do not grant you a license to use the Quizlet API.</p>
<h3>API USE</h3>
<p><strong>Compliance with Terms. </strong>You may use the Quizlet API, and the data, content, and information made available through the Quizlet API (&#8221;API Data&#8221;), in connection with a website or software application developed by You only in accordance with the terms and conditions of this Agreement, the <a href="http://quizlet.com/tos/">Quizlet Terms of Service</a>, the <a href="http://quizlet.com/faqs/sets-api-developer-documentation/">Quizlet API documentation and specifications</a> and the developer credentials assigned to you by Quizlet. Quizlet may monitor Your use of the Quizlet API to ensure quality, improve Quizlet products and services, and verify Your compliance with these terms. You shall not interfere with such monitoring or otherwise obscure from Quizlet Your use of the Quizlet API.</p>
<p><strong>Attribution and Branding. </strong>Your Application shall provide proper attribution to Quizlet as specified in the <a href="/faqs/api-branding-and-attribution/">Quizlet API Brand Guidelines</a>, which may be modified by Quizlet at any time. Quizlet grants You a non-exclusive license to use the Quizlet Brand assets solely in connection with their display on or through the API implementation as delivered by Quizlet. Quizlet may terminate Your license to use the Quizlet Brand at any time for any reason.</p>
<p><strong>Caching.</strong> Since Quizlet data is constantly being updated, your Quizlet API implementation may cache Quizlet data for a maximum of 48 hours, after which it must be deleted off your servers. For implementations where users may not have a constantly accessible internet connection, such as some mobile devices, you must use commercially reasonable efforts to delete cached data as soon as practicable.</p>
<p><strong>Usage and Quotas. </strong>Quizlet may, in its sole discretion, set a quota of operations on Your Quizlet API usage. You shall not attempt to circumvent automated use-quota restrictions. Quizlet is committed to open access to our API for commercial and non-commercial purposes. However, providing the API does have real costs for Quizlet. For uses of Quizlet API over a certain rate or for certain types of commercial applications, Quizlet reserves the right to charge fees for future use of or access to the Quizlet API.</p>
<h3>PROHIBITIONS</h3>
<p>Your Quizlet API implementation will not, and You will not encourage or create functionality for Your users or other third parties to:</p>
<ol>
<li>interfere or attempt to interfere in any manner with the proper workings of the Quizlet API, or create or distribute any API implementation that adversely affects the functionality or performance of Quizlet or services provided by Quizlet;</li>
<li>sell, lease, lend, convey, redistribute, or sublicense to any third party all or any portion of the Quizlet API or Quizlet API Data;</li>
<li>modify or replace the text, images, or other content of the Quizlet API data;</li>
<li>use the Quizlet API intentionally to encourage or promote copyright infringement or the exploitation of copyright-infringing materials;</li>
<li>misrepresent your identity when registering for use of the Quizlet API, use the developer credentials licensed to a different individual or entity, create multiple developer accounts, or mask Your usage of the Quizlet API;</li>
<li>build an implementation which solely showcases the content of a single Quizlet user, if You are not that user.</li>
</ol>
<h3>ADDITIONAL LEGAL PROVISIONS</h3>
<ol>
<li><strong>Compliance with Laws.</strong> You are responsible for complying with all applicable laws, rules and regulations, all third-party rights and all Quizlet policies. You shall not use the Quizlet API in a manner that violates such laws, rules and regulations, third parties&#8217; rights or any Quizlet policies or in a manner that is deceptive, unethical, false or misleading.</li>
<li><strong>No Implied Rights.</strong> Except as expressly granted herein, neither party through this Agreement grants the other party any intellectual property rights or other propriety rights. Quizlet retains all intellectual property rights (including all patent, trademark, copyright, trade secret, and other proprietary rights) in and to the Quizlet data and intellectual property. All license rights granted herein are not sublicensable, transferable or assignable.</li>
<li><strong>Non-exclusive.</strong> This Agreement is a non-exclusive agreement. You acknowledge that Quizlet may be developing and may develop products or services that may compete with your (or any other) Quizlet API implementation.</li>
<li><strong>Publicity.</strong> You agree that Quizlet may use Your company, organization, or product name and/or logo in presentations, marketing materials, website listings, and other marketing-related activities. You may not issue any public announcement regarding Your use of the Quizlet API without Quizlet&#8217;s prior review and approval.</li>
<li><strong>Confidentiality. </strong>You shall not disclose Your developer credentials to any third party except Your agent(s) using such information solely on Your behalf in accordance with this Agreement. You shall not disclose Quizlet Confidential Information to any third party without Quizlet&#8217;s prior written consent.</li>
<li><strong>Indemnification.</strong> You shall indemnify, defend and hold Quizlet, its agents, affiliates, and licensors harmless from any claim, costs, losses, damages, liabilities, judgments and expenses (including reasonable fees of attorneys and other professionals), arising out of or in connection with any claim, action or proceeding (any and all of which are &#8220;Claims&#8221;) by a third party arising out of Your use of the Quizlet API in any manner that breaches this Agreement or otherwise arising out of materials or technology contributed by You and not by Quizlet.</li>
<li><strong>Termination.</strong> Any licenses contained in this Agreement will terminate automatically without notice if You fail to comply with any provision of this Agreement. Quizlet reserves the right to terminate this Agreement or discontinue your use of the Quizlet API or any portion or feature thereof for any or no reason and at any time. Upon any termination or notice of any discontinuance, You shall immediately stop and thereafter desist from using the Quizlet API and delete all API Data in Your possession or control (including, without limitation, from Your servers).</li>
<li><strong>Modification.</strong> Quizlet may modify any of the terms and conditions contained in this Agreement at any time and in its sole discretion by posting a change notice to Your account, changing these terms and conditions, emailing to the email address of Your account or account associated with Your developer credentials or otherwise notifying You. IF ANY MODIFICATION IS UNACCEPTABLE TO YOU, YOUR ONLY RECOURSE IS TO TERMINATE THIS AGREEMENT. YOUR CONTINUED USE OF THE QUIZLET API, CONTINUED POSSESSION OF A COPY OF NON-PUBLIC QUIZLET API DOCUMENTATION AND SPECIFICATIONS OR CONTINUED DEVELOPMENT FOLLOWING POSTING OF A CHANGE NOTICE OR NEW AGREEMENT ON OUR SITE WILL CONSTITUTE BINDING ACCEPTANCE OF THE CHANGE.</li>
<li><strong>Disclaimer and Limitation of Liability.</strong> QUIZLET DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING, WITHOUT LIMITATION, FOR NONINFRINGEMENT, MERCHANTABILITY AND FITNESS FOR ANY PURPOSE. QUIZLET SHALL HAVE NO DIRECT, CONSEQUENTIAL, SPECIAL, INDIRECT, EXEMPLARY, PUNITIVE, OR OTHER LIABILITY WHETHER IN CONTRACT, TORT OR ANY OTHER LEGAL THEORY, UNDER THIS AGREEMENT, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH LIABILITY AND NOTWITHSTANDING ANY FAILURE OF ESSENTIAL PURPOSE OF ANY LIMITED REMEDY. IN THE EVENT THAT THE FOREGOING IS NOT ENFORCEABLE, QUIZLET&#8217;S AGGREGATE LIABILITY UNDER THIS AGREEMENT IS LIMITED TO FIVE HUNDRED DOLLARS ($500.00).</li>
<li><strong>Release.</strong> You hereby release and covenant not to sue Quizlet and its corporate affiliates and any of their officers, directors, employees, agents, shareholders, licensors, licensees, assigns or successors, for any and all damages, liabilities, causes of action, judgments, and claims (a) pertaining to any intellectual property You develop that is based on, uses, or relates to the Quizlet API; and (b) which otherwise may arise in connection with Your use of, reliance on, or reference to the Quizlet API. If You have a dispute with one or more Quizlet account owners, You release Quizlet and its corporate affiliates and any of their officers, directors, employees, agents, shareholders, licensors, licensees, assigns or successors, for any and all damages, liabilities, causes of action, judgments, and claims arising out of or in any way connected with such disputes. If You are a California resident, You waive California Civil Code 1542 which says: &#8220;A general release does not extend to claims which the creditor does not know or suspect to exist in his favor at the time of executing the release, which if known by him must have materially affected his settlement with the debtor.&#8221;</li>
</ol>
]]></content:encoded>
			<wfw:commentRss>http://quizlet.com/blog/archives/397/feed</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>FAQ: API Branding and Attribution</title>
		<link>http://quizlet.com/blog/archives/378</link>
		<comments>http://quizlet.com/blog/archives/378#comments</comments>
		<pubDate>Mon, 29 Jun 2009 19:41:57 +0000</pubDate>
		<dc:creator>Andrew</dc:creator>
				<category><![CDATA[FAQs]]></category>
		<category><![CDATA[The Quizlet API]]></category>

		<guid isPermaLink="false">http://quizlet.com/blog/?p=378</guid>
		<description><![CDATA[Attribution
Use of the Quizlet API requires the use of Quizlet branding. You must use one of the methods below when displaying Quizlet content.




Powered by Quizlet.com
Powered by Quizlet.com
Attribution Rules

Quizlet API users may only use the Quizlet badges above. When Quizlet content is embedded in a web browser, the badge must link to http://quizlet.com/. It may be [...]]]></description>
			<content:encoded><![CDATA[<h3>Attribution</h3>
<p>Use of the Quizlet API requires the use of Quizlet branding. You must use one of the methods below when displaying Quizlet content.</p>
<p><img src='http://a.quizlet.com/i/powered/uses_quizlet_white.png' /></p>
<p><textarea cols='40' rows='3' readonly='readonly'><a href="http://quizlet.com/"><img src='http://a.quizlet.com/i/powered/uses_quizlet_white.png' alt='This uses the Quizlet.com flash cards' /></a></textarea></p>
<p><img src='http://a.quizlet.com/i/powered/uses_quizlet_blue.png' /></p>
<p><textarea cols='40' rows='3' readonly='readonly'><a href="http://quizlet.com/"><img src='http://a.quizlet.com/i/powered/uses_quizlet_blue.png' alt='This uses the Quizlet.com flash cards' /></a></textarea></p>
<p><a href="http://quizlet.com/"><b>Powered by Quizlet.com</b></a></p>
<p><textarea cols='40' rows='3' readonly='readonly'><a href="http://quizlet.com/"><b>Powered by Quizlet.com</b></a></textarea></p>
<h4>Attribution Rules</h4>
<ol class='small_text'>
<li>Quizlet API users may only use the Quizlet badges above. When Quizlet content is embedded in a web browser, the badge must link to http://quizlet.com/. It may be left unlinked in non-web applications.</li>
<li>Do not change the mark in any way. Do not remove, obstruct, distort, or alter any element of a Quizlet trademark. This includes modifying the Quizlet wordmark.</li>
<li>Make sure the Quizlet badge is full and clearly visible, never altered or partially covered.</li>
<li>Don&#8217;t display the Quizlet badge as the most prominent element on your web page.</li>
<li>Do not use the Quizlet badge in ways that (1) imply an association with or endorsement of any other product, service, event, sponsorship, or organization; (2) can be reasonably interpreted to suggest editorial content was authored by Quizlet; or (3) represent the views or opinions of Quizlet or Quizlet personnel without prior written permission from Quizlet. All of the aforementioned usages must be approved via written permission.</li>
<li>Do not adopt marks, logos, slogans, or designs that are confusingly similar to the Quizlet trademarks or imitate Quizlet&#8217;s trade dress, including the look and feel of Quizlet web design properties, Quizlet brand packaging, distinctive color combinations, typography, graphic designs, product icons, or imagery associated with Quizlet.</li>
<li>Do not register the Quizlet trademarks as second-level domain names or incorporate Quizlet trademarks into your own product name, service names, trademarks, logos, or company names.</li>
<li>Never display a Quizlet trademark in a manner that is misleading, unfair, defamatory, infringing, libelous, disparaging, obscene or otherwise objectionable to Quizlet.</li>
<li>Never display a Quizlet trademark on any web site or user interface that contains or displays adult content, promotes gambling, promotes violence, contains hate speech, involves the sale of tobacco or alcohol to persons under twenty-one years of age, violates other applicable laws or regulations or is otherwise objectionable.</li>
</ol>
]]></content:encoded>
			<wfw:commentRss>http://quizlet.com/blog/archives/378/feed</wfw:commentRss>
		<slash:comments>2</slash:comments>
		</item>
		<item>
		<title>FAQ: Flashcard API Developer Documentation</title>
		<link>http://quizlet.com/blog/archives/318</link>
		<comments>http://quizlet.com/blog/archives/318#comments</comments>
		<pubDate>Tue, 16 Jun 2009 21:31:41 +0000</pubDate>
		<dc:creator>Andrew</dc:creator>
				<category><![CDATA[FAQs]]></category>
		<category><![CDATA[The Quizlet API]]></category>

		<guid isPermaLink="false">http://quizlet.com/blog/?p=318</guid>
		<description><![CDATA[Using this simple JSON API, you can find and download flashcard sets on Quizlet. For now, this API only returns publicly available sets, and cannot incorporate user credentials to view privately created sets. Results are regular JSON encoded UTF-8 strings, so pass\u00e9 represents passé. All the data you need (including terms inside a set via [...]]]></description>
			<content:encoded><![CDATA[<p>Using this simple JSON API, you can find and download flashcard sets on Quizlet. For now, this API only returns <strong>publicly available</strong> sets, and cannot incorporate user credentials to view privately created sets. Results are regular JSON encoded UTF-8 strings, so <code>pass\u00e9</code> represents <code>passé</code>. All the data you need (including terms inside a set via the <code>extended=on</code> parameter) is available via this API.</p>
<p>Remember, to use this API, you must agree to <a href="http://quizlet.com/faqs/api-terms-of-service/">API terms of service</a> and the <a href="/faqs/api-branding-and-attribution/">API Branding Guidelines</a>.</p>
<p>The <a href="/api_dashboard/">API developer dashboard</a> lets you obtain a developer key or see usage statistics for your application. You must be a registered Quizlet user to access this page.</p>
<p>This page documents version 1.0 of the Quizlet API.</p>
<p>The base URL for Quizlet&#8217;s Set API is<br />
<b style='font: bold 16px courier;'>http://quizlet.com/api/1.0/sets</b> </p>
<p>&nbsp;</p>
<h3>Request Parameters</h3>
<table class='allsets table api_table'>
<tr>
<th>Parameter</th>
<th>Type / Options</th>
<th>Description</th>
<th>Default</th>
</tr>
<tr>
<td>dev_key</td>
<td><code>string</code></td>
<td><strong>required</strong> The developer key you <a href="/api_dashboard/">acquired here</a>.</td>
<td><em>None</em></td>
</tr>
<tr>
<td>q</td>
<td><code>string</code></td>
<td><strong>required</strong> Defines the query used to search the Quizlet database. Any public set with a matching title or subjects will be returned. This search is case-insensitive.</p>
<p>		You can use special prefixes to return sets that match things other than the title or subjects.</p>
<ul>
<li>&#8220;<b>term:</b>&#8221; gets all sets that have a term inside them that equals the query. For example, use &#8220;term:California&#8221; to get all sets that define California. Additionally, you can find sets that specify a term/definition pair (such as California and Sacramento). Use the query &#8220;term:california=sacramento&#8221; to find those sets.</li>
<li>&#8220;<b>creator:</b>&#8221; The Quizlet username of a user. Use a query like &#8220;creator:jalenack&#8221; to return jalenack&#8217;s public sets.</li>
<li>&#8220;<b>ids:</b>&#8221; A comma-separated list of set ID numbers (one or more). You might know set id numbers from previous searches or from the regular website, where an id can be pulled out of a set url: <code>http://quizlet.com/415/ us-capitals-flash-cards</code>.</li>
</ul>
<p>		You can combine prefixes and keyword searches, much the way you might query for &#8220;capitals site:quizlet.com&#8221; on Google. So to search for a set with &#8220;capitals&#8221; in its title which contains a &#8220;California&#8221; term and that was created by &#8220;jalenack&#8221;, you can use &#8220;capitals creator:jalenack term:california&#8221;; Multiple search types are considered an &#8220;AND&#8221; operation, meaning a result must match all conditions. Also, because the &#8220;term&#8221; prefix can include any characters, you should put it last.
		</td>
<td><em>None</em></td>
</tr>
<tr>
<td>callback</td>
<td><code>string</code></td>
<td><strong>optional</strong> A javascript function name for use inside a web application, using the JSON-P method. <code>callback=foo</code> will wrap the response in the foo function: <code>foo({...data...})</code></td>
<td><em>None</em></td>
</tr>
<tr>
<td>sort</td>
<td><span class='correct'>&#8220;most_studied&#8221;, &#8220;alphabetical&#8221;, &#8220;most_recent&#8221;</span></td>
<td><strong>optional</strong> Determines how to sort the results.</td>
<td><em>&#8220;most_studied&#8221;</em></td>
</tr>
<tr>
<td>whitespace</td>
<td><span class='correct'>&#8220;on&#8221;, &#8220;off&#8221;</span></td>
<td><strong>optional</strong> Add this parameter (<code>&amp;whitespace=on</code>) to properly indent and space the results for easier human reading of the raw results. This can make testing/debugging easier, and has no effect on the results. Without this parameter, Quizlet will minimize whitespace and network traffic.</td>
<td><em>&#8220;off&#8221;</em></td>
</tr>
<tr>
<td>page</td>
<td><code>integer</code></td>
<td><strong>optional</strong> The page offset. By default, search returns the first page of results, but you can get any page up to the maximum <code>total_pages</code> returned in any result set.</td>
<td><em>1 (one)</em></td>
</tr>
<tr>
<td>per_page</td>
<td><code>integer</code></td>
<td><strong>optional</strong> The number of results to show per page. Minimum: 1 / Maximum: 50.</td>
<td><em>30</em></td>
</tr>
<tr>
<td>time_format</td>
<td><span class='correct'>&#8220;unix&#8221;, &#8220;fuzzy_date&#8221;</span></td>
<td><strong>optional</strong> Determines the formatting of timestamp types (currently only <code>created</code>). The default is a unix timestamp for maximum flexibility. Use &#8220;fuzzy_date&#8221; to display a human-friendly date that switches to &#8220;ago&#8221; (such as &#8220;3 days ago&#8221;) time if it&#8217;s recent or regular dates if it&#8217;s not.</td>
<td><em>&#8220;unix&#8221;</em></td>
</tr>
<tr>
<td>extended</td>
<td><span class='correct'>&#8220;on&#8221;, &#8220;off&#8221;</span></td>
<td><strong>optional</strong> Adds the set description (<code>description</code>) and all the set&#8217;s terms (<code>terms</code>) to the set data displayed. You might do an initial search without <code>extended=on</code>, then use the <code>ids:</code> query prefix (on the <code>q</code> parameter) in a separate request to only get extended data on certain ids.</td>
<td><em>&#8220;off&#8221;</em></td>
</tr>
</table>
<h3>Response Data</h3>
<p>When you call the Quizlet Sets API, you will always receive a JSON object. This object will always contain a <code>response_type</code> which tells you if your query executed successfully. Its value can be either &#8220;ok&#8221; or &#8220;error&#8221;:</p>
<h4>error</h4>
<table class='allsets table api_table'>
<tr>
<th>Key</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td>response_type</td>
<td><span class='correct'>&#8220;error&#8221;</span></td>
<td>If you get an &#8220;error&#8221; <code>response_type</code>, the query you specified could not be processed.</td>
</tr>
<tr>
<td>short_text</td>
<td>string
		</td>
<td>A short error message. This is the title of the message.</td>
</tr>
<tr>
<td>response_type</td>
<td>string
		</td>
<td>A more descriptive error message, usually one or two sentences.</td>
</tr>
</table>
<h4>ok</h4>
<table class='allsets table api_table'>
<tr>
<th>Key</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td>response_type</td>
<td><span class='correct'>&#8220;ok&#8221;</span></td>
<td>An &#8220;ok&#8221; response means there is useful data in the response. Yay!</td>
</tr>
<tr>
<td>total_results</td>
<td><code>integer</code></td>
<td>The number of sets matching your search.</td>
</tr>
<tr>
<td>page</td>
<td><code>integer</code></td>
<td>Shows which page of results you are viewing. 30 results are shown per page by default (adjust the <code>per_page</code> parameter to change that).</td>
</tr>
<tr>
<td>total_pages</td>
<td><code>integer</code></td>
<td>The total number of pages this result can display.</td>
</tr>
<tr>
<td>total_pages</td>
<td><code>integer</code></td>
<td>The number of pages this result has.</td>
</tr>
<tr>
<td>sets</td>
<td><code>array</code></td>
<td>An array of Set objects, as described below.</td>
</tr>
</table>
<h4>Set objects</h4>
</p>
<p>A user creates a set to study a specific set of terms. A set is like a deck of flashcards. For example, a set titled &#8220;U.S. State Capitals&#8221; might have 50 terms, one for each state/capital pair. Use the <code>extended=on</code> parameter to download the full data of individual sets.</p>
<table class='allsets table api_table'>
<tr>
<th>Key</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td>id</td>
<td><code>integer</code></td>
<td>Quizlet&#8217;s universal ID for a set.</td>
</tr>
<tr>
<td>title</td>
<td><code>string</code>
		</td>
<td>The title of the set, as supplied by the set&#8217;s creator. Be careful, this value is <b>not&nbsp;html&nbsp;escaped</b>.</td>
</tr>
<tr>
<td>url</td>
<td><code>string</code>
		</td>
<td>The public URL of the Quizlet set. If the set&#8217;s title changes, the URL will change, but old URLs will properly make 301 Redirects. This string cannot contain HTML.</td>
</tr>
<tr>
<td>creator</td>
<td><code>string</code>
		</td>
<td>The username of the person who created this set. Usernames are currently limited at 25 characters and cannot contain HTML. You can make a link to the user&#8217;s account by inserting their username link this: <code>http://quizlet.com/user/**username here**/</code></td>
</tr>
<tr>
<td>created</td>
<td><code>timestamp</code>
		</td>
<td>The time at which the set was created. By default, it is an integer unix timestamp. Use the <code>time_format</code> parameter to change how this value displays.</td>
</tr>
<tr>
<td>term_count</td>
<td><code>integer</code>
		</td>
<td>The number of term/definition pairs in the set.</td>
</tr>
<tr>
<td>description</td>
<td><code>string</code>
		</td>
<td><strong>extended=on required</strong> The description of the set, as supplied by the set&#8217;s creator. Be careful, this value is <b>not&nbsp;html&nbsp;escaped</b>.</td>
</tr>
<tr>
<td>terms</td>
<td><code>array</code>
		</td>
<td><strong>extended=on required</strong> All the term/definition pairs for the set. The first item of each array is the term, and the second is the definition (i.e. <code>["term123","definition123"]</code>). Be careful, these values are <b>not&nbsp;html&nbsp;escaped</b>.</td>
</tr>
</table>
<h3>Examples</h3>
<p>Let&#8217;s try a simple search for &#8220;geography&#8221;:</p>
<p><strong>Request</strong></p>
<pre>http://quizlet.com/api/1.0/sets?dev_key=a123&amp;q=geography</pre>
<p><strong>Response</strong></p>
<pre>{
  "response_type": "ok",
  "total_results": 861,
  "page": 1,
  "total_pages": 18,
  "data": [
    {
      "id": 415,
      "title": "U.S. State Capitals",
      "creator": "jalenack",
      "created": 1144296408,
      "term_count": 49
    },
    {
      "id": 2285,
      "title": "World Capitals",
      "creator": "tenunda",
      "created": 1170106817,
      "term_count": 193
    },
    {
      "id": 277655,
      "title": "World Geography exam review",
      "creator": "aw1231",
      "created": 1210683453,
      "term_count": 41
    }
    <b class='correct'>...more results...</b>
  ]
}
</pre>
<p>Now something a little more complex. Let&#8217;s get the most recent sets by the user &#8220;jalenack&#8221; (including terms and definitions), and wrapped with a JSON-P callback <code>processData()</code>.</p>
<p><strong>Request</strong></p>
<pre>http://quizlet.com/api/1.0/sets?dev_key=a123&amp;q=creator:jalenack&amp;extended=on&amp;sort=most_recent&amp;callback=processData</pre>
<p><strong>Response</strong></p>
<pre>processData({
  "response_type": "ok",
  "total_results": 82,
  "page": 1,
  "total_pages": 2,
  "sets": [
    {
      "id": 732159,
      "title": "Demo Set",
      "url": "http:\/\/quizlet.com\/732159\/demo-set-flash-cards\/",
      "creator": "jalenack",
      "created": 1234641691,
      "term_count": 8,
      "description": "For showing Quizlet to others",
      "terms": [
        [
          "Mountain View",
          "Where is Google located?"
        ],
        [
          "Cambridge",
          "Where is MIT located?"
        ],
        [
          "Andrew Sutherland",
          "Who founded Quizlet?"
        ],
        [
          "California",
          "What state is below Oregon?"
        ],
        [
          "Barack Obama",
          "Who is the president of the USA?"
        ],
        [
          "Four",
          "What is two plus two?"
        ],
        [
          "Ten",
          "How many fingers do you have?"
        ],
        [
          "Quizlet",
          "What is this website called?"
        ]
      ]
    },
    {
      "id": 629186,
      "title": "XKCD metric speeds",
      "url": "http:\/\/quizlet.com\/629186\/xkcd-metric-speeds-flash-cards\/",
      "creator": "jalenack",
      "created": 1231145530,
      "term_count": 11,
      "description": "Via http:\/\/xkcd.com\/526\/",
      "terms": [
        [
          "5 kph",
          "walking"
		],
		<b class='correct'>...more results...</b>
	   ]
	 }
  ]
});</pre>
]]></content:encoded>
			<wfw:commentRss>http://quizlet.com/blog/archives/318/feed</wfw:commentRss>
		<slash:comments>5</slash:comments>
		</item>
	</channel>
</rss>
