Search Royalty Free Images API

Search through hundreds of thousands of royalty free images to match any topic you want. The images are returned in a list with the URL, width, and height of the image. Additionally, you can find the license type and link of the image.

GET
https://api.apileague.com/search-images

Parameters

Name Example Description
query
s r q
dogsThe search query.
number
n o q
3The number of images to return in range [1,100]
api-key
s r q
abcd1234Your API key.
Example Request and Response
GET
https://api.apileague.com/search-images?query=dogs&number=3
{
    "images": [
        {
            "url": "https://images.unsplash.com/photo-1529472119196-cb724127a98e?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&ixid=M3w5NTgyNnwwfDF8c2VhcmNofDF8fGRvZ3N8ZW58MHx8fHwxNzA4MjkyMjA0fDA&ixlib=rb-4.0.3&q=80&w=1080",
            "thumbnail": "https://images.unsplash.com/photo-1529472119196-cb724127a98e?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&ixid=M3w5NTgyNnwwfDF8c2VhcmNofDF8fGRvZ3N8ZW58MHx8fHwxNzA4MjkyMjA0fDA&ixlib=rb-4.0.3&q=80&w=200",
            "width": 2303,
            "height": 3594,
            "license": {
                "name": "FREE",
                "link": "https://unsplash.com/license"
            },
            "id": "U6nlG0Y5sfs"
        },
        {
            "url": "https://images.unsplash.com/photo-1598133894008-61f7fdb8cc3a?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&ixid=M3w5NTgyNnwwfDF8c2VhcmNofDJ8fGRvZ3N8ZW58MHx8fHwxNzA4MjkyMjA0fDA&ixlib=rb-4.0.3&q=80&w=1080",
            "thumbnail": "https://images.unsplash.com/photo-1598133894008-61f7fdb8cc3a?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&ixid=M3w5NTgyNnwwfDF8c2VhcmNofDJ8fGRvZ3N8ZW58MHx8fHwxNzA4MjkyMjA0fDA&ixlib=rb-4.0.3&q=80&w=200",
            "width": 2694,
            "height": 4033,
            "license": {
                "name": "FREE",
                "link": "https://unsplash.com/license"
            },
            "id": "BJaqPaH6AGQ"
        },
        {
            "url": "https://images.unsplash.com/photo-1568572933382-74d440642117?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&ixid=M3w5NTgyNnwwfDF8c2VhcmNofDN8fGRvZ3N8ZW58MHx8fHwxNzA4MjkyMjA0fDA&ixlib=rb-4.0.3&q=80&w=1080",
            "thumbnail": "https://images.unsplash.com/photo-1568572933382-74d440642117?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&ixid=M3w5NTgyNnwwfDF8c2VhcmNofDN8fGRvZ3N8ZW58MHx8fHwxNzA4MjkyMjA0fDA&ixlib=rb-4.0.3&q=80&w=200",
            "width": 3024,
            "height": 4032,
            "license": {
                "name": "FREE",
                "link": "https://unsplash.com/license"
            },
            "id": "v0_MCllHY9M"
        }
    ]
}
cURL
Java
Javascript
Python
Go
C#
 Copy Codecurl -X GET 'https://api.apileague.com/search-images?query=dogs&number=3' \ -H 'x-api-key: myapikey'

Headers

Response Headers:

  • Content-Type: application/json
  • X-API-Quota-Request: The number of tokens used by the request
  • X-API-Quota-Used: The number of tokens used in total today
  • X-API-Quota-Left: The number of tokens left today (depends on your plan)

Quotas

Calling this endpoint costs
2 tokens