{"openapi":"3.1.0","info":{"title":"Quotes API","version":"1.0.0","description":"A collection of 1,600+ famous quotes from 600+ authors. Fetch a random quote (optionally filtered by author), look one up by id, search the full collection by text or author, and browse the author directory. Perfect for daily-quote widgets, dashboards, apps and inspiration features.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/quotes-api","description":"oanor gateway"}],"tags":[{"name":"Quotes"},{"name":"Authors"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/quote":{"get":{"operationId":"get_v1_quote","tags":["Quotes"],"summary":"A single quote by id","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Quote id","schema":{"type":"string"},"example":"0"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":0,"text":"Genius is one percent inspiration and ninety-nine percent perspiration.","author":"Thomas Edison"},"meta":{"timestamp":"2026-05-31T01:46:11.771Z","request_id":"4fb4a74f-c4dc-46ad-a600-d4bdd0436755"},"status":"ok","message":"Quote retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/random":{"get":{"operationId":"get_v1_random","tags":["Quotes"],"summary":"A random quote (optionally by author)","description":"","parameters":[{"name":"author","in":"query","required":false,"description":"Filter by author name","schema":{"type":"string"}},{"name":"count","in":"query","required":false,"description":"Number of quotes (1-20, default 1)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":1463,"text":"The mark of your ignorance is the depth of your belief in injustice and tragedy. What the caterpillar calls the end of the world, the Master calls the butterfly.","author":"Richard Bach"},"meta":{"timestamp":"2026-05-31T01:46:11.849Z","request_id":"1d585001-f8e6-411d-b893-434df085df80"},"status":"ok","message":"Quote retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Quotes"],"summary":"Search quotes by text and author","description":"","parameters":[{"name":"q","in":"query","required":false,"description":"Text to search","schema":{"type":"string"},"example":"success"},{"name":"author","in":"query","required":false,"description":"Author name (substring)","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Results per page (1-100, default 20)","schema":{"type":"string"},"example":"20"},{"name":"offset","in":"query","required":false,"description":"Pagination offset","schema":{"type":"string"},"example":"0"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":20,"limit":20,"total":55,"offset":0,"filters":{"q":"success"},"results":[{"id":35,"text":"One fails forward toward success.","author":"Charles Kettering"},{"id":64,"text":"When performance exceeds ambition, the overlap is called success.","author":"Cullen Hightower"},{"id":213,"text":"The path to success is to take massive, determined action.","author":"Tony Robbins"},{"id":258,"text":"The secret of success is constancy to purpose.","author":"Benjamin Disraeli"},{"id":295,"text":"Successful people ask better questions, and as a result, they get better answers.","author":"Tony Robbins"},{"id":316,"text":"Through perseverance many people win success out of what seemed destined to be certain failure.","author":"Benjamin Disraeli"},{"id":332,"text":"Most great people have attained their greatest success just one step beyond their greatest failure.","author":"Napoleon Hill"},{"id":394,"text":"It is on our failures that we base a new and different and better success.","author":"Havelock Ellis"},{"id":397,"text":"Life is a succession of lessons, which must be lived to be understood.","author":"Ralph Emerson"},{"id":413,"text":"A little more persistence, a little more effort, and what seemed hopeless failure may turn to glorious success.","author":"Elbert Hubbard"},{"id":419,"text":"Success means having the courage, the determination, and the will to become the person you believe you were meant to be.","author":"George Sheehan"},{"id":431,"text":"Good people are good because they've come to wisdom through failure. We get very little wisdom from success, you know.","author":"William Saroyan"},{"id":448,"text":"There is only one success � to be able to spend your life in your own way.","author":"Christopher Morley"},{"id":453,"text":"Everyone can taste success when the going is easy, but few know how to taste victory when times get tough.","author":"Byron Pulsifer"},{"id":463,"text":"Of course there is no formula for success except perhaps an unconditional acceptance of life and what it brings.","author":"Arthur Rubinstein"},{"id":519,"text":"Always be yourself, express yourself, have faith in yourself, do not go out and look for a successful personality and duplicate it.","author":"Bruce Lee"},{"id":573,"text":"One secret of success in life is for a man to be ready for his opportunity when it comes.","author":"Benjamin Disraeli"},{"id":593,"text":"Many of life's failures are people who did not realize how close they were to success when they gave up.","author":"Thomas Edison"},{"id":608,"text":"I can't imagine a person becoming a success who doesn't give this game of life everything hes got.","author":"Walter Cronkite"},{"id":645,"text":"The first requisite for success is the ability to apply your physical and mental energies to one problem incessantly without growing weary.","author":"Thomas Edison"}]},"meta":{"timestamp":"2026-05-31T01:46:11.919Z","request_id":"328152bd-9c26-43b0-ae14-118cf4781bcf"},"status":"ok","message":"Search completed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/authors":{"get":{"operationId":"get_v1_authors","tags":["Authors"],"summary":"Author directory with quote counts","description":"","parameters":[{"name":"q","in":"query","required":false,"description":"Filter authors by name","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max authors (1-500, default 50)","schema":{"type":"string"},"example":"50"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":50,"total":675,"authors":[{"author":"Buddha","quotes":56},{"author":"Byron Pulsifer","quotes":41},{"author":"Confucius","quotes":37},{"author":"Ralph Emerson","quotes":36},{"author":"Lao Tzu","quotes":35},{"author":"Richard Bach","quotes":32},{"author":"Albert Einstein","quotes":27},{"author":"Wayne Dyer","quotes":25},{"author":"Napoleon Hill","quotes":25},{"author":"Dalai Lama","quotes":23},{"author":"Epictetus","quotes":21},{"author":"Abraham Lincoln","quotes":17},{"author":"Johann Wolfgang von Goethe","quotes":16},{"author":"Marcus Aurelius","quotes":16},{"author":"Carl Jung","quotes":14},{"author":"Tony Robbins","quotes":14},{"author":"Bruce Lee","quotes":14},{"author":"William Shakespeare","quotes":13},{"author":"Aristotle","quotes":12},{"author":"Winston Churchill","quotes":12},{"author":"Benjamin Disraeli","quotes":11},{"author":"Seneca","quotes":10},{"author":"Thich Nhat Hanh","quotes":10},{"author":"Mark Twain","quotes":10},{"author":"Mother Teresa","quotes":10},{"author":"Eleanor Roosevelt","quotes":9},{"author":"Helen Keller","quotes":9},{"author":"Oprah Winfrey","quotes":9},{"author":"Chinese proverb","quotes":8},{"author":"Leonardo da Vinci","quotes":8},{"author":"John Lennon","quotes":8},{"author":"Maya Angelou","quotes":8},{"author":"Napoleon Bonaparte","quotes":8},{"author":"Albert Schweitzer","quotes":8},{"author":"Pablo Picasso","quotes":8},{"author":"Blaise Pascal","quotes":8},{"author":"Pema Chodron","quotes":8},{"author":"Sophocles","quotes":7},{"author":"Anais Nin","quotes":7},{"author":"Ralph Waldo Emerson","quotes":7},{"author":"Publilius Syrus","quotes":6},{"author":"Donald Trump","quotes":6},{"author":"Pearl Buck","quotes":6},{"author":"Oscar Wilde","quotes":6},{"author":"Voltaire","quotes":6},{"author":"Elbert Hubbard","quotes":6},{"author":"Og Mandino","quotes":6},{"author":"Eckhart Tolle","quotes":6},{"author":"Denis Waitley","quotes":6},{"author":"Daisaku Ikeda","quotes":6}]},"meta":{"timestamp":"2026-05-31T01:46:11.995Z","request_id":"43fc6a4a-daf2-4763-9a3d-8cf1de110923"},"status":"ok","message":"Authors retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Totals & source","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"total":1638,"fields":["id","text","author"],"source":"Curated public-domain quotes collection","authors":675},"meta":{"timestamp":"2026-05-31T01:46:12.044Z","request_id":"c35cf5cb-e8d7-47cd-8104-30f6da2fc586"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":2000,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":400,"monthly_call_quota":40000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1100,"monthly_call_quota":200000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3000,"monthly_call_quota":1000000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/quotes-api"}