FreeImageDomain API
FreeImageDomain API is a REST_API made to power FreeImageDomain and, therefore, allows to retrieve multiple images belonging to the public domain extracted from different sources.
FreeImageDomain
Which sources are being used?
Currently there are six image sources used:
- Openverse
- Iconify
- Wikimedia Commons
- NASA
- Library of Congress
- Metropolitan Museum
Usage
The FreeImageDomain API does not require registration and posseses two endpoints:
- Look for images in all sources except the Metropolitan Museum: //free-image-domain-api.vercel.app/retrieve_public_images?q={query}&limit={number of entries}&license={license}
- Look for images in the Metropolitan Museum: //free-image-domain-api.vercel.app/retrieve_met?q=${search_term}&limit={limit}&license={license}
Where {query} stands for the search term the user wants to use, {limit} the number of entries, and finally {license} for the license each image needs to have
Currently only cc0 license is implemented and it will return results belonging to the public domain, still, you can use the API to look for images with licenses that match a specific term in all sources like CC-SA 1.0.
Example of use:
https://free-image-domain-api.vercel.app/retrieve_public_images?q=dog&limit=20&license=cc0`
https://free-image-domain-api.vercel.app/retrieve_met?q=dog&limit=20&license=cc0`
Results
Both endpoints return a JSON with six entries, each containing an array where every element contains the url of an image and different metadata that has been found about it.
Rate Limit
The FreeImageDomain API allows a maximum of 7 requests per minute.
This limit has been established due to the fact that FreeImageDomain uses external APIs to retrieve images and, therefore, the limits defined for each must be respected in order for all websites to function properly.
IF THE REQUESTS PER MINUTE LIMIT IS EXCEEDED, A MESSAGE WILL BE RETURNED ALONGSIDE A 429 ERROR INDICATING THAT THE LIMIT HAS BEEN EXCEEDED. AFTER A MINUTE IT WILL BE POSIBLE TO MAKE REQUESTS AGAIN