API DOCS

Simple Usage
Quotes By Tags
Quotes By Language
Ordering Quotes
Quotes By Author
Quotes By Length
Curated Quotes
Quote of the Day
GET tags of Quotes
Report a Quote
Error Codes

SIMPLE USAGE

We have a huge collection of quotes in our database. And our best Quotes API gives easy way to access the data. Note if your usage are with in free quota an attribution link back to paperquotes.com is required. If you don't want to display attribution please sign up for one of the paid plan. Here is the code you can cut and paste to provide attribution

Request
GET https://api.paperquotes.com/apiv1/quotes/?tags=love,life&curated=1
Field Type Description
tags string Comma seperated tags
curated boolean Filter by human curated quotes
Response
{
            "quote": "Your values are your life's worth.",
            "author": "Sunday Adelaja",
            "likes": 0,
            "tags": [
                "calling",
                "money",
                "passion",
                "joblessness",
                "kingdom",
                "opportunities",
                "principles",
                "serving-god",
                "love",
                "purpose",
                "jobless",
                "people",
                "values",
                "worship",
                "life",
                "employment",
                "work",
                "service",
                "time",
                "god",
                "destiny"
            ],
            "pk": 32700,
            "image": null,
            "language": "en"
        }
Field Type Description
quote String The Lovely Quote
author String Quote's Author
likes Integer Quote's popularity score
tags String Comma separated Quote tags
language String Quote's Language

Quote By Tags

You can Filter Quotes by tags or order them by most liked quotes first:

Request
GET https://api.paperquotes.com/apiv1/quotes/?tags=love,motivation&order=-likes
Field Type Description
tags string Comma seperated tags
Response
{
            "quote": "Love is the beauty of the soul. Augustine of Hippo",
            "author": "Augustine of Hippo",
            "likes": 139,
            "tags": [
                "love"
            ],
            "pk": 491516,
            "image": null,
            "language": "en"
        }
Field Type Description
quote String The Lovely Quote
author String Quote's Author
likes Integer Quote's popularity score
tags String Comma separated Quote tags
language String Quote's Language
Availble Languages
Language Code Language
en English
fr French
de German
it Italian
pt Portuguese
ru Russian
es Spanish
tr Turkish
uk Ukrainian
he Hebrew
ar Arabic
be Bengali
te Telugu

Quote By Language

PaperQuotes allows to fetch quotes in more than 15 language and it's expanding:

Request
GET https://api.paperquotes.com/apiv1/quotes/?lang=fr
Request
GET https://api.paperquotes.com/apiv1/quotes/?lang=fr
Field Type Description
lang string language code
Response
 {
            "quote": "Je n’aime pas penser trop en avance.",
            "author": "Willie Nelson",
            "likes": 100,
            "tags": [],
            "pk": 460346,
            "image": null,
            "language": "fr"
        }
Field Type Description
quote String The Lovely Quote
author String Quote's Author
likes Integer Quote's popularity score
tags String Comma separated Quote tags
language String Quote's Language

Quotes By Author

Finding Quotes based on author name:

Request
GET https://api.paperquotes.com/apiv1/quotes/?author=Mahatma%20Gandhi
Request
GET https://api.paperquotes.com/apiv1/quotes/?author=Mahatma%20Gandhi
Field Type Description
author string the quote author to search for
Response
{
            "quote": "There is no school equal to a decent home and no teacher equal to a virtuous parent.",
            "author": "Mahatma Gandhi",
            "likes": 304,
            "tags": [
                "education"
            ],
            "pk": 507247,
            "image": null,
            "language": "en"
        }
Field Type Description
quote String The Lovely Quote
author String Quote's Author
likes Integer Quote's popularity score
tags String Comma separated Quote tags
language String Quote's Language

Quotes By Length

Using maxlength and minlength parameters to find quotes with a length:

Request
GET https://api.paperquotes.com/apiv1/quotes/?maxlength=20&minlength=5
Request
GET https://api.paperquotes.com/apiv1/quotes/?maxlength=20&minlength=5
Field Type Description
maxlength Integer the maximum length for the quote
minlength Integer the minimum length for the quote
Response
Without country code
{
            "quote": "Knowledge is power.",
            "author": "Francis Bacon",
            "likes": 157,
            "tags": [
                "knowledge"
            ],
            "pk": 507874,
            "image": null,
            "language": "en"
        }
Response
Field Type Description
quote String The Lovely Quote
author String Quote's Author
likes Integer Quote's popularity score
tags String Comma separated Quote tags
language String Quote's Language

Curated Quotes

Quotes API Endpoint to find human curated quotes:

Request
GET https://api.paperquotes.com/apiv1/quotes/curated=1&language=hi
Request
Curated Hindi Quote
GET https://api.paperquotes.com/apiv1/quotes/curated=1&language=hi
Field Type Description
curated Integer returns the curated quotes only
language String the quote's language
Response
Without country code
  {
            "quote": "सिर्फ सपनों से कुछ नहीं होता, सफलता प्रयासों से हासिल होती है.",
            "author": "",
            "likes": 100,
            "tags": [
                "hindi"
            ],
            "pk": 62641,
            "image": "http://api.paperquotes.com/static/thumbs/62641.jpg",
            "language": "hi"
        }
Response
With country code
Field Type Description
quote String The Lovely Quote
author String Quote's Author
likes Integer Quote's popularity score
tags String Comma separated Quote tags
language String Quote's Language

Quote of the day

Finding the quote of the day using the paperquotes API:

Request
Quote of the day
GET https://api.paperquotes.com/apiv1/qod/
Request
GET https://api.paperquotes.com/apiv1/qod/
Request
Field Type Description
curated Integer returns the curated quotes only
language String the quote's language
Response
{
    "quote": "God helps those that help themselves. Benjamin Franklin",
    "author": null,
    "likes": 0,
    "tags": [],
    "pk": 466719,
    "image": null,
    "language": "en"
}
Response
Field Type Description
quote String The Lovely Quote
author String Quote's Author
likes Integer Quote's popularity score
tags String Comma separated Quote tags
language String Quote's Language

Find all Quote's tags

With this call you can render all the tags for quotes:

Request
GET https://api.paperquotes.com/apiv1/tags/
Response
{
    "count": 324434,
    "next": "https://api.paperquotes.com/apiv1/tags/?limit=1&offset=1",
    "previous": null,
    "results": [
        {
            "name": "love",
            "slug": "love"
        }
    ]
}
Field Type Description
count Integer Total count for avaiable tags
next String URl to next tag if paginated
previous String Url to previous tags
results Json The result with name and slug of tag

Upvote/Downvote a Quote

You can upvote or downvote a quote using following endpoints. it takes pk as POST parameter

Request
POST https://api.paperquotes.com/apiv1/upvote/
POST https://api.paperquotes.com/apiv1/downvote/

Report a Quote

PaperQuote's Machine learning models already take cares of any offensive or profanitive quotes, but users can report them to exclude them for displaying again.

Request
POST https://api.paperquotes.com/apiv1/report/

ERROR CODES

Response
Error Example Message
{"errno":429,"errmsg":"too many requests"}
errno (Error Number) errmsg (Error Message) Description
400 Bad Request Invalid request or param missing
429 too many requests ( request throttled ) You are out of your plan limits, consider upgrading your plan