Skip to content

Free Stock Image API Without Key for Websites, Apps, and Creative Tools

Connect Pixplet to your website, app, CMS, plugin, automation, or creative workflow and access high quality royalty free images through a simple public API. No API key required.

Why Pixplet API

Pixplet offers a growing library of free stock images built for modern websites, blogs, social media, marketing materials, creative projects, content tools, and publishing workflows.

The Pixplet API makes it easy to connect those images directly to your own product or platform.

You can use it to:

  • power image search inside websites and apps
  • build WordPress plugins and CMS integrations
  • add free stock images to design tools and editors
  • automate content workflows with image search and import
  • connect Pixplet to internal systems, no code tools, and publishing platforms
Production example

Built with Pixplet API

The official Pixplet Media Library WordPress plugin is powered by the public Pixplet API.

Users can search free stock photos, preview image details, import selected images directly into the WordPress Media Library, and use them as featured images inside WordPress.

This is a real example of how Pixplet API can power practical tools for WordPress, CMS integrations, publishing workflows, media libraries, and content platforms.

View WordPress plugin
Pixplet Media Library WordPress plugin image preview and import screen

Base URL

https://www.pixplet.com/wp-json/pixplet/v1

Authentication

No authentication required.

Pixplet API is currently public and free to use. You do not need an account, API key, bearer token, or access token.

Version

v1

Future breaking changes, if introduced, will use a new versioned endpoint.

Content Visibility and Stability

Pixplet API is designed to return only stable published records.

New images are prepared internally before being released through the public API. This means API responses stay consistent and do not expose unfinished uploads, incomplete metadata, or unpublished image records.

Available Endpoints

1. Search images

GET /search

Search Pixplet images by keyword, category, or tag.

Supported query parameters

  • q
  • category
  • tag
  • page
  • per_page

Example requests

https://www.pixplet.com/wp-json/pixplet/v1/search?q=office&page=1&per_page=20
https://www.pixplet.com/wp-json/pixplet/v1/search?category=business&page=1&per_page=20
https://www.pixplet.com/wp-json/pixplet/v1/search?tag=workspace&page=1&per_page=20
https://www.pixplet.com/wp-json/pixplet/v1/search?q=office&category=business&page=1&per_page=20

2. Get image details

GET /images/{id}

Retrieve full image details including image URLs, original file, download URL, page URL, categories, tags, and content data.

Example request

https://www.pixplet.com/wp-json/pixplet/v1/images/70390

3. Get related images

GET /images/{id}/related

Return related images based on shared categories and tags.

Supported query parameters

  • page
  • per_page

Example request

https://www.pixplet.com/wp-json/pixplet/v1/images/70390/related?page=1&per_page=12

4. Get categories

GET /categories

Return available image categories.

Supported query parameters

  • hide_empty

Example request

https://www.pixplet.com/wp-json/pixplet/v1/categories?hide_empty=true

5. Get images by category

GET /categories/{slug}/images

Return images for a specific category.

Supported query parameters

  • page
  • per_page

Example request

https://www.pixplet.com/wp-json/pixplet/v1/categories/business/images?page=1&per_page=20

Pagination

Endpoints that return image collections support pagination.

Pagination fields

  • page
  • per_page
  • total_items
  • total_pages
  • has_more

Typical usage

/search?q=office&page=1&per_page=20
/search?q=office&page=2&per_page=20
/categories/business/images?page=1&per_page=20
/images/70390/related?page=1&per_page=12

Example pagination response

{
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total_items": 20484,
    "total_pages": 1025,
    "has_more": true
  }
}

Response Format

Pixplet API returns structured JSON responses.

Search response example

