Skip to main content

​
Schedule Methods

Schedule methods allow you to set up automated, recurring scrapes. See the MeterClient reference for complete method signatures.

​
Quick reference

MethodDescription
create_schedule()Create a recurring schedule
list_schedules()List all schedules
update_schedule()Modify schedule settings
delete_schedule()Delete a schedule
get_schedule_changes()Get unseen changes (pull-based)
regenerate_webhook_secret()Regenerate webhook secret for a schedule

​
Common workflows

​
Interval-based monitoring

from meter_sdk import MeterClient

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

# Run every hour
schedule = client.create_schedule(
    strategy_id="550e8400-e29b-41d4-a716-446655440000",
    url="https://example.com/products",
    interval_seconds=3600
)

print(f"Schedule created: {schedule['schedule_id']}")
print(f"Next run: {schedule['next_run_at']}")

​
Cron-based monitoring

# Daily at 9 AM
schedule = client.create_schedule(
    strategy_id="550e8400-e29b-41d4-a716-446655440000",
    url="https://example.com/products",
    cron_expression="0 9 * * *"
)

# Weekdays at 8 AM
schedule = client.create_schedule(
    strategy_id="550e8400-e29b-41d4-a716-446655440000",
    url="https://example.com/products",
    cron_expression="0 8 * * 1-5"
)

​
With webhook

schedule = client.create_schedule(
    strategy_id="550e8400-e29b-41d4-a716-446655440000",
    url="https://example.com/products",
    interval_seconds=3600,
    webhook_url="https://your-app.com/webhooks/meter"
)

# Store the auto-generated webhook secret (shown only once)
print(f"Webhook secret: {schedule.get('webhook_secret')}")

​
With webhook metadata and type

Attach custom metadata to every webhook payload and specify the delivery format: 
# Standard webhook with metadata
schedule = client.create_schedule(
    strategy_id="550e8400-e29b-41d4-a716-446655440000",
    url="https://example.com/products",
    interval_seconds=3600,
    webhook_url="https://your-app.com/webhooks/meter",
    webhook_metadata={"project": "price-monitor", "env": "prod"},
    webhook_type="standard"
)

# Slack webhook (auto-detected from URL)
schedule = client.create_schedule(
    strategy_id="550e8400-e29b-41d4-a716-446655440000",
    url="https://example.com/products",
    interval_seconds=3600,
    webhook_url="https://hooks.slack.com/services/T.../B.../xxx"
)

​
Regenerate webhook secret

If a webhook secret is compromised, regenerate it: 
result = client.regenerate_webhook_secret(schedule_id)
new_secret = result["webhook_secret"]
# Update your webhook handler with the new secret

​
With API parameters

For API-based strategies, set default parameters for all scheduled runs: 
schedule = client.create_schedule(
    strategy_id="550e8400-e29b-41d4-a716-446655440000",
    url="https://example.com/api/listings",
    interval_seconds=3600,
    parameters={
        "category": "electronics",
        "sort": "newest",
        "limit": 100
    }
)

# Update parameters later
client.update_schedule(
    schedule['schedule_id'],
    parameters={"category": "clothing", "limit": 200}
)

​
Multiple URLs

Monitor multiple pages on a single schedule: 
schedule = client.create_schedule(
    strategy_id="550e8400-e29b-41d4-a716-446655440000",
    urls=[
        "https://example.com/products/electronics",
        "https://example.com/products/clothing",
        "https://example.com/products/home"
    ],
    interval_seconds=3600
)

​
Pull-based change detection

import time

while True:
    # Check for changes every hour
    changes = client.get_schedule_changes(
        schedule_id="880e8400-e29b-41d4-a716-446655440000",
        mark_seen=True
    )

    if changes['count'] > 0:
        print(f"Processing {changes['count']} changes")
        for change in changes['changes']:
            # Process change['results']
            update_database(change['results'])

    time.sleep(3600)

​
Keyword filtering

Filter results to only include items matching specific keywords: 
# Filter for articles mentioning both "jfk" AND "tariff"
changes = client.get_schedule_changes(
    schedule_id="880e8400-e29b-41d4-a716-446655440000",
    filter="+jfk +tariff"
)

# Filter for articles mentioning "jfk" OR "elon"
changes = client.get_schedule_changes(
    schedule_id="880e8400-e29b-41d4-a716-446655440000",
    filter="jfk elon"
)

# Filter for articles with "jfk" but NOT "biden"
changes = client.get_schedule_changes(
    schedule_id="880e8400-e29b-41d4-a716-446655440000",
    filter="+jfk -biden"
)

# Exact phrase matching
changes = client.get_schedule_changes(
    schedule_id="880e8400-e29b-41d4-a716-446655440000",
    filter='"elon musk"'
)
The filter applies to individual items within results. Only matching items are returned. Jobs with zero matching items are excluded entirely.

​
Manage schedules

# List all schedules
schedules = client.list_schedules()

for schedule in schedules:
    print(f"{schedule['schedule_id']}: {schedule['enabled']}")

# Disable temporarily
client.update_schedule(schedule_id, enabled=False)

# Change interval
client.update_schedule(schedule_id, interval_seconds=7200)

# Delete
client.delete_schedule(schedule_id)

​
Pause and resume

# Pause during maintenance
client.update_schedule(schedule_id, enabled=False)

# Do maintenance work
regenerate_strategy()

# Resume
client.update_schedule(schedule_id, enabled=True)

​
See also

Full Method Reference

Complete parameter and return type documentation

Schedules Concept

Understand schedule types and timing

REST API

Schedule endpoints in the REST API

Pull-Based Monitoring

Guide to using get_schedule_changes()

​
Need help?

Email me at mckinnon@meter.sh