Submit Batch

Submit a batch of places for enrichment processing

The batch_id field is optional. If not provided, a new UUID will be generated. If an existing batch ID is provided, the new jobs will be added to that batch, and any existing jobs with the same place_id will be updated.

Prefilled Data Feature:

You can include prefilled attribute data using the prefilled_data field in each job. This allows you to insert known attribute values directly into the database without requiring AI enrichment. This feature is only available when kick_off_jobs_now is False.

Supported prefilled attributes:

• phoneNumbers: Phone number information
• websites: Website URL and validation data
• closed_permanently: Business closure status
• openingHours: Operating hours information
• categories: Business categories
• Custom attributes: Any custom attribute key

Example prefilled data formats:

{
    "phoneNumbers": "+12122555803",  // Simple string format
    // OR complex format:
    "phoneNumbers": {
        "phone_number": "+12122555803",
        "additional_numbers": [
            {"phone_type": "whatsapp", "phone_number": "+12122555804"}
        ],
        "reasoning": "Found on official website",
        "confidence": "HIGH"
    },
    "websites": "https://example.com",  // Simple string format
    // OR complex format:
    "websites": {
        "url": "https://example.com",
        "has_website": true,
        "reasoning": "Official business website",
        "confidence": "NAP"
    },
    "closed_permanently": false,  // Simple boolean format
    // OR complex format:
    "closed_permanently": {
        "is_permanently_closed": false,
        "reasoning": "Business is currently operating",
        "confidence": "HIGH"
    }
}