A library for the Pixiv API.
Project description
A documented, idiomatic, and tested wrapper library around Pixiv’s App API.
Supports Python versions 3.6+.
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 full documentation at https://pixiv-api.readthedocs.io.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for pixiv_api-1.0.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0ce0765883f816fd575127e007c2645e5ada92084549500931b22565c31b2191 |
|
MD5 | 06cd7293a12fae1b9fd6fb5f47a25475 |
|
BLAKE2b-256 | eaffac8a445008ea1ed0c12e6016bb4448945388c47a45f9573e8863d7004661 |