Developers

Public catalog API and discovery endpoints for NeuralStash

Overview

Read-only JSON catalog of published NeuralStash assets. No API key. Built for discovery, research, integrations, and AI agents — not for bulk downloading master files.

Use this API to list published titles, categories, preview URLs, and deep links into asset pages. To download a master file, use the normal website download flow under our royalty-free license. Do not treat preview URLs as a substitute for licensed downloads.

Authentication

None. The endpoint is public and returns only published catalog metadata. Private ops and contributor tools use separate authenticated APIs and are not documented here.

Endpoint

GET https://www.neuralstash.com/api/public/assets

Query parameters

q (optional) — Keyword search across title and keywords (max 200 characters).
page (optional) — Page number, starting at 1 (default 1, max 100).
pageSize (optional) — Results per page (default 24, max 50).

Example request

https://www.neuralstash.com/api/public/assets?q=nature&page=1&pageSize=12

curl -sS "https://www.neuralstash.com/api/public/assets?q=nature&page=1&pageSize=12"

Example response shape

{
  "page": 1,
  "pageSize": 12,
  "total": 195,
  "totalPages": 17,
  "assets": [
    {
      "id": 215,
      "title": "Gourmet Cheese Board Overhead",
      "slug": "gourmet-cheese-board-overhead-rustic",
      "assetType": "photos",
      "category": "food-drink",
      "keywords": "cheese, gourmet cheese, cheese board, …",
      "description": "…",
      "licenseType": "royalty-free",
      "previewUrl": "https://cdn.neuralstash.com/file/NeuralStash/previews/…",
      "url": "/photos/food-drink/gourmet-cheese-board-overhead-rustic"
    }
  ]
}

Response fields

id
title
slug
assetType
category
keywords
description
licenseType
previewUrl
url

url is a site-relative path to the asset detail page. Prefixed with the site origin it becomes a shareable deep link. previewUrl points at a CDN JPEG suitable for cards and embeds — not the downloadable master.

Fair use

Cache responses reasonably; avoid aggressive polling.
Respect robots and rate limits if we introduce them later.
Do not use the API to scrape or redistribute master files.
Attribute commercial usage according to the license terms when you download through the site.

Related discovery URLs

Support

Questions about integrating NeuralStash into a product or research workflow: contact@neuralstash.com. For product context see About.