> ## Documentation Index
> Fetch the complete documentation index at: https://docs.meter.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Job Methods

> Execute scrapes and retrieve results

# Job Methods

Job methods allow you to execute scrapes, check status, and retrieve results. See the [MeterClient reference](/api-reference/python/client#job-methods) for complete method signatures.

## Quick reference

| Method                   | Description                          |
| ------------------------ | ------------------------------------ |
| `create_job()`           | Create a new scrape job (async)      |
| `execute_job()`          | Create and run a job synchronously   |
| `get_job()`              | Get job status and results           |
| `wait_for_job()`         | Wait for job completion with polling |
| `list_jobs()`            | List jobs with filtering             |
| `compare_jobs()`         | Compare two jobs for changes         |
| `get_strategy_history()` | Get timeline of jobs for a strategy  |

## Common workflows

### Create and wait

```python theme={null}
from meter_sdk import MeterClient

client = MeterClient(api_key="sk_live_...")

# Create job
job = client.create_job(
    strategy_id="550e8400-e29b-41d4-a716-446655440000",
    url="https://example.com/products"
)

# Wait for completion
completed = client.wait_for_job(job['job_id'], timeout=300)

# Process results
for item in completed['results']:
    print(item)
```

### Jobs with API parameters

For API-based strategies, override parameters at runtime:

```python theme={null}
# Override API parameters for this specific job
job = client.create_job(
    strategy_id="550e8400-e29b-41d4-a716-446655440000",
    url="https://example.com/api/jobs",
    parameters={
        "page": 2,
        "limit": 100,
        "category": "engineering",
        "location": "remote"
    }
)

completed = client.wait_for_job(job['job_id'])
print(f"Found {completed['item_count']} items")
```

### Batch jobs

Scrape multiple URLs in a single request:

```python theme={null}
# Create batch job for multiple URLs
job = client.create_job(
    strategy_id="550e8400-e29b-41d4-a716-446655440000",
    urls=[
        "https://example.com/products/1",
        "https://example.com/products/2",
        "https://example.com/products/3"
    ]
)

# Batch jobs return batch_id for tracking
print(f"Batch ID: {job['batch_id']}")
```

### Poll manually

```python theme={null}
import time

job = client.create_job(strategy_id, url)

while True:
    status = client.get_job(job['job_id'])

    if status['status'] == 'completed':
        print(f"Done! {status['item_count']} items")
        break
    elif status['status'] == 'failed':
        print(f"Failed: {status['error']}")
        break

    print(f"Status: {status['status']}")
    time.sleep(2)
```

### Compare for changes

```python theme={null}
# Get last two jobs
jobs = client.list_jobs(strategy_id=strategy_id, limit=2)

if len(jobs) >= 2:
    comparison = client.compare_jobs(jobs[0]['job_id'], jobs[1]['job_id'])

    if not comparison['content_hash_match']:
        print("Content has changed!")
    else:
        print("No changes detected")
```

### Monitor failures

```python theme={null}
# Check for recent failures
failed = client.list_jobs(
    strategy_id=strategy_id,
    status='failed',
    limit=5
)

if len(failed) > 0:
    print(f"Warning: {len(failed)} recent failures")
    for job in failed:
        print(f"  - {job['job_id']}: {job['error']}")
```

## See also

<CardGroup cols={2}>
  <Card title="Full Method Reference" icon="code" href="/api-reference/python/client#job-methods">
    Complete parameter and return type documentation
  </Card>

  <Card title="Jobs Concept" icon="gears" href="/concepts/jobs">
    Understand job lifecycle and status
  </Card>

  <Card title="REST API" icon="brackets-curly" href="/api-reference/rest/jobs">
    Job endpoints in the REST API
  </Card>

  <Card title="Change Detection" icon="code-compare" href="/concepts/change-detection">
    Learn about job comparison
  </Card>
</CardGroup>

## Need help?

Email me at [mckinnon@meter.sh](mailto:mckinnon@meter.sh)