Skip to main content

A library for the Pixiv API.

Project description

PyPI Pyversions Docs

A library for the Pixiv API. Uses Pixiv’s App API.

Install with:

$ pip install pixiv-api

Quickstart

To start making requests to the Pixiv API, instantiate a client object.

from pixivapi import Client

client = Client()

The client can be authenticated to Pixiv’s API in multiple ways. One is by logging in with a username and password:

client.login('username', 'password')

And another is with a refresh token.

client.authenticate('refresh_token')

Once authenticated, a refresh token can be saved for future authorizations.

refresh_token = client.refresh_token

After authenticating, the client can begin making requests to all of the Pixiv endpoints. For example, the following code block downloads an image from Pixiv.

from pathlib import Path
from pixivapi import Size

illustration = client.fetch_illustration(75523989)
illustration.download(
    directory=Path.home() / 'my_pixiv_images',
    size=Size.ORIGINAL,
)

And the next code block downloads all illustrations of an artist.

from pathlib import Path
from pixivapi import Size

artist_id = 2188232
directory = Path.home() / 'wlop'

response = client.fetch_user_illustrations(artist_id)
while response['next']:
    for illust in response['illustrations']:
        illust.download(directory=directory, size=Size.ORIGINAL)

    if response['next']:
        response = client.fetch_user_illustrations(
            artist_id,
            offset=response['next'],
        )

Read the complete documentation at https://pixiv-api.readthedocs.io.

Changelog

v0.2

  • Change Client.account from a dict to an Account model.
  • Remove None attributes from User that only applied to responses from Client.fetch_user and move them to a FullUser subclass.
  • Change return type of Client.fetch_user to a FullUser. No attributes were changed.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for pixiv-api, version 0.2.1
Filename, size & hash File type Python version Upload date
pixiv_api-0.2.1-py3-none-any.whl (17.4 kB) View hashes Wheel py3
pixiv-api-0.2.1.tar.gz (16.8 kB) View hashes Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page