{
  "success": true,
  "data": [
    {
      "id": 70390,
      "title": "Vintage Office Desk at Dusk",
      "slug": "vintage-office-desk-at-dusk-70390",
      "description": "A vintage office desk at dusk with warm ambient light, classic decor, and a calm professional atmosphere.",
      "page_url": "https://www.pixplet.com/vintage-office-desk-at-dusk-70390/",
      "published_at": "2026-03-29T10:15:00+00:00",
      "image": {
        "thumbnail_url": "https://cdn.pixplet.com/wp-content/uploads/2026/01/Vintage-Office-Desk-at-Dusk-768x432.jpg",
        "preview_url": "https://cdn.pixplet.com/wp-content/uploads/2026/01/Vintage-Office-Desk-at-Dusk-1024x576.jpg",
        "original_url": "https://cdn.pixplet.com/wp-content/uploads/2026/01/Vintage-Office-Desk-at-Dusk.jpg",
        "width": 1600,
        "height": 900,
        "alt": "Vintage office desk at dusk with warm lighting and classic workspace details."
      }
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total_items": 20484,
    "total_pages": 1025,
    "has_more": true
  }
}

Image detail response example

{
  "success": true,
  "data": {
    "id": 70390,
    "title": "Vintage Office Desk at Dusk",
    "slug": "vintage-office-desk-at-dusk-70390",
    "description": "A vintage office desk at dusk with warm ambient light, classic decor, and a calm professional atmosphere.",
    "content": {
      "raw": "<p>A vintage office desk at dusk with warm ambient light, classic decor, and a calm professional atmosphere.</p>",
      "plain_text": "A vintage office desk at dusk with warm ambient light, classic decor, and a calm professional atmosphere."
    },
    "page_url": "https://www.pixplet.com/vintage-office-desk-at-dusk-70390/",
    "published_at": "2026-03-29T10:15:00+00:00",
    "image": {
      "id": 70391,
      "thumbnail_url": "https://cdn.pixplet.com/wp-content/uploads/2026/01/Vintage-Office-Desk-at-Dusk-768x432.jpg",
      "preview_url": "https://cdn.pixplet.com/wp-content/uploads/2026/01/Vintage-Office-Desk-at-Dusk-1024x576.jpg",
      "original_url": "https://cdn.pixplet.com/wp-content/uploads/2026/01/Vintage-Office-Desk-at-Dusk.jpg",
      "full_url": "https://cdn.pixplet.com/wp-content/uploads/2026/01/Vintage-Office-Desk-at-Dusk.jpg",
      "download_url": "https://www.pixplet.com/?pixplet_download=70391&pixplet_size=original",
      "width": 1600,
      "height": 900,
      "alt": "Vintage office desk at dusk with warm lighting and classic workspace details.",
      "title": "Vintage Office Desk at Dusk",
      "caption": "",
      "description": "",
      "mime_type": "image/jpeg"
    },
    "categories": [
      {
        "id": 12,
        "name": "Business",
        "slug": "business",
        "description": "",
        "url": "https://www.pixplet.com/category/business/"
      }
    ],
    "tags": [
      {
        "id": 44,
        "name": "office",
        "slug": "office",
        "description": "",
        "url": "https://www.pixplet.com/search/office/"
      },
      {
        "id": 45,
        "name": "workspace",
        "slug": "workspace",
        "description": "",
        "url": "https://www.pixplet.com/search/workspace/"
      }
    ],
    "meta": {
      "word_count": 15
    }
  }
}

Related images response example

{
  "success": true,
  "data": [
    {
      "id": 70390,
      "title": "Vintage Office Desk at Dusk",
      "slug": "vintage-office-desk-at-dusk-70390",
      "description": "A vintage office desk at dusk with warm ambient light, classic decor, and a calm professional atmosphere.",
      "page_url": "https://www.pixplet.com/vintage-office-desk-at-dusk-70390/",
      "published_at": "2026-03-28T14:20:00+00:00",
      "relevance_score": 8,
      "image": {
        "thumbnail_url": "https://cdn.pixplet.com/wp-content/uploads/2026/01/Vintage-Office-Desk-at-Dusk-768x432.jpg",
        "preview_url": "https://cdn.pixplet.com/wp-content/uploads/2026/01/Vintage-Office-Desk-at-Dusk-1024x576.jpg",
        "original_url": "https://cdn.pixplet.com/wp-content/uploads/2026/01/Vintage-Office-Desk-at-Dusk.jpg",
        "width": 1600,
        "height": 900,
        "alt": "Vintage office desk at dusk with warm lighting and classic workspace details."
      }
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 12,
    "total_items": 24,
    "total_pages": 2,
    "has_more": true
  }
}

Categories response example

{
  "success": true,
  "data": [
    {
      "id": 12,
      "name": "Business",
      "slug": "business",
      "description": "",
      "count": 2480,
      "url": "https://www.pixplet.com/category/business/"
    },
    {
      "id": 19,
      "name": "Nature",
      "slug": "nature",
      "description": "",
      "count": 3124,
      "url": "https://www.pixplet.com/category/nature/"
    }
  ]
}

Field Reference

Search response fields

Each item returned by /search typically includes:

  • id
  • title
  • slug
  • description
  • page_url
  • published_at
  • image.thumbnail_url
  • image.preview_url
  • image.original_url
  • image.width
  • image.height
  • image.alt

Detail response fields

The /images/{id} endpoint may additionally include:

  • content.raw
  • content.plain_text
  • image.id
  • image.full_url
  • image.download_url
  • image.title
  • image.caption
  • image.description
  • image.mime_type
  • categories
  • tags
  • meta.word_count

Related response fields

Each item returned by /images/{id}/related typically includes:

  • id
  • title
  • slug
  • description
  • page_url
  • published_at
  • relevance_score
  • image.thumbnail_url
  • image.preview_url
  • image.original_url
  • image.width
  • image.height
  • image.alt

Image Files and Downloads

Pixplet API provides several image URLs for different use cases.

Use these for display inside apps, plugins, search results, and galleries

  • image.thumbnail_url
  • image.preview_url

Use these for direct file access

  • image.original_url
  • image.full_url

Recommended for importing or downloading the actual image file

  • image.download_url

Important: image.download_url returns the file directly. It does not return JSON.

This is the recommended field for importing images into tools such as WordPress Media Library or similar publishing systems.

Error Responses

Pixplet API uses standard JSON error responses when a request cannot be completed.

Example invalid request

{
  "success": false,
  "message": "Invalid request parameters"
}

Example not found response

{
  "success": false,
  "message": "Image not found"
}

Example empty result set

{
  "success": true,
  "data": [],
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total_items": 0,
    "total_pages": 0,
    "has_more": false
  }
}

Example Requests

JavaScript

const endpoint = 'https://www.pixplet.com/wp-json/pixplet/v1/search?q=office&page=1&per_page=12';

fetch(endpoint)
  .then((response) => response.json())
  .then((data) => {
    console.log(data.data);
  });

PHP

<?php
$response = wp_remote_get('https://www.pixplet.com/wp-json/pixplet/v1/search?q=office&page=1&per_page=12');

if (!is_wp_error($response)) {
    $body = wp_remote_retrieve_body($response);
    $data = json_decode($body, true);
    print_r($data['data']);
}

cURL

curl "https://www.pixplet.com/wp-json/pixplet/v1/search?q=office&page=1&per_page=12"

Example Import Workflow

A typical import workflow looks like this:

  1. Search for images using /search
  2. Select an image ID from the results
  3. Request /images/{id}
  4. Use image.download_url to download the actual file into your CMS, plugin, app, or media library

Example:

GET /search?q=office
GET /images/70390
Use image.download_url from the detail response

Common Use Cases

Pixplet API can be used for:

  • WordPress plugins
  • CMS integrations
  • website image search tools
  • browser extensions
  • internal publishing tools
  • no code automations
  • creative workflows
  • content generation pipelines
  • media import tools
  • custom galleries and stock image widgets

Attribution and Usage

Pixplet images are free to use for personal and commercial projects.

Attribution is not required.

If you want to support Pixplet, you may add:

Image by Pixplet.com

Please review Pixplet usage terms before building large scale redistribution systems, mirrored stock photo directories, or standalone stock photo products based on Pixplet content.

Usage Guidelines

Pixplet API is public and free to use.

Please use it responsibly.

Recommended usage:

  • cache responses when appropriate
  • paginate large result sets
  • avoid excessive automated scraping
  • do not create bulk mirrored stock photo databases
  • do not redistribute Pixplet as a standalone competing stock photo library

Pixplet may evolve over time to protect service quality and long term availability.

Yes. Pixplet API is currently public and free to use.
No. The API does not currently require authentication.
Yes. Pixplet images are free to use for personal and commercial projects, including websites, marketing, social media, videos, and print.
Yes. The API is designed for integrations, plugins, websites, tools, and publishing workflows.
No. The API returns only the image fields included in the API response. Additional download sizes may be available directly on Pixplet image pages for website users.