api-ulp

A simple Python client for the ULP search API.

Installation

pip install api-ulp

Requirements

• Python 3.7+
• requests >= 2.20.0

Quick Start

from api_ulp import ApiUlp

client = ApiUlp(api_key="YOUR_API_KEY")
results = client.search(query="hello world", limit=10)
print(results)

Usage

Initialize the client

from api_ulp import ApiUlp

client = ApiUlp(api_key="YOUR_API_KEY")

search(query, limit)

Performs a POST search request against the ULP API.

results = client.search(query="search_target", limit=100)
print(results)

Returns: dict — Parsed JSON response from the API.

Error Handling

import requests
from api_ulp import ApiUlp

client = ApiUlp(api_key="YOUR_API_KEY")

try:
    results = client.search(query="hello", limit=50)
    print(results)
except ValueError as e:
    # Bad arguments (empty query, invalid limit, missing key)
    print(f"Invalid input: {e}")
except requests.exceptions.HTTPError as e:
    # API returned 4xx or 5xx
    print(f"API error: {e}")
except requests.exceptions.ConnectionError as e:
    # Could not reach the server
    print(f"Connection error: {e}")
except requests.exceptions.Timeout as e:
    # Request took longer than 30 seconds
    print(f"Timeout: {e}")

API Details

Raw request equivalent

import requests

url = "https://api-1-wi9u.onrender.com/api/search"
headers = {"X-API-Key": "YOUR_KEY", "Content-Type": "application/json"}
data = {"query": "search_target", "limit": 100}

response = requests.post(url, headers=headers, json=data)
print(response.json())

License

MIT