ArtPexels API Documentation

# Fetch 20 high-resolution wallpapers sorted by popularity
curl -X GET "https://artpexels.com/api/wallpapers?limit=20&sort=popular" \
  -H "Accept: application/json" \
  -H "X-API-Key: apx_your_api_key_here"

const apiKey = 'apx_your_api_key_here';
const endpoint = 'https://artpexels.com/api/wallpapers?limit=20&orientation=landscape';

async function loadWallpapers() {
  try {
    const response = await fetch(endpoint, {
      headers: {
        'Accept': 'application/json',
        'X-API-Key': apiKey,
        'x-app-package': 'com.yourdomain.app' // Optional origin identifier
      }
    });

    if (!response.ok) throw new Error(`HTTP error! status: ${response.status}`);
    const { data, pagination } = await response.json();
    console.log(`Loaded ${data.length} wallpapers:`, data);
  } catch (error) {
    console.error('API Error:', error);
  }
}

loadWallpapers();

import requests

url = "https://artpexels.com/api/wallpapers"
headers = {
    "Accept": "application/json",
    "X-API-Key": "apx_your_api_key_here"
}
params = {
    "limit": 20,
    "sort": "popular",
    "orientation": "portrait"
}

try:
    response = requests.get(url, headers=headers, params=params, timeout=10)
    response.raise_for_status()
    payload = response.json()
    wallpapers = payload.get("data", [])
    print(f"Successfully retrieved {len(wallpapers)} wallpapers")
except requests.exceptions.RequestException as e:
    print(f"API Request Failed: {e}")

import 'dart:convert';
import 'package:http/http.dart' as http;

Future<List<dynamic>> fetchWallpapers() async {
  final uri = Uri.parse('https://artpexels.com/api/wallpapers?orientation=portrait&limit=20');

  final response = await http.get(
    uri,
    headers: {
      'Accept': 'application/json',
      'X-API-Key': 'apx_your_api_key_here',
      'x-app-package': 'com.yourcompany.wallpaperapp'
    },
  );

  if (response.statusCode == 200) {
    final Map<String, dynamic> payload = jsonDecode(response.body);
    return payload['data'] as List<dynamic>;
  } else {
    throw Exception('Failed to load wallpapers: ${response.statusCode}');
  }
}

using System;
using System.Net.Http;
using System.Threading.Tasks;

public class ArtPexelsApiClient {
    private static readonly HttpClient client = new HttpClient();

    public static async Task GetWallpapersAsync() {
        var request = new HttpRequestMessage(HttpMethod.Get, "https://artpexels.com/api/wallpapers?limit=20");
        request.Headers.Add("Accept", "application/json");
        request.Headers.Add("X-API-Key", "apx_your_api_key_here");

        HttpResponseMessage response = await client.SendAsync(request);
        if (response.IsSuccessStatusCode) {
            string json = await response.Content.ReadAsStringAsync();
            Console.WriteLine(json);
        } else {
            Console.WriteLine($"Error: {response.StatusCode}");
        }
    }
}

<?php
$apiKey = 'apx_your_api_key_here';
$url = 'https://artpexels.com/api/wallpapers?limit=20';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Accept: application/json',
    'X-API-Key: ' . $apiKey
]);

$response = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'Curl error: ' . curl_error($ch);
} else {
    $data = json_decode($response, true);
    print_r($data['data']);
}
curl_close($ch);
?>

import Foundation

let url = URL(string: "https://artpexels.com/api/wallpapers?limit=20")!
var request = URLRequest(url: url)
request.httpMethod = "GET"
request.setValue("application/json", forHTTPHeaderField: "Accept")
request.setValue("apx_your_api_key_here", forHTTPHeaderField: "X-API-Key")

let task = URLSession.shared.dataTask(with: request) { data, response, error in
    guard let data = data, error == nil else { return }
    do {
        if let json = try JSONSerialization.jsonObject(with: data) as? [String: Any],
           let items = json["data"] as? [[String: Any]] {
            print("Loaded items: \(items.count)")
        }
    } catch {
        print("JSON Error: \(error)")
    }
}
task.resume()

import okhttp3.OkHttpClient
import okhttp3.Request

fun fetchWallpapers() {
    val client = OkHttpClient()
    val request = Request.Builder()
        .url("https://artpexels.com/api/wallpapers?limit=20")
        .addHeader("Accept", "application/json")
        .addHeader("X-API-Key", "apx_your_api_key_here")
        .build()

    client.newCall(request).execute().use { response ->
        if (response.isSuccessful) {
            val body = response.body?.string()
            println(body)
        }
    }
}