Tags & catalog statistics

const params = new URLSearchParams({
  q: "forest",
  sort: "count",
  order: "desc",
  limit: "50",
});

const listRes = await fetch(
  `https://epochalstock.com/api/v1/tags?${params}`,
  {
    headers: {
      Authorization: `Bearer ${process.env.EPOCHAL_API_KEY}`,
      Accept: "application/json",
    },
  }
);
if (!listRes.ok) throw new Error(await listRes.text());
const { data: list } = await listRes.json();
for (const row of list.tags ?? []) {
  console.log(row.tag, row.image_count);
}

const tag = "forest";
const oneRes = await fetch(
  `https://epochalstock.com/api/v1/tags/${encodeURIComponent(tag)}`,
  {
    headers: {
      Authorization: `Bearer ${process.env.EPOCHAL_API_KEY}`,
      Accept: "application/json",
    },
  }
);
if (!oneRes.ok) throw new Error(await oneRes.text());
console.log(await oneRes.json());

$query = http_build_query([
    'q' => 'forest',
    'sort' => 'count',
    'order' => 'desc',
    'limit' => 50,
]);
$ch = curl_init('https://epochalstock.com/api/v1/tags?' . $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'];
// Each row: tag, image_count

// Detail
$tag = rawurlencode('forest');
$ch = curl_init('https://epochalstock.com/api/v1/tags/' . $tag);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('EPOCHAL_API_KEY'),
        'Accept: application/json',
    ],
    CURLOPT_TIMEOUT => 20,
]);
$detail = curl_exec($ch);

import os
import requests

headers = {
    "Authorization": f"Bearer {os.environ['EPOCHAL_API_KEY']}",
    "Accept": "application/json",
}

r = requests.get(
    "https://epochalstock.com/api/v1/tags",
    params={"q": "forest", "sort": "count", "order": "desc", "limit": 50},
    headers=headers,
    timeout=20,
)
r.raise_for_status()
payload = r.json()["data"]
for row in payload.get("tags") or []:
    print(row["tag"], row["image_count"])

one = requests.get(
    "https://epochalstock.com/api/v1/tags/forest",
    headers=headers,
    timeout=20,
)
one.raise_for_status()
print(one.json()["data"])

package main

import (
    "encoding/json"
    "fmt"
    "io"
    "net/http"
    "net/url"
    "os"
    "time"
)

func main() {
    q := url.Values{}
    q.Set("q", "forest")
    q.Set("sort", "count")
    q.Set("order", "desc")
    q.Set("limit", "50")

    req, _ := http.NewRequest(http.MethodGet,
        "https://epochalstock.com/api/v1/tags?"+q.Encode(), nil)
    req.Header.Set("Authorization", "Bearer "+os.Getenv("EPOCHAL_API_KEY"))
    req.Header.Set("Accept", "application/json")

    client := &http.Client{Timeout: 20 * time.Second}
    res, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer res.Body.Close()
    body, _ := io.ReadAll(res.Body)
    if res.StatusCode != http.StatusOK {
        panic(fmt.Sprintf("%d %s", res.StatusCode, body))
    }

    var payload map[string]any
    _ = json.Unmarshal(body, &payload)
    fmt.Println(string(body))
}

import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;
import java.time.Duration;

String qs = "q=" + URLEncoder.encode("forest", StandardCharsets.UTF_8)
    + "&sort=count&order=desc&limit=50";

HttpClient client = HttpClient.newBuilder()
    .connectTimeout(Duration.ofSeconds(10))
    .build();

HttpRequest listReq = HttpRequest.newBuilder()
    .uri(URI.create("https://epochalstock.com/api/v1/tags?" + qs))
    .timeout(Duration.ofSeconds(20))
    .header("Authorization", "Bearer " + System.getenv("EPOCHAL_API_KEY"))
    .header("Accept", "application/json")
    .GET()
    .build();

HttpResponse<String> listRes = client.send(listReq, HttpResponse.BodyHandlers.ofString());
if (listRes.statusCode() != 200) {
    throw new IllegalStateException(listRes.body());
}
// Parse data tags[] with tag + image_count
System.out.println(listRes.body());

const response = await fetch("https://epochalstock.com/api/v1/stats", {
  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_images, data.total_tags, data.catalog_built_at);

$ch = curl_init('https://epochalstock.com/api/v1/stats');
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['total_images'], $data['total_tags'], $data['catalog_built_at']

import os
import requests

r = requests.get(
    "https://epochalstock.com/api/v1/stats",
    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_images"], data["total_tags"], data["catalog_built_at"])

package main

import (
    "encoding/json"
    "fmt"
    "io"
    "net/http"
    "os"
    "time"
)

func main() {
    req, _ := http.NewRequest(http.MethodGet,
        "https://epochalstock.com/api/v1/stats", nil)
    req.Header.Set("Authorization", "Bearer "+os.Getenv("EPOCHAL_API_KEY"))
    req.Header.Set("Accept", "application/json")

    client := &http.Client{Timeout: 20 * time.Second}
    res, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer res.Body.Close()
    body, _ := io.ReadAll(res.Body)
    if res.StatusCode != http.StatusOK {
        panic(fmt.Sprintf("%d %s", res.StatusCode, body))
    }

    var payload struct {
        Data struct {
            TotalImages    int    `json:"total_images"`
            TotalTags      int    `json:"total_tags"`
            CatalogBuiltAt string `json:"catalog_built_at"`
        } `json:"data"`
    }
    _ = json.Unmarshal(body, &payload)
    fmt.Println(payload.Data.TotalImages, payload.Data.TotalTags, payload.Data.CatalogBuiltAt)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;

HttpClient client = HttpClient.newBuilder()
    .connectTimeout(Duration.ofSeconds(10))
    .build();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://epochalstock.com/api/v1/stats"))
    .timeout(Duration.ofSeconds(20))
    .header("Authorization", "Bearer " + System.getenv("EPOCHAL_API_KEY"))
    .header("Accept", "application/json")
    .GET()
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
if (response.statusCode() != 200) {
    throw new IllegalStateException(response.body());
}
// Parse data.total_images, data.total_tags, data.catalog_built_at
System.out.println(response.body());