Skip to main content
Change of provenance

The repository or configuration that created this release differ from a previous release. View details.

Jouyaar Python SDK

PyPI Python License: MIT

کلاینت رسمی پایتون برای API جویار، سرویس جست‌وجوی هوشمندی که نتایج ده‌ها ارائه‌دهندهٔ ایرانی را یک‌جا مقایسه می‌کند. با این SDK می‌توانید در پرواز، اقامتگاه، اتوبوس، قطار، کالا و اینترنت جست‌وجو کنید و ارزان‌ترین و بهترین گزینه‌ها را به‌صورت رتبه‌بندی‌شده دریافت کنید — بدون آن‌که لازم باشد سایت‌ها را یکی‌یکی بگردید. کافی است یک فراخوانی ساده در کد خود بزنید و نتیجه را بگیرید.

نصب

pip install jouyaar
# یا با uv:
uv add jouyaar

شروع سریع

from jouyaar import Jouyaar

client = Jouyaar(api_key="sk_live_…")   # یا متغیر محیطی JOUYAAR_API_KEY

res = client.search(category="flight", prompt="ارزان‌ترین پرواز تهران به مشهد فردا صبح")
for q in res.quotes:
    print(q.provider, f"{q.price_toman:,} تومان", q.plan_name)

امکانات

  • کلاینت هم‌زمان (Jouyaar) و ناهم‌زمان (AsyncJouyaar)
  • جست‌وجوی ساختاریافته (params=) یا با زبان طبیعی (prompt=)
  • خطاهای تایپ‌دار و retry خودکار با backoff روی خطاهای 429/5xx
  • کاملاً type-hinted، با مدل‌های Pydantic

مستندات

کلید API بگیرید و مستندات کامل را در developers.jouyaar.ir بخوانید.

با مجوز MIT منتشر شده است.

Metadata

Release files for jouyaar 0.1.2

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

Change of provenance

The repository or configuration that created these release files differ from that of a previous release.

We recommend inspecting the repository and configuration before proceeding. View details.

Source distribution (sdist)

Source distribution for jouyaar 0.1.2
File Size Uploaded Provenance Actions
jouyaar-0.1.2.tar.gz 37.0 kB With provenance Details for jouyaar-0.1.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for jouyaar 0.1.2
File Interpreter ABI Platform Actions
jouyaar-0.1.2-py3-none-any.whl Python 3 none any Details for jouyaar-0.1.2-py3-none-any.whl

Total release size: 46.6 kB

Release files / jouyaar-0.1.2.tar.gz

Change of provenance

This file belongs to a release with changed provenance: the repository or configuration that created the release files differ from that of a previous release.

We recommend inspecting the repository and configuration before proceeding. View details.

Download URL jouyaar-0.1.2.tar.gz
Size 37.0 kB
Tags Source
SHA-256 checksum
How to use checksums
10c59d4d22bcc2aa68c9238bbea8ed194d812ef0aed482f1d3dfa662ea7a785e
BLAKE2b-256 checksum
How to use checksums
385d57351236e2f7ca0b537790d06438a60218643aec33951f133617d1a0ce3c
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 Aug 26, 2026.

Transparency log

Release files / jouyaar-0.1.2-py3-none-any.whl

Change of provenance

This file belongs to a release with changed provenance: the repository or configuration that created the release files differ from that of a previous release.

We recommend inspecting the repository and configuration before proceeding. View details.

Download URL jouyaar-0.1.2-py3-none-any.whl
Size 9.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
dfb08b5cc1072a04b25dcc74f4a579483b3c9c8f8f9d5397508b5ebd92681ee0
BLAKE2b-256 checksum
How to use checksums
a90ebeac3c0164ad05eaa72999e131acd22a62f9e26f0282facac565bd741abf
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 Aug 26, 2026.

Transparency log

Security for jouyaar 0.1.2

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.

Change of provenance

The configuration that created this release differs from a previous release.

While this could reflect a routine change by the project maintainers, it may also indicate that the release files have been compromised.

Select from 2 files

Attestation for jouyaar-0.1.2.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 Aug 26, 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.

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