{"openapi":"3.1.0","info":{"title":"Apizie: education","version":"2.0.0","description":"One API key, one envelope, many public data sources."},"servers":[{"url":"https://apizie.tech"}],"security":[{"ApiKeyAuth":[]}],"paths":{"/v1/education:open-library/search":{"get":{"operationId":"education_open_library_search","summary":"Search books","description":"Search by title, author or anything.","tags":["education"],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"},"example":"dune frank herbert"},{"name":"limit","in":"query","required":false,"description":"Number of results","schema":{"type":"integer","default":10,"minimum":1,"maximum":100,"description":"Number of results"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"minimum":1}},{"name":"fields","in":"query","required":false,"schema":{"type":"string","default":"key,title,author_name,first_publish_year,isbn,cover_i,edition_count"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":3600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/education:open-library/isbn":{"get":{"operationId":"education_open_library_isbn","summary":"By ISBN","description":"Edition for an ISBN-10 or ISBN-13.","tags":["education"],"parameters":[{"name":"isbn","in":"query","required":true,"schema":{"type":"string"},"example":"9780441172719"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/education:open-library/work":{"get":{"operationId":"education_open_library_work","summary":"Work","description":"A work (all editions) by id.","tags":["education"],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"},"example":"OL893415W"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/education:open-library/authors":{"get":{"operationId":"education_open_library_authors","summary":"Search authors","description":"Authors by name.","tags":["education"],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"},"example":"ursula le guin"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/education:gutendex/search":{"get":{"operationId":"education_gutendex_search","summary":"Search books","description":"Search titles and authors.","tags":["education"],"parameters":[{"name":"query","in":"query","required":false,"schema":{"type":"string"},"example":"sherlock holmes"},{"name":"languages","in":"query","required":false,"schema":{"type":"string"},"example":"en,fr"},{"name":"topic","in":"query","required":false,"schema":{"type":"string"},"example":"children"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"minimum":1}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/education:gutendex/book":{"get":{"operationId":"education_gutendex_book","summary":"Book","description":"One book by Gutenberg id.","tags":["education"],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"integer"},"example":1342}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/education:universities/search":{"get":{"operationId":"education_universities_search","summary":"Search","description":"By name and/or country.","tags":["education"],"parameters":[{"name":"name","in":"query","required":false,"schema":{"type":"string"},"example":"technology"},{"name":"country","in":"query","required":false,"schema":{"type":"string"},"example":"Germany"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/education:datamuse/words":{"get":{"operationId":"education_datamuse_words","summary":"Find words","description":"Combine constraints such as meaning, sound and spelling.","tags":["education"],"parameters":[{"name":"meansLike","in":"query","required":false,"schema":{"type":"string"},"example":"ringing in the ears"},{"name":"soundsLike","in":"query","required":false,"schema":{"type":"string"}},{"name":"spelledLike","in":"query","required":false,"schema":{"type":"string"},"example":"t??k"},{"name":"rhymesWith","in":"query","required":false,"schema":{"type":"string"}},{"name":"topics","in":"query","required":false,"schema":{"type":"string"}},{"name":"max","in":"query","required":false,"description":"Number of results","schema":{"type":"integer","default":20,"minimum":1,"maximum":1000,"description":"Number of results"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/education:datamuse/suggest":{"get":{"operationId":"education_datamuse_suggest","summary":"Autocomplete","description":"Word suggestions for a prefix.","tags":["education"],"parameters":[{"name":"prefix","in":"query","required":true,"schema":{"type":"string"},"example":"rawr"},{"name":"max","in":"query","required":false,"description":"Number of results","schema":{"type":"integer","default":10,"minimum":1,"maximum":1000,"description":"Number of results"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/education:free-dictionary/define":{"get":{"operationId":"education_free_dictionary_define","summary":"Define","description":"Entries for a word.","tags":["education"],"parameters":[{"name":"word","in":"query","required":true,"schema":{"type":"string"},"example":"serendipity"},{"name":"lang","in":"query","required":false,"schema":{"type":"string","default":"en"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":604800,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/education:bible-api/passage":{"get":{"operationId":"education_bible_api_passage","summary":"Passage","description":"A verse or range, e.g. John 3:16 or Romans 12:1-2.","tags":["education"],"parameters":[{"name":"reference","in":"query","required":true,"schema":{"type":"string"},"example":"John 3:16"},{"name":"translation","in":"query","required":false,"schema":{"type":"string","enum":["web","kjv","bbe","asv","ylt","almeida","rccv"],"default":"web"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":604800,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/education:poetrydb/by-author":{"get":{"operationId":"education_poetrydb_by_author","summary":"By author","description":"Poems by an author.","tags":["education"],"parameters":[{"name":"author","in":"query","required":true,"schema":{"type":"string"},"example":"Emily Dickinson"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":604800,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/education:poetrydb/by-title":{"get":{"operationId":"education_poetrydb_by_title","summary":"By title","description":"Poems with a title.","tags":["education"],"parameters":[{"name":"title","in":"query","required":true,"schema":{"type":"string"},"example":"Ozymandias"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":604800,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/education:poetrydb/random":{"get":{"operationId":"education_poetrydb_random","summary":"Random","description":"Random poems.","tags":["education"],"parameters":[{"name":"count","in":"query","required":false,"schema":{"type":"integer","default":1,"minimum":1,"maximum":20}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":0,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/education:quran-cloud/surah":{"get":{"operationId":"education_quran_cloud_surah","summary":"Surah","description":"A surah in one edition.","tags":["education"],"parameters":[{"name":"surah","in":"query","required":true,"schema":{"type":"integer"},"example":1},{"name":"edition","in":"query","required":false,"schema":{"type":"string","default":"en.asad"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":604800,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/education:quran-cloud/search":{"get":{"operationId":"education_quran_cloud_search","summary":"Search","description":"Search a translation.","tags":["education"],"parameters":[{"name":"keyword","in":"query","required":true,"schema":{"type":"string"},"example":"mercy"},{"name":"edition","in":"query","required":false,"schema":{"type":"string","default":"en.asad"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"RunEnvelope":{"type":"object","required":["project","data","timestamp"],"properties":{"project":{"type":"string","example":"dev-tools:hash"},"data":{},"timestamp":{"type":"string","format":"date-time"}}},"ErrorEnvelope":{"type":"object","properties":{"content":{},"message":{"type":"string"},"errors":{"type":"array","items":{}},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}},"responses":{"Error":{"description":"Invalid key, plan gate, rate limit or upstream failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}}