## ChatGPT Endpoint

The [ChatGPT endpoint](/content/docs/api-reference/endpoint/monitor-chatgpt/index.html) returns **map entries** in `result.map` whenever ChatGPT surfaces business or place information from providers like **Yelp** and **Google Business** — no separate API call, no flag. For use cases, pricing context, and copy-paste examples, see the [ChatGPT scraper](/content/chatgpt/index.html) page on the product site.

Map entries in ChatGPT

To also see the queries ChatGPT fired at the maps tool to build these entries, set `include.searchQueries: true` and read `result.mapSearchQueries`. These are separate from the web-search fan-out in `result.searchQueries`. **Cost:** Map entries are included at no extra cost — they’re part of the base ChatGPT request (5 credits, plus the [+2 sync surcharge](/content/docs/guides/providers#sync-request-surcharge/index.html) if you use `/v1/monitor/*` instead of async). The number of businesses or per-business reviews returned does not change the price. See [Providers](/content/docs/guides/providers#chatgpt-additional-features/index.html) for the full ChatGPT pricing breakdown.

## Example request

```
{
  "prompt": "best laundromats in Portland",
  "model": "CHATGPT",
  "country": "US"
}
```

## Map entry structure

### Core fields

| Field  | Type   | Description                                       |
| ------ | ------ | ------------------------------------------------- |
| `name` | string | Business name                                    |
| `id`   | string | Business ID (Yelp ID or Google Place ID)       |
| `provider` | string | Data provider: “yelp”, “b1”/“b3” (Google), or “yelp-feed” |
| `position` | int    | Position/ranking in results (added by parser)  |

### Location fields

| Field       | Type   | Description                                                   |
| ----------- | ------ | ----------------------------------------------------------- |
| `address`   | string | Full street address                                          |
| `city`      | string | City name                                                   |
| `state`     | string | State/province code                                         |
| `zipcode`   | string | Postal/ZIP code                                            |
| `countryCode` | string | Country code (e.g., “US”, “GB”)                          |
| `countryName` | string | Full country name                                         |
| `latitude`  | float  | GPS latitude coordinate                                     |
| `longitude` | float  | GPS longitude coordinate                                    |
| `location`  | string | Human-readable location string                              |
| `distanceMeters` | float | Distance from user’s location (if available)           |

### Ratings and reviews

| Field          | Type   | Description                               |
| -------------- | ------ | ----------------------------------------- |
| `rating`      | float  | Business rating (typically 0-5)          |
| `reviewCount` | int    | Number of reviews                        |
| `ratingScale` | int    | Rating scale (usually 5)                |
| `reviews`     | BusinessReview[] | Array of detailed reviews          |
| `reviewHighlights` | ReviewHighlight[] | Array of highlighted review snippets  |

### Business info

| Field               | Type   | Description                                                |
| -------------------| ------ | ---------------------------------------------------------- |
| `categories`       | array  | Business categories (list)                                 |
| `description`      | string | Business description                                       |
| `enrichedDescription` | string | Enhanced description with additional context              |
| `descriptionCite` | string | Citation/source for description                          |
| `price`           | int    | Price level (1-4, number of $ signs)                    |
| `priceStr`       | string | Price display: ”$”, ”$$”, ”$$$”, etc.                   |

### Contact and URLs

| Field               | Type   | Description                                    |
| -------------------| ------ | ---------------------------------------------- |
| `phone`           | string | Contact phone number                           |
| `websiteUrl`       | string | Business website                               |
| `providerUrl`      | string | Yelp/Google Business page URL                 |
| `providerLogoUrl`  | string | Provider logo (light theme)                    |
| `providerLogoDarkUrl` | string | Provider logo (dark theme)                  |
| `imageUrl`        | string | Primary business image                          |
| `imageUrls`       | array  | All business images                            |
| `providerImages`   | ProviderImage[] | Provider-hosted images with metadata  |
| `yelpMenuUrl`     | string | Yelp menu URL (Yelp only)                     |

### Hours and status

| Field                | Type   | Description                                     |
| --------------------| ------ | ----------------------------------------------- |
| `hours`            | BusinessHour[] | Array of operating hours                      |
| `isOpen`          | boolean | Currently open                                  |
| `isClosedPermanently` | boolean | Permanently closed                             |
| `isClosedTemporarily` | boolean | Temporarily closed                             |
| `nextOpenHour`    | BusinessHour | Next opening time                             |
| `specialHours`     | BusinessHour[] | Special/holiday hours                        |

### Additional fields

| Field               | Type   | Description                                       |
| -------------------| ------ | ----------------------------------------------- |
| `attributes`       | object | Provider-specific attributes (parking, WiFi, payment methods, etc.) |
| `tags`             | array  | Business tags                                   |
| `rank`             | int    | Business rank/position from provider           |
| `popularityScore`  | float  | Popularity score                                |
| `isClaimed`       | boolean | Whether business claimed their listing           |
| `dateOpened`      | string  | Date business opened                             |
| `dateClosed`      | string  | Date business closed (if applicable)           |
| `reservationProviders` | ReservationProvider[] | Available reservation providers  |
| `fromCache`       | boolean | Whether data was cached                         |

### `BusinessHour`
Used by: `hours`, `nextOpenHour`, `specialHours`

| Field | Type   | Description                                              |
| ----- | ------ | -------------------------------------------------------- |
| `day` | int    | Day of week: 0-6 (0=Sunday, 1=Monday, …, 6=Saturday) or 1-7 depending on provider |
| `start` | string | Opening time in HHmm format (e.g., “0600” = 6:00 AM)   |
| `end`   | string | Closing time in HHmm format (e.g., “2200” = 10:00 PM)  |

### `BusinessReview`
Used by: `reviews`

| Field         | Type   | Description                                   |
| ------------- | ------ | --------------------------------------------- |
| `id`         | string | Review ID from provider                        |
| `url`        | string | Review URL (may be null)                      |
| `text`       | string | Review text content                            |
| `rating`     | int    | Review rating (1-5)                           |
| `time_created` | string | ISO 8601 timestamp                           |

### `ReviewHighlight`
Used by: `reviewHighlights`

| Field | Type   | Description                                           |
| ----- | ------ | ---------------------------------------------------- |
| `photo` | string | URL to associated photo                              |
| `sentence` | string | Review snippet with `[[HIGHLIGHT]]text[[ENDHIGHLIGHT]]` markers |
| `review_count` | int    | Number of reviews mentioning this highlight        |

### `ProviderImage`
Used by: `providerImages`

| Field | Type   | Description                                           |
| ----- | ------ | ---------------------------------------------------- |
| `caption` | string | Image caption                                       |
| `id` | string | Image ID                                           |
| `is_user_submitted` | boolean | Whether user uploaded                              |
| `label` | string | Image category (e.g., “food”, “inside”, “outside”) |
| `large_url` | string | Large size image URL                               |
| `medium_url` | string | Medium size image URL                             |
| `original_url` | string | Original size image URL                           |
| `url` | string | Standard image URL                                  |
| `slideshow_order` | int | Display order                                    |

### `ReservationProvider`
Used by: `reservationProviders`

| Field                     | Type   | Description                                           |
| ---------------------| ------ | ----------------------------------------------------- |
| `provider`              | string | Service name (e.g., “yelp”, “opentable”)           |
| `provider_restaurant_id` | string | Restaurant ID on provider                          |
| `provider_reservation_url` | string | Reservation URL                                   |
| `provider_name`        | string | Display name                                      |
| `provider_logo`       | string | Logo URL                                          |
| `launcherPayload`      | any    | Additional provider data                           |

## Response example

```
{
  "success": true,
  "result": {
    "text": "Here are highly-rated laundromats in Portland...",
    "map": [
      {
        "id": "rVKID2OBQMyVpraqSjz9sg",
        "provider": "yelp",
        "name": "Spin Laundry Lounge",
        "position": 1,
        
        "address": "750 N Fremont St, Portland, OR 97227",
        "city": "Portland",
        "state": "OR",
        "zipcode": "97227",
        "countryCode": "US",
        "countryName": "United States",
        "latitude": 45.54764,
        "longitude": -122.67432,
        "location": "Portland, Oregon, United States",
        
        "rating": 4.2,
        "reviewCount": 381,
        "ratingScale": 5,
        
        "categories": ["Laundromat"],
        "price": 2,
        "priceStr": "$$",
        
        "phone": "+15032844794",
        "websiteUrl": "https://spinlaundrylounge.com",
        "providerUrl": "https://www.yelp.com/biz/spin-laundry-lounge-portland",
        "imageUrl": "https://s3-media0.fl.yelpcdn.com/bphoto/cOz0Qp5P3JgS1aLjVrR6_g/o.jpg",
        "imageUrls": [
          "https://s3-media0.fl.yelpcdn.com/bphoto/cOz0Qp5P3JgS1aLjVrR6_g/o.jpg"
        ],
        
        "isOpen": true,
        "isClosedPermanently": false,
        "hours": [
          {"day": 1, "start": "0700", "end": "2100"},
          {"day": 2, "start": "0700", "end": "2100"},
          {"day": 3, "start": "0700", "end": "2100"},
          {"day": 4, "start": "0700", "end": "2100"},
          {"day": 5, "start": "0700", "end": "2100"},
          {"day": 6, "start": "0700", "end": "2100"},
          {"day": 0, "start": "0700", "end": "2100"}
        ],
        "nextOpenHour": {"day": 2, "start": "0700", "end": "2100"},
        
        "attributes": {
          "wi_fi": "free",
          "business_accepts_credit_cards": true,
          "business_parking": {
            "street": true,
            "lot": false
          }
        },
        
        "fromCache": false
      }
    ]
  }
}
```