{"openapi":"3.1.0","info":{"title":"Apizie","version":"2.0.0","description":"One API key, one envelope, many public data sources."},"servers":[{"url":"https://www.apizie.tech"}],"security":[{"ApiKeyAuth":[]}],"paths":{"/v1/open-data:isbndb/get-author-name":{"get":{"operationId":"open_data_isbndb_get_author_name","summary":"Gets author details","description":"GET /author/{name}","tags":["open-data"],"parameters":[{"name":"name","in":"query","required":true,"description":"The name of an author in the Author's database","schema":{"type":"string","description":"The name of an author in the Author's database"}},{"name":"page","in":"query","required":false,"description":"The number of page to retrieve, please note the API will not return more than 10,000 results no matter how you paginate them","schema":{"type":"string","description":"The number of page to retrieve, please note the API will not return more than 10,000 results no matter how you paginate them"}},{"name":"pageSize","in":"query","required":false,"description":"How many items should be returned per page, maximum of 1,000","schema":{"type":"string","description":"How many items should be returned per page, maximum of 1,000"}}],"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":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/open-data:isbndb/get-authors-query":{"get":{"operationId":"open_data_isbndb_get_authors_query","summary":"Search authors","description":"GET /authors/{query}","tags":["open-data"],"parameters":[{"name":"pageSize","in":"query","required":false,"description":"How many items should be returned per page, maximum of 1,000","schema":{"type":"string","description":"How many items should be returned per page, maximum of 1,000"}},{"name":"query","in":"query","required":true,"description":"A string to search for in the Author’s database","schema":{"type":"string","description":"A string to search for in the Author’s database"}},{"name":"page","in":"query","required":false,"description":"The number of page to retrieve, please note the API will not return more than 10,000 results no matter how you paginate them","schema":{"type":"string","description":"The number of page to retrieve, please note the API will not return more than 10,000 results no matter how you paginate them"}}],"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":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/open-data:isbndb/get-book-isbn":{"get":{"operationId":"open_data_isbndb_get_book_isbn","summary":"Gets book details","description":"GET /book/{isbn}","tags":["open-data"],"parameters":[{"name":"isbn","in":"query","required":true,"description":"an ISBN 10 or ISBN 13 in the Books database","schema":{"type":"string","description":"an ISBN 10 or ISBN 13 in the Books database"}}],"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":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/open-data:isbndb/get-books-query":{"get":{"operationId":"open_data_isbndb_get_books_query","summary":"Search books","description":"GET /books/{query}","tags":["open-data"],"parameters":[{"name":"query","in":"query","required":true,"description":"A string to search for in the Book’s database","schema":{"type":"string","description":"A string to search for in the Book’s database"}},{"name":"page","in":"query","required":false,"description":"The number of page to retrieve, please note the API will not return more than 10,000 results no matter how you paginate them","schema":{"type":"string","description":"The number of page to retrieve, please note the API will not return more than 10,000 results no matter how you paginate them"}},{"name":"author","in":"query","required":false,"description":"Filters the query results by author","schema":{"type":"string","description":"Filters the query results by author"}},{"name":"pageSize","in":"query","required":false,"description":"How many items should be returned per page, maximum of 1,000","schema":{"type":"string","description":"How many items should be returned per page, maximum of 1,000"}}],"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":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/open-data:isbndb/get-publisher-name":{"get":{"operationId":"open_data_isbndb_get_publisher_name","summary":"Gets publisher details","description":"GET /publisher/{name}","tags":["open-data"],"parameters":[{"name":"name","in":"query","required":true,"description":"The name of a publisher in the Publisher's database","schema":{"type":"string","description":"The name of a publisher in the Publisher's database"}},{"name":"page","in":"query","required":false,"description":"The number of page to retrieve, please note the API will not return more than 10,000 results no matter how you paginate them","schema":{"type":"string","description":"The number of page to retrieve, please note the API will not return more than 10,000 results no matter how you paginate them"}},{"name":"pageSize","in":"query","required":false,"description":"How many items should be returned per page, maximum of 1,000","schema":{"type":"string","description":"How many items should be returned per page, maximum of 1,000"}}],"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":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/open-data:isbndb/get-publishers-query":{"get":{"operationId":"open_data_isbndb_get_publishers_query","summary":"Search publishers","description":"GET /publishers/{query}","tags":["open-data"],"parameters":[{"name":"pageSize","in":"query","required":false,"description":"How many items should be returned per page, maximum of 1,000","schema":{"type":"string","description":"How many items should be returned per page, maximum of 1,000"}},{"name":"query","in":"query","required":true,"description":"A string to search for in the Publisher’s database","schema":{"type":"string","description":"A string to search for in the Publisher’s database"}},{"name":"page","in":"query","required":false,"description":"The number of page to retrieve, please note the API will not return more than 10,000 results no matter how you paginate them","schema":{"type":"string","description":"The number of page to retrieve, please note the API will not return more than 10,000 results no matter how you paginate them"}}],"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":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/open-data:isbndb/get-search":{"get":{"operationId":"open_data_isbndb_get_search","summary":"Search all ISBNDB databases","description":"GET /search","tags":["open-data"],"parameters":[{"name":"q","in":"query","required":false,"description":"A query string compatible with ElasticSearch 6","schema":{"type":"string","description":"A query string compatible with ElasticSearch 6"}}],"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":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/open-data:isbndb/get-stats":{"get":{"operationId":"open_data_isbndb_get_stats","summary":"Gets status on the ISBNDB Database","description":"GET /stats","tags":["open-data"],"parameters":[],"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":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/open-data:isbndb/get-subject-name":{"get":{"operationId":"open_data_isbndb_get_subject_name","summary":"Gets subject details","description":"GET /subject/{name}","tags":["open-data"],"parameters":[{"name":"name","in":"query","required":true,"description":"A subject in the Subject's database","schema":{"type":"string","description":"A subject in the Subject's database"}}],"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":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/open-data:isbndb/get-subjects-query":{"get":{"operationId":"open_data_isbndb_get_subjects_query","summary":"Search subjects","description":"GET /subjects/{query}","tags":["open-data"],"parameters":[{"name":"pageSize","in":"query","required":false,"description":"How many items should be returned per page, maximum of 1,000","schema":{"type":"string","description":"How many items should be returned per page, maximum of 1,000"}},{"name":"query","in":"query","required":true,"description":"A string to search for in the Subject’s database","schema":{"type":"string","description":"A string to search for in the Subject’s database"}},{"name":"page","in":"query","required":false,"description":"The number of page to retrieve, please note the API will not return more than 10,000 results no matter how you paginate them","schema":{"type":"string","description":"The number of page to retrieve, please note the API will not return more than 10,000 results no matter how you paginate them"}}],"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":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}}},"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"}}}}}}}