Metadata-Version: 2.5
Name: sdashapis-sdk
Version: 1.0.0
Summary: Official Python SDK for SdashAPI - Access Nigerian past exam questions (UTME, WAEC, NECO, Post-UTME).
Project-URL: Homepage, https://sdashapi.com
Project-URL: Documentation, https://sdashapi.com/docs
Author-email: SdashAPI <support@sdashapi.com>
License: MIT
Keywords: api,jamb,neco,nigeria,past-questions,post-utme,sdashapi,sdk,waec
Requires-Python: >=3.7
Requires-Dist: requests>=2.25.0
Description-Content-Type: text/markdown

# SdashAPI Python SDK

Official Python SDK for [SdashAPI](https://sdashapi.com/). Give your developers instant access to thousands of past exam questions for UTME, WAEC, NECO and Post-UTME — with answers, solutions, and a simple REST API.

## Installation

```bash
pip install sdashapis-sdk
```

## Quick Start

```python
from sdashapis import SdashAPI, SdashAPIError

# 1. Initialize the client
api = SdashAPI(api_key="YOUR_ACCESS_TOKEN") # Get your token from sdashapi.com/dashboard

def main():
    try:
        # 2. Fetch a random chemistry UTME question from 2022
        question = api.get_questions(
            subject='chemistry',
            type='utme',
            year=2022
        )
        
        print(question)
        
        # 3. Fetch 10 random questions
        questions_list = api.get_questions(limit=10)
        print(f"Fetched {len(questions_list)} questions")
        
    except SdashAPIError as e:
        print(f"API Error {e.status}: {e.message}")

if __name__ == "__main__":
    main()
```

## Endpoints Supported

- `get_questions(**kwargs)`: Fetch past questions with filters (subject, type, year, id, limit).
- `get_subjects()`: List available subjects.
- `get_exams()`: List supported exams.
- `get_years()`: List available years.
- `report_question(question_id, report_type, message)`: Report issues with questions.

## License
MIT
