Skip to main content

​
1. Enrich your place data

If you already have place data, you can enrich it with over 40 attributes using Reprompt
Don’t have place data yet? You can generate your own dataset using our Find Places tool or experiment with csv data and custom AI attributes in our Workbooks.

​
2. Your First Live Enrichment

Let’s enrich a single place with basic information. The inputs object requires a place name along with either coordinates (latitude/longitude) or an address. 
curl -X POST \
  'https://reprompt--reprompt-fastapi-fastapi-app.us-west.modal.run/{your_org_slug}/place_enrichment/enrich' \
  -H 'Authorization: Bearer {YOUR_API_KEY}' \
  -H 'Content-Type: application/json' \
  -d '{
    "inputs": {
      "place_id": "my_place_123",
      "name": "Joe'\''s Pizza",
      "latitude": 40.7359,
      "longitude": -73.9911,
      "full_address": "7 Carmine St, New York, NY 10014"
    },
    "attributes": ["websites", "phoneNumbers", "openingHours", "closed_permanently"]
  }'
Replace {your_org_slug} with your actual organization slug. The API key variable will be automatically populated.
Include a place_id: We recommend providing your own stable identifier (like your database ID) as place_id. This makes it easy to join enriched results back to your data. If not provided, we’ll auto-generate a UUID for you.

​
Input Flexibility

The inputs object accepts different combinations: Option 1: Name + Coordinates 
{
  "place_id": "my_place_123",
  "name": "Joes Pizza",
  "latitude": 40.7359,
  "longitude": -73.9911
}
Option 2: Name + Address 
{
  "place_id": "my_place_123",
  "name": "Joes Pizza",
  "full_address": "7 Carmine St, New York, NY 10014"
}
Option 3: Name + Address + Coordinates (Most accurate) 
{
  "place_id": "my_place_123",
  "name": "Joes Pizza",
  "latitude": 40.7359,
  "longitude": -73.9911,
  "full_address": "7 Carmine St, New York, NY 10014"
}

​
3. Understanding the Response

The API will return enriched data about the place, including your place_id for easy joining: 
{
  "place_id": "my_place_123",
  "outputs": {
    "website": "https://www.joespizzanyc.com",
    "phone": "+12122555803",
    "social_profiles": {
      "instagram": "joespizzanyc",
      "facebook": "joespizzanyc"
    },
    "is_permanently_closed": false,
    "price_tier": "$$"
  },
  "job_metadata": {
    "attribute_status": {
      "website": "RUN",
      "phone": "RUN",
      "address": "RUN",
      "name": "RUN"
    }
  }
}

​
4. Available Attributes

Specify exactly which attributes you want to enrich using the attributes array. Common attributes include:
AttributeDescription
websitesBusiness website URL
phoneNumbersPhone number
social_profilesSocial media handles (Instagram, Facebook, etc.)
closed_permanentlyWhether the business is permanently closed
price_tierPrice range (e.g., $, $$, $$$)
categoriesType of cuisine (for restaurants)
openingHoursOpening hours
namesAlternative names for the business
addressAddress
You can see the entire list of attributes by calling the Enrichment Attributes endpoint.

​
5. Batch Processing

For multiple places, use batch processing for asynchronous enrichment: 
{
  "batch_name": "NYC Restaurants Batch",
  "attributes": ["websites", "phoneNumbers", "openingHours", "closed_permanently"],
  "jobs": [
    {
      "place_id": "my_db_id_456",
      "inputs": {
        "name": "Joes Pizza",
        "latitude": 40.7359,
        "longitude": -73.9911,
        "full_address": "7 Carmine St, New York, NY 10014"
      }
    },
    {
      "place_id": "my_db_id_789", 
      "inputs": {
        "name": "Tony's Deli",
        "latitude": 40.7505,
        "longitude": -73.9934,
        "full_address": "123 Main St, New York, NY 10001"
      }
    }
  ]
}
Submit this to the /place_enrichment/batches endpoint, then track progress and retrieve results using the returned batch ID. Each result will include the place_id you provided for easy matching back to your database. Learn more in our Batch Processing Guide.

​
6. Next Steps

Now that you’ve made your first API call, explore more:
⌘I