---
title: "Book Covers"
canonical: "https://support.soutron.net/space/LMSAPI/2228392/Book%20Covers"
format: markdown
---
> ❌ Limitations apply: If you plan to use the API to get book covers you should apply your own API key for the book cover service to avoid hitting limitations by using the same API key the application uses for that service.

## <span style="color: #008000">GET </span><span style="color: #008000">/catalogues/bookCovers</span>

<span style="color: #000000">**Description**</span><span style="color: #0000ff">**:**</span> Get Book covers from google.

| **Parameter** | **Example** | **Notes** |
| --- | --- | --- |
| field | ISBN | Field name used to store ISBN values. |
| <span style="color: #000000">value</span><br>[Required] | 9781409419075,9780199665044,9781847669186 | Any value from the field set by field parameter, separated by comma |
| <span style="color: #000000">provider</span> | Google | Only Google covers are currently supported |
| <span style="color: #000000">size</span> | Small | Available sizes include: Small, Medium, Large |
| <span style="color: #000000">result-mode</span> | 1 | Available values are 1 (url) to return the image URL or 2 (image) to return the image itself |

<span style="color: #000000">**Request**</span>**<span style="color: #0000ff">: </span>**<span style="color: #003366">/SoutronAPI/catalogues/bookCovers/?field=ISBN&value=9781409419075&provider=Google&size=Small&result-mode=1</span>

<details>
<summary>Response</summary>

```xml
<BookCoversSearchResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Soutron.API.ServiceModel.Catalogues">
	<BookCoverInfo>
		<BookCoverInfo>
			<BookPreviewUrl>http://books.google.co.uk/books?id=On2fXwAACAAJ&dq=isbn:9781409419075&hl=&cd=1&source=gbs_api</BookPreviewUrl>
			<ImageLargeUrl>http://books.google.com/books/content?id=On2fXwAACAAJ&printsec=frontcover&img=1&zoom=1&source=gbs_api</ImageLargeUrl>
			<ImageMediumUrl i:nil="true"/>
			<ImageRequestedUrl>http://books.google.com/books/content?id=On2fXwAACAAJ&printsec=frontcover&img=1&zoom=5&source=gbs_api</ImageRequestedUrl>
			<ImageSmallUrl>http://books.google.com/books/content?id=On2fXwAACAAJ&printsec=frontcover&img=1&zoom=5&source=gbs_api</ImageSmallUrl>
			<QueryFieldValue>9781409419075</QueryFieldValue>
			<Source>Google</Source>
		</BookCoverInfo>
	</BookCoverInfo>
</BookCoversSearchResponse>
```
</details>