PyWuzzuf¶

Async Python client for the Wuzzuf job search API.

PyWuzzuf is a type-safe library for programmatic job search and company data extraction. Built on curl_cffi, it provides browser impersonation and resilient pagination to facilitate data collection at scale.

Quick Example¶

Get started immediately with the asynchronous client. This example demonstrates searching, safe data access, and basic quality checking.

import asyncio
from pywuzzuf import WuzzufClient

async def main():
    async with WuzzufClient() as client:
        # 1. Search for recent Python jobs
        result = await client.jobs.search("Python Developer").limit(5).all()

        print(f"Found {len(result.items)} jobs.\n")

        for job in result.items:
            # 2. Safe attribute access
            title = job.attributes.title
            company = job.company.attributes.name if job.company else "Unknown"

            print(f"[{job.id}] {title}")
            print(f"  Company: {company}")

            # 3. Check data quality
            if job.quality.has_anomalies:
                print(f"  ⚠️  Quality Warning: {job.quality.missing_fields}")

if __name__ == "__main__":
    asyncio.run(main())

Expected Output:

Found 5 jobs.

[12345] Senior Python Developer
  Company: TechCorp
[67890] Backend Engineer
  Company: StartupX
  ⚠️  Quality Warning: ['company']
...

Key Features¶

• Browser Impersonation: Uses curl_cffi to mimic real browser TLS fingerprints, bypassing basic bot detection.
• Resilient Pagination: Automatic retries with exponential back-off and granular flow control signals.
• Data Quality Reports: Built-in auditing of API responses to detect missing or malformed fields.
• Type Safety: Fully typed with Pydantic models for excellent IDE support and validation.