Skip to main content

​
Overview

When you retrieve jobs from the batch endpoints, each job includes inputs, outputs, reasoning, and confidence scores. This guide explains those sections and provides a clean example.
  • Batch docs: Batch Processing
  • API reference: See the Place Enrichment Batch endpoints in the API reference for your version.

​
Sections

  • Inputs: What you submitted for a place. These are the fields we use to locate and enrich the place (e.g., name, coordinates, address, country).
  • Outputs: The enriched attributes we found, such as website, phone, opening_hours, categories, ratings, and review counts.
  • Reasoning: Brief, structured notes explaining how each attribute was determined (when available).
  • Confidence scores: A per-attribute confidence level reflecting the reliability of the result.

​
Example Response

The example below removes internal processing metadata and focuses on what your application will typically use. 
{
  "jobs": [
    {
      "place_id": "place_123",
      "status": "completed",
      "job_metadata": {
        "last_enriched": "2025-03-10T15:35:00Z",
        "country_code": "US",
        "attribute_status": {
          "website": "RUN",
          "phoneNumbers": "RUN",
          "openingHours": "RUN",
          "categories": "RUN"
        }
      },
      "inputs": {
        "id": "place_123",
        "name": "Joe's Pizza",
        "latitude": 40.7359,
        "longitude": -73.9911,
        "full_address": "7 Carmine St, New York, NY 10014",
        "country_code": "US"
      },
      "outputs": {
        "website": "https://www.joespizzanyc.com",
        "phone": null,
        "opening_hours": { "Monday": "11:00-23:00", "Tuesday": "11:00-23:00" },
        "categories": ["restaurant", "pizza"],
        "average_rating": 4.5,
        "review_count": 1200
      },
      "reasoning": {
        "websites": "Structured reasoning…",
        "phone": "No phone found on official site.",
        "opening_hours": "Structured reasoning…",
        "categories": "Structured reasoning…"
      },
      "confidence_scores": {
        "website": "HIGH",
        "phone": "LOW",
        "opening_hours": "MEDIUM",
        "categories": "HIGH"
      }
    }
  ],
  "total": 1,
  "limit": 10000,
  "offset": 0
}

​
Schemas

​
Confidence Scores

Confidence levels indicate how reliable a given attribute is: 
class ConfidenceScore(str, Enum):
    VERY_HIGH = "VERY_HIGH"
    HIGH = "HIGH"
    MEDIUM = "MEDIUM"
    LOW = "LOW"
    NONE = "NONE"
  • VERY_HIGH/HIGH: Safe to use directly
  • MEDIUM: Generally reliable; consider validation for critical use cases
  • LOW: Use with caution; may require manual review
  • NONE: No reliable data found

​
Attribute Statuses

Each attribute can include a processing status in job_metadata.attribute_status to indicate how enrichment proceeded: 
export type AttributeStatus = 'RUN' | 'RUN_CONDITION_FAILED' | 'NOT_RUN' | 'ERROR'
  • RUN: Enrichment was attempted (and completed); the attribute value may be present or null.
  • RUN_CONDITION_FAILED: Skipped because preconditions were not met (e.g., missing inputs or failing filters).
  • NOT_RUN: Not attempted (e.g., disabled, out of scope, or limits).
  • ERROR: Attempted but failed due to an error.
Attributes that commonly include a status entry include website, phoneNumbers, openingHours, and categories.

​
Next Steps

  • Submit a batch following the Batch Processing guide, then poll for completion and retrieve results.
  • Use the confidence_scores and attribute_status to drive QA workflows or manual review where needed.

​
Attribute Outputs

Types: string | number | list of strings Core Attributes closed_permanently attribute returns:
  • open_closed_status string
  • open_closed_status_confidence_score string
address attribute returns:
  • address string
  • address_localized string
categories attribute returns:
  • categories list of strings
coordinates attribute returns:
  • coordinates string
  • coordinates_distance number
websites attribute returns:
  • website string
email_address attribute returns:
  • email string
phoneNumbers attribute returns:
  • phone string
  • phone_additional list of strings
openingHours attribute returns:
  • opening_hours list of strings
  • opening_hours_grouped_by_hours list of strings
  • is_open_24h string
names attribute returns:
  • name string
  • multilingual_names list of strings
  • alt_name string
  • official_name string
  • brand_name string
Rich Attributes menu attribute returns:
  • menu_urls list of strings
  • menu_url_official string
  • menu_content string
  • menu_images list of strings
price_tier attribute returns:
  • price_tier string
  • average_price number
  • currency string
user_reviews attribute returns:
  • user_review_count number
  • user_average_rating number
  • user_wilson_score number
  • user_popularity number
  • user_review_summary string
  • user_summary string
approximate_user_reviews attribute returns:
  • approximate_review_count number
  • approximate_average_rating number
chain attribute returns:
  • chain_id string
  • chain_name string
  • chain_domains list of strings
  • alternative_names list of strings
  • chain_wikipedia_url string
  • number_of_locations number
  • logo_url string
reprompt_id attribute returns:
  • reprompt_id string
naics attribute returns:
  • naics_code string
  • naics_description string
merchant attribute returns:
  • merchant_category_code string
  • mcc_description string
  • merchant_category_group string
  • merchant_super_industry string
name_translations attribute returns:
  • name_translations list of strings
socialHandles attribute returns:
  • instagram string
  • facebook string
  • tiktok string
tiktok attribute returns:
  • tiktok: string
social_media_profile attribute returns:
  • facebook_followers: number
  • facebook_likes number
  • facebook_page_id string
  • facebook_bio string
website_traffic attribute returns:
  • website_traffic_monthly_visits number
parking_spaces attribute returns:
  • parking_spaces_total number
  • parking_spaces_street number
  • parking_spaces_shared number
  • parking_spaces_dedicated number
  • parking_spaces_image_url string
one_line_summary attribute returns:
  • one_line_summary string
geometry attribute returns:
  • buildings_geojson string
located_within attribute returns:
  • located_within_name string
  • located_within_type string
  • located_within_floor_or_level string
storefrontImages attribute returns:
  • storefront_images list of strings
place_existence attribute returns:
  • entity_type string
  • digital_footprint string
  • place_definition string
  • place_reality string
⌘I