Pixiv Artwork Scraper

Pixiv Artwork Scraper — Extract public Pixiv artwork details by ID or URL. Get descriptions, tags, authors, visible engagement and image links, with each artwork in one row. Add supported inputs and start a run to get structured public data without providing a Pixiv account.

Export a selected public Pixiv artwork's description, tags, creator details and image links. Keep the available metadata together in one reference record.

At a glance	Details
📥 Input	Positive Pixiv artwork IDs or public /artworks/ID URLs.
📤 Output	One artwork per success row, with source input retained
📄 Pagination	One lookup per unique input; nested values stay in that result row.
🔐 Login required	No
⚡ Processing	Up to 5 HTTP requests concurrently with automatic retries
💾 Delivery	One Apify dataset view, useful flat columns and complete nested JSON

What the pixiv artwork scraper collects 📊

Extract public Pixiv artwork details by ID or URL. Get descriptions, tags, authors, visible engagement and image links, with each artwork in one row.

Data can include:

• Source identity and public links
• Available id, url, title, description, type code, author id, author name, author url
• Original input retained with every result
• One consistent success or failed record format

How to collect artworks from Pixiv 🚀

1. Enter one or more supported inputs in inputList.
2. Review the supported input format.
3. Start the Actor.
4. Open the Artworks dataset view and review the individual records.
5. Export the dataset or retrieve it from your application.

{
  "inputList": [
    "149440738"
  ]
}

One lookup per unique input; nested values stay in that result row.

Pixiv artworks data and complete output 📦

Field	Type	Meaning
status	string	Result status: success or failed.
input	string	Original submitted input.
id	string or null	Stable ID of the result entity, retained as a string.
url	string or null	Public source URL of the result entity.
title	string or null	Public title supplied by the source.
description	string or null	Public description in plain text when exposed by this endpoint.
type	string or null	Type when exposed by the public response.
type_code	integer or null	Pixiv artwork type: 0 illustration, 1 manga, 2 ugoira.
author_id	string or null	Author id supplied by the source.
author_name	string or null	Author name when exposed by the public response.
author_url	string or null	Available author URL.
author_avatar_url	string or null	Available author avatar URL.
thumbnail_url	string or null	Available thumbnail URL.
width	integer or null	Image width in pixels when supplied.
height	integer or null	Image height in pixels when supplied.
image_count	integer or null	Number of images in the artwork, not the scraper pagination budget.
tags	array or null	Tags supplied by the website, kept in the parent row.
created_at	string or null	Source publication or comment time. Comment timestamps retain the source format and do not invent a timezone.
updated_at	string or null	Source update timestamp when available.
ai_type	integer or null	AI classification code supplied by Pixiv; no independent content classification is performed.
is_original	boolean or null	Is original when exposed by the public response.
is_masked	boolean or null	Whether the source masks this card; absent values remain null.
restriction	integer or null	Restriction when exposed by the public response.
age_restriction	integer or null	Age restriction when exposed by the public response.
description_html	string or null	Public description in the HTML format returned by Pixiv.
author_account	string or null	Author account when exposed by the public response.
view_count	integer or null	View count supplied by the source; absent values remain null.
like_count	integer or null	Like count supplied by the source; absent values remain null.
bookmark_count	integer or null	Bookmark count supplied by the source; absent values remain null.
comment_count	integer or null	Comment count supplied by the source; absent values remain null.
comments_disabled	boolean or null	Comments disabled when exposed by the public response.
images	array or null	Image renditions and dimensions inside this artwork row. Media files are not downloaded.
images[].page	integer or null	Page when exposed by the public response.
images[].width	integer or null	Image width in pixels when supplied.
images[].height	integer or null	Image height in pixels when supplied.
images[].original_url	string or null	Available original URL.
images[].regular_url	string or null	Available regular URL.
images[].small_url	string or null	Available small URL.
images[].thumbnail_url	string or null	Available thumbnail URL.

Nested arrays and media references stay in their parent record. Downloading source media files is not part of this Actor.

