Skip to main content

EasyDown API client for Python

A small synchronous client for applications that import a public, single-post media URL into a backend. It submits that URL to EasyDown, validates the response, and gives your application normalized media or the separate platform data. It does not download files, scrape profiles, or bypass access controls.

This is a first-party client maintained for EasyDown. The Python library is open source under ISC; the hosted developer API is a paid, credit-based service. API access requires an account, a Bearer token, and available credits. New registrations receive 10 trial credits. The free browser downloader is a separate product. Parse costs depend on the platform and processing outcome; do not assume every failure is free or that retrying cannot incur another charge.

The EasyDown API reference explains supported platforms, authentication, current billing rules, and response fields.

Install and make one request

Requires Python 3.10 or newer, with no third-party runtime dependencies. After the initial version is published to PyPI, install it with:

python -m pip install easydown-api-client

Keep the token in a server environment variable. Do not place it in frontend code, notebooks shared with others, committed examples, or logs. Set PUBLIC_POST_URL to a supported public single-post URL that you are authorized to process.

import os
from easydown_api_client import EasyDownClient, EasyDownError

client = EasyDownClient(os.environ["EASYDOWN_API_TOKEN"], timeout=60)

try:
    media = client.parse(os.environ["PUBLIC_POST_URL"])
except EasyDownError as error:
    # These fields omit the token, submitted URL and raw response body.
    print(error.kind, error.http_status, error.code)
else:
    print(media["platform"], len(media["images"]), len(media["videos"]))

parse() calls POST /api/v1/parse with a JSON url field and returns the normalized object in data directly. duration is passed through without assigning a unit. Images preserve response order. Multiple video entries may represent renditions of one clip; their count is not a post count or credit count.

Keep platform-specific data separate

Use a platform endpoint when your application also needs the upstream-shaped fields. This returns a different envelope from the unified endpoint:

result = client.parse_platform("tiktok", os.environ["PUBLIC_POST_URL"])
media = result["media"]
platform_data = result["platformData"]
platform_data_version = result["platformDataVersion"]

The client leaves platformData intact and verifies that the normalized media matches the requested platform. Your code should check the version and optional fields before reading platform-specific values.

Accepted endpoint names are tiktok, douyin, toutiao, youtube, twitter, instagram, threads, xiaohongshu, bilibili, kuaishou, and weibo. X uses twitter; RedNote uses xiaohongshu. Support for a platform does not promise that every post is available. Private posts, account/profile crawling and live streams are outside this client's documented use case.

Failure handling and credentials

  • kind="http": an unsuccessful HTTP response, including redirects, 401 or 429.
  • kind="api": an API error envelope. A recognized documented API error code is available when it is returned in an otherwise successful HTTP response.
  • kind="invalid_response": malformed JSON, an oversized response, or missing documented media fields.
  • kind="timeout" or "network": transport failure. Neither establishes whether the server processed or charged a request.

There are no automatic retries. Decide retry policy in your application after checking request outcome and the current billing reference. Responses larger than 8 MiB are rejected. The default 60-second timeout applies to socket operations; it is not a total wall-clock deadline or server-side guarantee.

The default transport only sends the Bearer token to the fixed HTTPS API host, does not follow redirects, and does not attach cookies. Returned media URLs and any required media headers are data for your application; treat them as sensitive and potentially short-lived. This client never fetches those URLs automatically. Do not expose a server token through client-side apps or untrusted proxy code.

Offline testing

python -m unittest -v test_client

Tests use mock transports and mocked HTTP responses, not a real API token or paid request. They cover request shape, both response envelopes, carousel order, redirect refusal, malformed media, status errors, timeout behavior, and safe error messages. A custom transport(request, timeout) can return HttpResponse for your own offline tests; it receives the Authorization header, so use only trusted code. No network request happens on import or construction.

Version 0.1.0 is an initial release. Code and documentation were prepared with AI assistance and checked against the published API contract. Offline tests are not a live-service reliability claim.

Metadata

Release files for easydown-api-client 0.1.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 easydown-api-client 0.1.0
File Size Uploaded Provenance Actions
easydown_api_client-0.1.0.tar.gz 8.9 kB With provenance Details for easydown_api_client-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for easydown-api-client 0.1.0
File Interpreter ABI Platform Actions
easydown_api_client-0.1.0-py3-none-any.whl Python 3 none any Details for easydown_api_client-0.1.0-py3-none-any.whl

Total release size: 16.0 kB

Release files / easydown_api_client-0.1.0.tar.gz

Download URL easydown_api_client-0.1.0.tar.gz
Size 8.9 kB
Tags Source
SHA-256 checksum
How to use checksums
6dde421afbd4306267c902bb3e086ecbb1c1dd81849cd9f2b88d473e3766e52f
BLAKE2b-256 checksum
How to use checksums
b21a2e263bed3abbdfb41fb45ab72263ba4273822c28a8ad27424febf6cfecf5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 14, 2026.

Transparency log

Release files / easydown_api_client-0.1.0-py3-none-any.whl

Download URL easydown_api_client-0.1.0-py3-none-any.whl
Size 7.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1068f6c7084da777c534db1c2919ec743ef52794298987baf83c6b54677202b8
BLAKE2b-256 checksum
How to use checksums
961498afc6bb25616bf3fcd9f63148bd50e805732dcd8eeeb751c13cb3eeca91
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 14, 2026.

Transparency log

Security for easydown-api-client 0.1.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.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for easydown_api_client-0.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 14, 2026.

Transparency log

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.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files Full provenance

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