ChatGPT map entries schema

This section documents the map entries data returned by the ChatGPT endpoint. Map entries are part of the ChatGPT response, so no separate API call is needed. For use cases, pricing context, and copy-paste examples, see the ChatGPT scraper page on the product site.

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. 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 if you use /v1/monitor/* instead of async). There is no additional charge based on the number of businesses or per-business reviews returned. See Providers for the full ChatGPT pricing breakdown.

Map entry structure

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

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

Example usage

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

Response with map entries:

{
  "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
      }
    ]
  }
}

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.

Overview

ChatGPT

Google

Perplexity

Copilot

AI Mode

Grok

Gemini

Google News

Utilities

ChatGPT map entries schema

Example request

Overview

Map entry structure

Core fields

Location fields

Ratings and reviews

Business info

Contact and URLs

Hours and status

Additional fields

`BusinessHour`

`BusinessReview`

`ReviewHighlight`

`ProviderImage`

`ReservationProvider`

Example usage

​Example request

​Overview

​Map entry structure

​Core fields

​Location fields

​Ratings and reviews

​Business info

​Contact and URLs

​Hours and status

​Additional fields

​BusinessHour

​BusinessReview

​ReviewHighlight

​ProviderImage

​ReservationProvider

​Example usage

Example request

Overview

Map entry structure

Core fields

Location fields

Ratings and reviews

Business info

Contact and URLs

Hours and status

Additional fields

`BusinessHour`

`BusinessReview`

`ReviewHighlight`

`ProviderImage`

`ReservationProvider`

Example usage