Fast licensed asset search for design tools

const base = process.env.EPOCHAL_API_BASE ?? "https://epochalstock.com/api/v1";
const key = process.env.EPOCHAL_API_KEY;
if (!key) throw new Error("Set EPOCHAL_API_KEY on the server");

const params = new URLSearchParams({
  q: "golden forest",
  tags: "nature,trees",
  tag_mode: "all",
  sort: "newest",
  limit: "30",
});

const response = await fetch(`${base}/images?${params}`, {
  headers: {
    Authorization: `Bearer ${key}`,
    Accept: "application/json",
  },
});

if (!response.ok) {
  // Surface 401 / 402 / 429 to your plugin via your own error shape
  throw new Error(await response.text());
}

const { data, meta } = await response.json();
// data.images, data.total, data.next_cursor, data.filters
// meta.request_id — log for support
return {
  images: data.images,
  total: data.total,
  nextCursor: data.next_cursor ?? null,
  requestId: meta?.request_id,
};

$base = getenv('EPOCHAL_API_BASE') ?: 'https://epochalstock.com/api/v1';
$key = getenv('EPOCHAL_API_KEY');
if ($key === false || $key === '') {
    throw new RuntimeException('Set EPOCHAL_API_KEY on the server');
}

$query = http_build_query([
    'q' => 'golden forest',
    'tags' => 'nature,trees',
    'tag_mode' => 'all',
    'sort' => 'newest',
    'limit' => 30,
]);

$ch = curl_init(rtrim($base, '/') . '/images?' . $query);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . $key,
        'Accept: application/json',
    ],
    CURLOPT_TIMEOUT => 20,
]);
$response = curl_exec($ch);
$status = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status !== 200) {
    throw new RuntimeException((string) $response);
}

$payload = json_decode($response, true, 512, JSON_THROW_ON_ERROR);
$data = $payload['data'];
// $data['images'], $data['total'], $data['next_cursor'], $data['filters']

import os
import requests

base = os.environ.get("EPOCHAL_API_BASE", "https://epochalstock.com/api/v1")
key = os.environ["EPOCHAL_API_KEY"]

r = requests.get(
    f"{base}/images",
    params={
        "q": "golden forest",
        "tags": "nature,trees",
        "tag_mode": "all",
        "sort": "newest",
        "limit": 30,
    },
    headers={
        "Authorization": f"Bearer {key}",
        "Accept": "application/json",
    },
    timeout=20,
)
r.raise_for_status()
data = r.json()["data"]
print(data["total"], len(data["images"]), data.get("next_cursor"))

async function searchPage({ q, tags, tagMode = "all", sort = "newest", limit = 24, cursor }) {
  const base = process.env.EPOCHAL_API_BASE ?? "https://epochalstock.com/api/v1";
  const params = new URLSearchParams({ sort, limit: String(limit) });
  if (q) params.set("q", q);
  if (tags) {
    params.set("tags", Array.isArray(tags) ? tags.join(",") : tags);
    params.set("tag_mode", tagMode);
  }
  if (cursor) params.set("cursor", cursor);

  const res = await fetch(`${base}/images?${params}`, {
    headers: {
      Authorization: `Bearer ${process.env.EPOCHAL_API_KEY}`,
      Accept: "application/json",
    },
  });
  if (!res.ok) throw new Error(await res.text());
  const { data } = await res.json();
  return {
    images: data.images,
    total: data.total,
    nextCursor: data.next_cursor ?? null,
  };
}

function search_page(array $opts): array
{
    $base = rtrim(getenv('EPOCHAL_API_BASE') ?: 'https://epochalstock.com/api/v1', '/');
    $params = [
        'sort' => $opts['sort'] ?? 'newest',
        'limit' => $opts['limit'] ?? 24,
    ];
    if (!empty($opts['q'])) {
        $params['q'] = $opts['q'];
    }
    if (!empty($opts['tags'])) {
        $params['tags'] = is_array($opts['tags']) ? implode(',', $opts['tags']) : $opts['tags'];
        $params['tag_mode'] = $opts['tag_mode'] ?? 'all';
    }
    if (!empty($opts['cursor'])) {
        $params['cursor'] = $opts['cursor'];
    }

    $ch = curl_init($base . '/images?' . http_build_query($params));
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => [
            'Authorization: Bearer ' . getenv('EPOCHAL_API_KEY'),
            'Accept: application/json',
        ],
        CURLOPT_TIMEOUT => 20,
    ]);
    $body = curl_exec($ch);
    $status = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);
    if ($status !== 200) {
        throw new RuntimeException((string) $body);
    }
    return json_decode($body, true, 512, JSON_THROW_ON_ERROR)['data'];
}

import os
import requests

def search_page(*, q=None, tags=None, tag_mode="all", sort="newest", limit=24, cursor=None):
    base = os.environ.get("EPOCHAL_API_BASE", "https://epochalstock.com/api/v1")
    params = {"sort": sort, "limit": limit}
    if q:
        params["q"] = q
    if tags:
        params["tags"] = ",".join(tags) if isinstance(tags, list) else tags
        params["tag_mode"] = tag_mode
    if cursor:
        params["cursor"] = cursor

    r = requests.get(
        f"{base}/images",
        params=params,
        headers={
            "Authorization": f"Bearer {os.environ['EPOCHAL_API_KEY']}",
            "Accept": "application/json",
        },
        timeout=20,
    )
    r.raise_for_status()
    return r.json()["data"]