Search & list images

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

const response = await fetch(
  `https://epochalstock.com/api/v1/images?${params}`,
  {
    headers: {
      Authorization: `Bearer ${process.env.EPOCHAL_API_KEY}`,
      Accept: "application/json",
    },
  }
);

if (!response.ok) throw new Error(await response.text());
const { data } = await response.json();
console.log(data.total, data.images.length, data.next_cursor);

$query = http_build_query([
    'q' => 'golden forest',
    'tags' => 'nature,trees',
    'tag_mode' => 'all',
    'sort' => 'newest',
    'limit' => 30,
]);
$ch = curl_init('https://epochalstock.com/api/v1/images?' . $query);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('EPOCHAL_API_KEY'),
        'Accept: application/json',
    ],
    CURLOPT_TIMEOUT => 20,
]);
$response = curl_exec($ch);
if (curl_getinfo($ch, CURLINFO_HTTP_CODE) !== 200) {
    throw new RuntimeException((string) $response);
}
$data = json_decode($response, true, 512, JSON_THROW_ON_ERROR)['data'];
// $data['images'], $data['total'], $data['next_cursor'], $data['filters']

import os
import requests

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

using System.Net.Http.Headers;

var client = new HttpClient { Timeout = TimeSpan.FromSeconds(20) };
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer",
        Environment.GetEnvironmentVariable("EPOCHAL_API_KEY"));
client.DefaultRequestHeaders.Accept.ParseAdd("application/json");

var url =
    "https://epochalstock.com/api/v1/images" +
    "?q=golden%20forest&tags=nature,trees&tag_mode=all&sort=newest&limit=30";

using var response = await client.GetAsync(url);
response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();
// Parse data.images, data.total, data.next_cursor

async function* listAllForest(apiKey) {
  let cursor = "";
  for (;;) {
    const params = new URLSearchParams({
      tags: "forest",
      sort: "newest",
      limit: "50",
    });
    if (cursor) params.set("cursor", cursor);

    const res = await fetch(
      `https://epochalstock.com/api/v1/images?${params}`,
      { headers: { Authorization: `Bearer ${apiKey}`, Accept: "application/json" } }
    );
    if (!res.ok) throw new Error(await res.text());
    const { data } = await res.json();
    yield* data.images;
    if (!data.next_cursor) break;
    cursor = data.next_cursor;
  }
}

import os
import requests

def iter_images(**params):
    headers = {
        "Authorization": f"Bearer {os.environ['EPOCHAL_API_KEY']}",
        "Accept": "application/json",
    }
    cursor = None
    while True:
        q = dict(params)
        if cursor:
            q["cursor"] = cursor
        r = requests.get(
            "https://epochalstock.com/api/v1/images",
            params=q,
            headers=headers,
            timeout=20,
        )
        r.raise_for_status()
        data = r.json()["data"]
        yield from data["images"]
        cursor = data.get("next_cursor")
        if not cursor:
            break

for image in iter_images(tags="forest", sort="newest", limit=50):
    print(image["id"], image["title"])