Getting Started with sieve

Quick Start Guide

Get started with sieve in just a few minutes:

1. Registration

Create an account to send requests - use app.usesieve.com or use the API:

registration_response = requests.post("https://api.usesieve.com/api/v1/auth/register", json={
    "email": email,
    "password": password,
    "user_type": user_type,
    "full_name": full_name
})

2. Authentication

Retrieve your authentication token

# Authenticate and get token
login_response = requests.post("https://api.usesieve.com/api/v1/auth/login", json={
    "email": email,
    "password": password
})

if login_response.status_code == 200:
    token = login_response.json()["token"]
    headers = {"Authorization": f"Bearer {token}", "Content-Type": "application/json"}
else:
    raise Exception("Authentication failed. Please check your credentials.")

3. Make Your First Query

Start querying your data with a simple example:

pdf_request_response = requests.post(f'{BASE_URL}/api/v1/process', headers=headers, json={
    "document_type": "pdf",
    "metadata": {
        "url": "https://www.cecafe.com.br/site/wp-content/uploads/2023/03/CECAFE-Monthly-Coffee-Report-JANUARY-2025.pdf",
        'data_points': ['Coffee export volume in most recent period (USD)']
    }
})
pdf_request_response.raise_for_status()
pdf_job_id = pdf_request_response.json().get("job_id")

Next Steps

  • Explore the API Reference for detailed endpoint documentation
  • Check out our Guides for best practices and tutorials
  • Follow our Blog for updates and tips

2024 Sieve Data Inc. All Rights Reserved.