Service metadata

Code snippets

curl "https://api.oanor.com/pixiv-api/v1/meta" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/pixiv-api/v1/meta", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/pixiv-api/v1/meta");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);

import requests
requests.get(
    "https://api.oanor.com/pixiv-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "note": "ranking takes mode (daily/weekly/monthly/rookie/original/male/female), content (all/illust/manga/ugoira), page (1-10, 50/page) and optional date=YYYYMMDD. illust takes id (a numeric pixiv artwork id). meta takes no parameters. Counts are live integers; a short ~5-minute cache fronts pixiv. Image binaries are not proxied — url points to the pixiv artwork page.",
        "sample": {
            "views": 32014,
            "artist": "lack",
            "points": 469,
            "top_title": "さらばアルランディス"
        },
        "source": "pixiv public ranking + artwork endpoints (pixiv.net), keyless, live",
        "service": "pixiv-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/illust": "One artwork in full by id (id=145692794).",
            "GET /v1/ranking": "Official pixiv ranking by mode (mode=daily, content=illust, page=1)."
        },
        "description": "Live rankings and artwork engagement from pixiv (pixiv.net), Japan's dominant art-and-illustration social network, keyless. The ranking endpoint returns the official pixiv ranking for a mode (daily, weekly, monthly, rookie, original, male, female) — top works with rank, title, artist, views, ranking points, tags and previous rank. The illust endpoint returns one artwork by id with full engagement (views, bookmarks, likes, comments), tags, dimensions, upload date and age-restriction flag. The pixiv platform cut — distinct from danbooru (imageboard aggregator) and the other art/social feeds. Only SFW ranking modes are exposed; artworks carry an x_restrict flag.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-13T04:42:38.801Z",
        "request_id": "eb42dc90-9069-47af-8e66-927c714fa74f"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}