> ## Documentation Index
> Fetch the complete documentation index at: https://syncupai-preview-find-places-workbooks.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Supercharge your place data with Reprompt

## 1. Enrich your place data

If you already have place data, you can enrich it with over 40 attributes using Reprompt

* [Live Enrichment API](#2-your-first-live-enrichment)
* [Batch Processing API](#5-batch-processing)

<Note>
  **Don't have place data yet?** You can generate your own dataset using our [Find Places tool](https://app.repromptai.com/find-places-v2) or experiment with csv data and custom AI attributes in our [Workbooks](https://app.repromptai.com/workbooks).
</Note>

***

## 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**.

<CodeGroup>
  ```bash cURL theme={null}
  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"]
    }'
  ```

  ```python Python theme={null}
  import requests

  url = "https://reprompt--reprompt-fastapi-fastapi-app.us-west.modal.run/{your_org_slug}/place_enrichment/enrich"
  headers = {
      "Authorization": "Bearer {YOUR_API_KEY}",
      "Content-Type": "application/json"
  }

  data = {
      "inputs": {
          "place_id": "my_place_123",
          "name": "Joes Pizza",
          "latitude": 40.7359,
          "longitude": -73.9911,
          "full_address": "7 Carmine St, New York, NY 10014"
      },
      "attributes": ["websites", "phoneNumbers", "openingHours", "closed_permanently"]
  }

  response = requests.post(url, headers=headers, json=data)
  result = response.json()
  print(result)
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://reprompt--reprompt-fastapi-fastapi-app.us-west.modal.run/{your_org_slug}/place_enrichment/enrich', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer {YOUR_API_KEY}',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      inputs: {
        place_id: "my_place_123",
        name: "Joes Pizza",
        latitude: 40.7359,
        longitude: -73.9911,
        full_address: "7 Carmine St, New York, NY 10014"
      },
      attributes: ["websites", "phoneNumbers", "openingHours", "closed_permanently"]
    })
  });

  const result = await response.json();
  console.log(result);
  ```
</CodeGroup>

Replace `{your_org_slug}` with your actual organization slug. The API key variable will be automatically populated.

<Tip>
  **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.
</Tip>

### Input Flexibility

The `inputs` object accepts different combinations:

**Option 1: Name + Coordinates**

```json theme={null}
{
  "place_id": "my_place_123",
  "name": "Joes Pizza",
  "latitude": 40.7359,
  "longitude": -73.9911
}
```

**Option 2: Name + Address**

```json theme={null}
{
  "place_id": "my_place_123",
  "name": "Joes Pizza",
  "full_address": "7 Carmine St, New York, NY 10014"
}
```

**Option 3: Name + Address + Coordinates (Most accurate)**

```json theme={null}
{
  "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:

```json theme={null}
{
  "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:

| Attribute            | Description                                      |
| -------------------- | ------------------------------------------------ |
| `websites`           | Business website URL                             |
| `phoneNumbers`       | Phone number                                     |
| `social_profiles`    | Social media handles (Instagram, Facebook, etc.) |
| `closed_permanently` | Whether the business is permanently closed       |
| `price_tier`         | Price range (e.g., \$, \$\$, \$\$\$)             |
| `categories`         | Type of cuisine (for restaurants)                |
| `openingHours`       | Opening hours                                    |
| `names`              | Alternative names for the business               |
| `address`            | Address                                          |

You can see the entire list of attributes by calling the [Enrichment Attributes](/api-reference/attributes/get-enrichment-attributes) endpoint.

***

## 5. Batch Processing

For multiple places, use batch processing for asynchronous enrichment:

```json theme={null}
{
  "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](/guides/batch-processing).

***

## 6. Next Steps

Now that you've made your first API call, explore more:

* **[API Reference](/api-reference)** - Complete endpoint documentation
* **[Batch Processing](/guides/batch-processing)** - Process multiple places efficiently