# pixiv Rankings & Artwork API
> Live rankings and artwork engagement from pixiv (pixiv.net), Japan's dominant art-and-illustration social network, read keyless from pixiv's public ranking and artwork endpoints. pixiv is where millions of illustrators, manga artists and animators post their work and where fans drive it up the daily, weekly and monthly rankings with views and bookmarks — the platform at the centre of anime and illustration fan culture, far bigger in that world than DeviantArt or ArtStation. The ranking endpoint returns the official pixiv ranking for a mode (daily, weekly, monthly, rookie, original, and the male/female popularity cuts) — the top works ranked, each with its rank (and previous-day rank), title, artist, view count, ranking points (bookmark-weighted), work type and tags; pass a content filter (illust, manga, ugoira), a page (1-10, 50 per page) or a past date. The illust endpoint returns one artwork in full by its pixiv id: its view, bookmark, like and comment counts, tags, dimensions, page count, upload date and age-restriction flag. This is the pixiv platform cut — a distinct social and creative platform, separate from danbooru (an imageboard aggregator) and from the other social and art feeds in the catalogue. Only safe-for-work ranking modes are exposed; individual artworks carry an x_restrict flag so age-restricted works are clearly labelled, not hidden. Counts are the real, live numbers pixiv shows; a short cache fronts the upstream. Keyless.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/pixiv-api/..."
```

## Pricing
- **Free** (Free) — 550 calls/Mo, 2 req/s
- **Starter** ($26/Mo) — 64,000 calls/Mo, 6 req/s
- **Pro** ($71/Mo) — 440,000 calls/Mo, 16 req/s
- **Scale** ($194/Mo) — 2,700,000 calls/Mo, 40 req/s

## Endpoints

### Ranking

#### `GET /v1/ranking` — Official pixiv ranking by mode

**Parameters:**
- `mode` (query, optional, string) — daily, weekly, monthly, rookie, original, male, female Example: `daily`
- `content` (query, optional, string) — all, illust, manga or ugoira Example: `illust`
- `page` (query, optional, string) — Page 1-10 (50 per page) Example: `1`
- `date` (query, optional, string) — Optional past date YYYYMMDD Example: `20260601`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/pixiv-api/v1/ranking?mode=daily&content=illust&page=1&date=20260601"
```

**Response:**
```json
{
    "data": {
        "date": "20260601",
        "mode": "daily",
        "note": "The official pixiv daily ranking — the top artworks ranked, each with its rank (and previous rank), title, artist, view count, ranking points (bookmark-weighted), work type and tags. mode: daily/weekly/monthly/rookie/original/male/female; content: all/illust/manga/ugoira; page 1-10 (50 per page); optional date=YYYYMMDD for a past day's ranking. Only safe-for-work modes are exposed. Live, cached ~5m.",
        "page": 1,
        "count": 50,
        "source": "pixiv public ranking endpoint (pixiv.net/ranking.php), keyless",
        "content": "illust",
        "ranking": [
            {
                "url": "https://www.pixiv.net/artworks/145430123",
                "rank": 1,
                "tags": [
                    "からめる",
                    "謎の疾走感",
                    "発想の源が狂ってるシリーズ",
                    "カオスが極まる",
                    "丘サーファー",
                    "ブルドーザーだっ!!!",
                    "そうはならんやろ",
                    "地球クリーン作戦",
                    "乗るしかねぇよな!このビッグウェーブに!",
                    "ブラックジョーク"
                ],
                "type": "illustration",
                "pages": 1,
                "title": "商店街でも海を感じたい猫",
                "views": 25940,
                
…(truncated, see openapi.json for full schema)
```

### Illust

#### `GET /v1/illust` — One artwork in full by id

**Parameters:**
- `id` (query, required, string) — pixiv artwork id Example: `145692794`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/pixiv-api/v1/illust?id=145692794"
```

**Response:**
```json
{
    "data": {
        "sfw": true,
        "url": "https://www.pixiv.net/artworks/145692794",
        "note": "One pixiv artwork in full: its view, bookmark, like and comment counts, tags, work type, dimensions, page count and upload date. x_restrict is pixiv's age flag (0 = all-ages, 1 = R-18, 2 = R-18G); sfw is true only when x_restrict is 0. Live, cached ~5m.",
        "tags": [
            "VOCALOID",
            "初音ミク",
            "テレパシ",
            "本家",
            "DECO*27"
        ],
        "type": "illustration",
        "likes": 7365,
        "pages": 1,
        "title": "テレパシ",
        "views": 58273,
        "width": 1080,
        "artist": "おむたつ/omutatsu",
        "height": 1350,
        "source": "pixiv public artwork endpoint (pixiv.net/ajax/illust), keyless",
        "created": "2026-06-06T15:00:00+00:00",
        "comments": 34,
        "uploaded": "2026-06-06T15:00:00+00:00",
        "artist_id": "1499614",
        "bookmarks": 9181,
        "illust_id": "145692794",
        "x_restrict": 0,
        "description": "DECO*27 - テレパシ feat. 初音ミク 2025制作"
    },
    "meta": {
        "timestamp": "2026-06-13T04:42:38.407Z",
        "request_id": "768beed6-499e-4cb5-a5a2-ae0e2c01ad16"
    },
    "status": "ok",
    "message": "Artwork retrieved successfully",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Service metadata

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/pixiv-api/v1/meta"
```

**Response:**
```json
{
    "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 — dis
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/pixiv-api
OpenAPI spec: https://www.oanor.com/api/pixiv-api/openapi.json