A library for the Pixiv API.
Project description
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 True: for illust in response['illustrations']: illust.download(directory=directory, size=Size.ORIGINAL) if not response['next']: break response = client.fetch_user_illustrations( artist_id, offset=response['next'], )
Read the complete documentation at https://pixiv-api.readthedocs.io.
Changelog
v0.3.6
- Fix inability to login.
v0.3.5
- Fix issue with offset not working in fetch_illustrations_following.
v0.3.4
- Fix issue with Python 3.6 compatibility wrt. datetime module.
v0.3.3
- Fix arguments of Novel class instantiation.
v0.3.1
- Fix quickstart example documentation.
v0.3.0
- Update authentication in response to Pixiv’s changes.
v0.2.0
- 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.
Filename, size | File type | Python version | Upload date | Hashes |
---|---|---|---|---|
Filename, size pixiv_api-0.3.6-py3-none-any.whl (17.9 kB) | File type Wheel | Python version py3 | Upload date | Hashes View |
Filename, size pixiv-api-0.3.6.tar.gz (17.6 kB) | File type Source | Python version None | Upload date | Hashes View |
Hashes for pixiv_api-0.3.6-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | d988497bf9879c4b14c9a704f9a85cbff88d4487bba49b913efd9a83a8456b88 |
|
MD5 | 561f7b8980233fa6144168ec71752722 |
|
BLAKE2-256 | 1b22e5945fc072ae198f538a21d04fd94ed70559246dac067186b8ca0011c1a6 |