πŸš€ New! ArtPexels Studio is now available on Microsoft Store. Get it Free

ArtPexels API

A simple JSON API to fetch wallpapers and categories from ArtPexels.

REST JSON Public (No API key required)
API Status Demo
Base URL
https://artpexels.com/api
Quick Links
Endpoints Wallpapers Orientation Category
Demo
β€”
$
▍
Response
{}
Preview
Documentation
Endpoints overview GET /wallpapers Horizontal / Portrait Category filtering GET /categories Errors

Endpoints

All responses are returned as JSON.

Method Path Use
GET /wallpapers List + search + filters (category/orientation)
GET /categories All categories

GET /wallpapers

List wallpapers with pagination, sorting, and filters.

200 OK
Example (Recent)
GET https://artpexels.com/api/wallpapers?page=1&limit=20
Query Params
  • page β€” default: 1
  • limit β€” number, or all/-1 for no limit
  • sort β€” popular, featured, random
  • search β€” search by title/tags/category
  • category β€” filter by category name
  • subCategory β€” optional sub-category filter
Response
  • success β€” true/false
  • data β€” wallpapers array
  • pagination β€” pages + count
  • thumbnailUrl/fullImageUrl β€” full URL
Example (cURL)
curl "https://artpexels.com/api/wallpapers?sort=popular&page=1&limit=20"
Example (No Limit)
GET https://artpexels.com/api/wallpapers?limit=all
Tip: Use with careβ€”fetching everything can be slow on large datasets.

Orientation (Horizontal / Portrait)

Use the orientation query parameter.

Horizontal
Use: orientation=landscape
https://artpexels.com/api/wallpapers?orientation=landscape
Portrait
Use: orientation=portrait
https://artpexels.com/api/wallpapers?orientation=portrait
Square
Use: orientation=square
https://artpexels.com/api/wallpapers?orientation=square

Category / SubCategory

Filter by category and optional subCategory.

Example (Category)
https://artpexels.com/api/wallpapers?category=Nature&page=1&limit=20
Example (Category + Orientation)
https://artpexels.com/api/wallpapers?category=Nature&orientation=landscape

GET /categories

List all categories.

200 OK
Example
https://artpexels.com/api/categories

Errors

On failure, the response will contain success: false.

Status Meaning
200 Success
500 Server error