Every top-level output field appears in these complete examples. The success example is normalized from a public response. Long strings and arrays are shortened here; the Actor keeps the complete available values. Values are a snapshot and can change. Nested arrays remain inside their parent result.

Representative success result with every output field (long text and arrays shortened for readability):

{
  "status": "success",
  "input": "149440738",
  "id": "149440738",
  "url": "https://www.pixiv.net/en/artworks/149440738",
  "title": "髪下ろし志摩リンちゃん",
  "description": "",
  "type": "illustration",
  "type_code": 0,
  "author_id": "11211325",
  "author_name": "CORE",
  "author_url": "https://www.pixiv.net/en/users/11211325",
  "author_avatar_url": null,
  "thumbnail_url": "https://i.pximg.net/c/540x540_70/img-master/img/2026/09/09/00/02/05/149440738_p0_master1200.jpg",
  "width": 991,
  "height": 1352,
  "image_count": 1,
  "tags": [
    "ゆるキャン△",
    "志摩リン",
    "女の子"
  ],
  "created_at": "2026-09-08T15:02:00+00:00",
  "updated_at": "2026-09-08T15:02:00+00:00",
  "ai_type": 1,
  "is_original": false,
  "is_masked": null,
  "restriction": 0,
  "age_restriction": 0,
  "description_html": "",
  "author_account": "tedpad",
  "view_count": 16000,
  "like_count": 2461,
  "bookmark_count": 2988,
  "comment_count": 13,
  "comments_disabled": false,
  "images": [
    {
      "page": 1,
      "width": 991,
      "height": 1352,
      "original_url": "https://i.pximg.net/img-original/img/2026/09/09/00/02/05/149440738_p0.png",
      "regular_url": "https://i.pximg.net/img-master/img/2026/09/09/00/02/05/149440738_p0_master1200.jpg",
      "small_url": "https://i.pximg.net/c/540x540_70/img-master/img/2026/09/09/00/02/05/149440738_p0_master1200.jpg",
      "thumbnail_url": "https://i.pximg.net/c/128x128/img-master/img/2026/09/09/00/02/05/149440738_p0_square1200.jpg"
    }
  ]
}

Complete failed result:

{
  "status": "failed",
  "input": "invalid input",
  "id": null,
  "url": null,
  "title": null,
  "description": null,
  "type": null,
  "type_code": null,
  "author_id": null,
  "author_name": null,
  "author_url": null,
  "author_avatar_url": null,
  "thumbnail_url": null,
  "width": null,
  "height": null,
  "image_count": null,
  "tags": null,
  "created_at": null,
  "updated_at": null,
  "ai_type": null,
  "is_original": null,
  "is_masked": null,
  "restriction": null,
  "age_restriction": null,
  "description_html": null,
  "author_account": null,
  "view_count": null,
  "like_count": null,
  "bookmark_count": null,
  "comment_count": null,
  "comments_disabled": null,
  "images": null
}

A failed row preserves input, sets status to failed, and sets every other top-level field to null. The run log records the reason. Optional successful fields can be null or empty when Pixiv does not supply them. Object fields are exposed through useful columns in the single Artworks view; arrays are not expanded into extra result rows.

Input requirements and pagination settings ⚙️

Parameter	Type	Required	Default	Rules
inputList	array of strings	Yes	None	Positive Pixiv artwork IDs or public /artworks/ID URLs. At least 1 item.

Positive Pixiv artwork IDs or public /artworks/ID URLs.

Examples of supported inputs: 149440738.

Duplicate normalized inputs are processed once. Within the collection for one source input, repeated records are removed while distinct interactions or objects remain separate. The same object returned for different source inputs retains its source relationship.

There is no result-page setting. Each unique target is looked up individually, and nested fields remain within that result row.

Pixiv artworks use cases 🎯

Enrich a selected Pixiv artwork reference

Export a selected public Pixiv artwork's description, tags, creator details and image links. Keep the available metadata together in one reference record.

Compare visible metrics of Pixiv artworks

