Skip to main content
This section documents the map entries data returned by the ChatGPT endpoint. Map entries are part of the ChatGPT response — no separate API call is needed.

​
Example request

Map entries are returned by default when ChatGPT surfaces business or place data — no flag is required. 
{
  "prompt": "best laundromats in Portland",
  "model": "CHATGPT",
  "country": "US"
}
This produces a response containing the map array documented below.

​
Overview

Map entries are automatically extracted when ChatGPT returns business or place information from providers like Yelp and Google Business. No additional parameters are required - map entries are included by default when available in the response.
Map entries in ChatGPT

​
Map entry structure

Each map entry contains business information directly from ChatGPT’s data providers:

​
Core fields

FieldTypeDescription
namestringBusiness name
idstringBusiness ID (Yelp ID or Google Place ID)
providerstringData provider: “yelp”, “b1”/“b3” (Google), or “yelp-feed”
positionintPosition/ranking in results (added by parser)

​
Location fields

FieldTypeDescription
addressstringFull street address
citystringCity name
statestringState/province code
zipcodestringPostal/ZIP code
countryCodestringCountry code (e.g., “US”, “GB”)
countryNamestringFull country name
latitudefloatGPS latitude coordinate
longitudefloatGPS longitude coordinate
locationstringHuman-readable location string
distanceMetersfloatDistance from user’s location (if available)

​
Ratings and reviews

FieldTypeDescription
ratingfloatBusiness rating (typically 0-5)
reviewCountintNumber of reviews
ratingScaleintRating scale (usually 5)
reviewsBusinessReview[]Array of detailed reviews
reviewHighlightsReviewHighlight[]Array of highlighted review snippets

​
Business info

FieldTypeDescription
categoriesarrayBusiness categories (list)
descriptionstringBusiness description
enrichedDescriptionstringEnhanced description with additional context
descriptionCitestringCitation/source for description
priceintPrice level (1-4, number of $ signs)
priceStrstringPrice display: ”$”, ”$$”, ”$$$”, etc.

​
Contact and URLs

FieldTypeDescription
phonestringContact phone number
websiteUrlstringBusiness website
providerUrlstringYelp/Google Business page URL
providerLogoUrlstringProvider logo (light theme)
providerLogoDarkUrlstringProvider logo (dark theme)
imageUrlstringPrimary business image
imageUrlsarrayAll business images
providerImagesProviderImage[]Provider-hosted images with metadata
yelpMenuUrlstringYelp menu URL (Yelp only)

​
Hours and status

FieldTypeDescription
hoursBusinessHour[]Array of operating hours
isOpenbooleanCurrently open
isClosedPermanentlybooleanPermanently closed
isClosedTemporarilybooleanTemporarily closed
nextOpenHourBusinessHourNext opening time
specialHoursBusinessHour[]Special/holiday hours

​
Additional fields

FieldTypeDescription
attributesobjectProvider-specific attributes (parking, WiFi, payment methods, etc.)
tagsarrayBusiness tags
rankintBusiness rank/position from provider
popularityScorefloatPopularity score
isClaimedbooleanWhether business claimed their listing
dateOpenedstringDate business opened
dateClosedstringDate business closed (if applicable)
reservationProvidersReservationProvider[]Available reservation providers
fromCachebooleanWhether data was cached

​
BusinessHour

Used by: hours, nextOpenHour, specialHours
FieldTypeDescription
dayintDay of week: 0-6 (0=Sunday, 1=Monday, …, 6=Saturday) or 1-7 depending on provider
startstringOpening time in HHmm format (e.g., “0600” = 6:00 AM)
endstringClosing time in HHmm format (e.g., “2200” = 10:00 PM)

​
BusinessReview

Used by: reviews
FieldTypeDescription
idstringReview ID from provider
urlstringReview URL (may be null)
textstringReview text content
ratingintReview rating (1-5)
time_createdstringISO 8601 timestamp

​
ReviewHighlight

Used by: reviewHighlights
FieldTypeDescription
photostringURL to associated photo
sentencestringReview snippet with [[HIGHLIGHT]]text[[ENDHIGHLIGHT]] markers
review_countintNumber of reviews mentioning this highlight

​
ProviderImage

Used by: providerImages
FieldTypeDescription
captionstringImage caption
idstringImage ID
is_user_submittedbooleanWhether user uploaded
labelstringImage category (e.g., “food”, “inside”, “outside”)
large_urlstringLarge size image URL
medium_urlstringMedium size image URL
original_urlstringOriginal size image URL
urlstringStandard image URL
slideshow_orderintDisplay order

​
ReservationProvider

Used by: reservationProviders
FieldTypeDescription
providerstringService name (e.g., “yelp”, “opentable”)
provider_restaurant_idstringRestaurant ID on provider
provider_reservation_urlstringReservation URL
provider_namestringDisplay name
provider_logostringLogo URL
launcherPayloadanyAdditional provider data

​
Example usage

{
  "prompt": "best laundromats in Portland",
  "model": "CHATGPT",
  "country": "US"
}
Response with map entries: 
{
  "success": true,
  "result": {
    "text": "Here are some 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
      }
    ]
  }
}
All fields are optionalExcept for name and position, all fields in map entries are optional. Use optional chaining (?.) or check for field existence before accessing. Field availability depends on the provider (Yelp vs Google) and what data is available for each business.