Skip to main content

Parler API interface for Python

This UNOFFICIAL library designed to programatically fetch data from parler.com

IMPORTANT ANNOUNCEMENT:

This library supports the new (as of 2022-02-06) Parler open-api / logged-in endpoints. Both logged in and guest modes are supported.

Show is back on! Now this library supports the even newer (as of 2022-10-21) Parler /v0/ and /v0/public endpoints. Same caveats, both logged in and guest modes are supported

To do list:

  • Implement unfinished authed functions
  • Rework experiments
  • Have a github action (several!) to archive posts, run analysises, etc..
  • Testing, testing
  • Publish to pypi

Authentication:

There are two modes of using the API. Authenticated and Guest.

Authentication is done by initializing the Parler class, importing Parler.with_auth and initializing an AuthSession with your credentials.

from Parler import with_auth as authed

au = authed.AuthSession(debug=False)
au.is_logged_in # ==> False
au.login(
	identifier=os.getenv("email"),
	password=os.getenv("password")
)

au.is_logged_in # ==> True

Here is a chart of how the functions are "loginwalled" or not.

Function Description API Type needed
.profile() Get information from a specified username Guest
.discover_feed() Get discovery feed from initial page (kinda like suggested posts for first time users) Guest
.user_feed() Get Parleys and echoes from a specified username Guest
.trending() Get trending posts (today / top) Guest
.feed() Get feed Authenticated
.users() Search for users Authenticated
.hashtags() Search for hashtags Authenticated
.following() Get following profiles from specified username Authenticated
.comments() Get comments from a specified post ID Authenticated
.follow_user() Follow a specified username Authenticated

Installation

From pypi:

pip install parler-api

Clone and run locally:

If using pipenv:

pipenv install
pipenv shell

If using pip:

pip install -r requirements.txt

Experiments:

Collected the suggested hashtags for a 9 hour period, data here

Other experiments available as well.

Contributing:

Feel free to improve the code, submit your experiments and sample code or fix bugs. Before submitting a PR, run pep8 linter on your code.

Donate:

If you found this package useful, consider donating.

Disclaimer:

I am in now way affiliated with Parler, it's subsidiaries or any entity related to the company. I am not responsible for what you do with this Python package.

2009/24/EC Art 5:

The person having a right to use a copy of a computer program shall be entitled, without the authorisation of the rightholder, to observe, study or test the functioning of the program in order to determine the ideas and principles which underlie any element of the program if he does so while performing any of the acts of loading, displaying, running, transmitting or storing the program which he is entitled to do.

Metadata

Release files for parler-api 2.7.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for parler-api 2.7.0
File Size Uploaded Provenance Actions
parler-api-2.7.0.tar.gz 8.6 kB Without provenance Details for parler-api-2.7.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for parler-api 2.7.0
File Interpreter ABI Platform Actions
parler_api-2.7.0-py3-none-any.whl Python 3 none any Details for parler_api-2.7.0-py3-none-any.whl

Total release size: 19.0 kB

Release files / parler-api-2.7.0.tar.gz

Download URL parler-api-2.7.0.tar.gz
Size 8.6 kB
Tags Source
SHA-256 checksum
How to use checksums
18781bbec2d7b2f1caa2016dfbb235bf073c93f3fd804f8c02c749c944ffd8b9
BLAKE2b-256 checksum
How to use checksums
df69be5dce62a15e5b7b8ce923ed4dc279e2163a4a9820c7fcb56ed6b589a940
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.1 CPython/3.9.15

Release files / parler_api-2.7.0-py3-none-any.whl

Download URL parler_api-2.7.0-py3-none-any.whl
Size 10.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f3c132a31b7a47682278576a3f88ce325faaef3263d47160c159f16898b687b8
BLAKE2b-256 checksum
How to use checksums
1b33ae0206c1ad8089d7bdfb6b51c738bba326eb4e521fe685ef4d5d8b66b03a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.1 CPython/3.9.15

Security for parler-api 2.7.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page