Collect selected public Pixiv artworks with view, like and bookmark counts. Compare the current visible metrics in your export; no historical trends are inferred.

Inventory images in a multi-image Pixiv artwork

Export a public multi-image Pixiv work with its description, tags and image URLs in one artwork row. Review image dimensions without downloading files.

Pricing and saved-result behavior 💰

Check the Actor’s Pricing tab for the active pricing model and current rate. Store settings can change, so this README does not claim a fixed price or runtime.

Under dataset-item pricing:

• Each successful result represents one artwork for its source input.
• An invalid or unavailable input, an input with no accessible results, or an exhausted request can produce a failed row.
• Retry attempts and supporting requests do not create extra dataset rows by themselves.
• Nested media, profile information and other arrays remain part of their parent row.
• A normal empty continuation after earlier successes creates no additional row.
• Saved failed rows are not assumed to be free; check their treatment in the active pricing configuration.

More inputs can produce more saved rows. Start with a small run and check actual usage before increasing the workload.

Pixiv artworks API 🔌

Replace $ACTOR_ID with the identifier shown in this Actor’s API tab and $APIFY_TOKEN with your Apify token.

curl -X POST "https://api.apify.com/v2/acts/$ACTOR_ID/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"inputList":["149440738"]}'

Download the dataset in JSON, CSV, Excel or other formats available in the Console, or retrieve it through the Apify API. Use schedules, webhooks and Apify integrations to connect results to Google Sheets, Make, Zapier, cloud storage or your own application. These connections are configured separately by the user.

Reliability, retries, and public-data limits ⚠️

Collection uses pure HTTP with up to five concurrent requests. Invalid syntax and confirmed missing, removed or unavailable targets stop without unnecessary retries. Temporary network or proxy failures, timeouts, blocking responses, malformed data, throttling and server errors allow up to five total attempts per request.

Successful earlier pages remain saved if a later request fails. A normal end after saved results is not retried. An input with no accessible results can receive a failed row; that alone does not prove that its underlying source does not exist. An exhausted later request can add a failed row while preserving previous output.

Returns image URLs, not downloaded files. Supports public general-audience works; restricted, login-only and unlisted works are skipped. Ugoira animation frames and protected playback are not collected. Image URLs may change.

Pixiv controls public availability, ranking and optional fields. Result counts can be affected by duplicates, removed content and changes during a run. A page budget is a collection limit, not a promise of exhaustive coverage.

An invalid string within a valid input list does not stop other inputs. Invalid overall configuration, such as a non-string list item or a wrong page-count type, exits before source requests. Startup failures, unavailable dataset storage or an unrecoverable result-save error can still stop the whole run. A failed save is not retried as a new scraping request.

Frequently asked questions ❓

What does one Pixiv Artwork Scraper result represent?

Each successful row represents one artwork. The source input is retained, and nested fields stay in the same row.

Which source limits apply?

Returns image URLs, not downloaded files. Supports public general-audience works; restricted, login-only and unlisted works are skipped. Ugoira animation frames and protected playback are not collected. Image URLs may change.

Does it download media files?

No. Where available, the Actor returns media URLs and metadata within the result row.

Does it require a Pixiv account or personal cookies?

No. You do not need to provide a Pixiv account, password or personal session cookie. Collection uses HTTP without opening a browser.

What happens to invalid or unavailable inputs?

Invalid individual inputs are recorded as failed without a source request. Confirmed missing or unavailable targets stop without unnecessary retries. Temporary failures allow up to five total attempts per request; other inputs and earlier saved results remain available.

Can I export results or run the same input again?

Yes. Export the default dataset or retrieve it through the Apify API. You can create an Apify schedule and connect completed runs to your own workflow.

Support, responsible use, and related actors 🛟

For a reproducible issue, use the Actor’s Issues tab and provide the run ID, approximate time, a safe public input, expected behavior and actual result. Include the mode or page budget when relevant. Never share access tokens, personal cookies or proxy credentials.

Use public data responsibly and follow applicable privacy, copyright, contractual and platform requirements before storing, analyzing or redistributing collected information.