---
openapi: 3.0.0
info:
  title: Naver AI Mode API
  description: Get Naver AI Mode answers as structured JSON. To continue an answer,
    pass pagination.conversation_token with the next question. Flight durations, stopovers,
    delivery fees and property prices retain the source display text when no machine
    value is available.
  version: 1.0.0
servers:
- url: https://www.searchapi.io/api/v1
paths:
  "/search":
    get:
      summary: Naver AI Mode Search
      security:
      - ApiKeyAuth: []
      - ApiKeyQuery: []
      parameters:
      - name: engine
        in: query
        required: true
        description: Set to naver_ai_mode.
        schema:
          type: string
          enum:
          - naver_ai_mode
      - name: q
        in: query
        required: true
        description: The question to send to Naver AI Mode, up to 800 characters.
        schema:
          type: string
          maxLength: 800
      - name: conversation_token
        in: query
        required: false
        description: Use pagination.conversation_token from a fresh response to continue
          the conversation.
        schema:
          type: string
          maxLength: 512
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                "$ref": "#/components/schemas/SearchResponse"
        '400':
          description: Validation Error. There is an issue with query parameters,
            such as missing required parameters or invalid values.
          content:
            application/json:
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
        '401':
          description: Authentication Error. The API key is missing or invalid.
          content:
            application/json:
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
        '429':
          description: Rate Limit Exceeded. The number of allowed requests has been
            exceeded. Consider upgrading your plan or waiting for the limit to reset.
          content:
            application/json:
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
        '500':
          description: Server Error. Internal server error.
          content:
            application/json:
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
        '503':
          description: Timeout. We could not retrieve results in 90 seconds.
          content:
            application/json:
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: 'Use Bearer authentication. Format: "Bearer YOUR_API_KEY"'
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api_key
      description: Pass API key as query parameter
  schemas:
    SearchMetadata:
      type: object
      required:
      - status
      - created_at
      properties:
        id:
          type: string
          description: Unique identifier for the search request
        status:
          type: string
          description: Status of the search request
        created_at:
          type: string
          format: date-time
          description: Timestamp when the search was created
        request_time_taken:
          type: number
          description: Time taken to make the request in seconds
        parsing_time_taken:
          type: number
          description: Time taken to parse the results in seconds
        total_time_taken:
          type: number
          description: Total time taken for the search in seconds
        request_url:
          type: string
          description: Upstream URL used for this search
        html_url:
          type: string
          description: URL to view the raw event stream
        json_url:
          type: string
          description: URL to view JSON results
    ErrorResponse:
      type: object
      required:
      - error
      properties:
        error:
          type: string
          description: Error message describing what went wrong
    SearchResponse:
      type: object
      properties:
        search_metadata:
          "$ref": "#/components/schemas/SearchMetadata"
        search_parameters:
          "$ref": "#/components/schemas/SearchParameters"
        text_blocks:
          type: array
          description: The answer split into structured blocks.
          items:
            oneOf:
            - "$ref": "#/components/schemas/AiAnswerTextBlock"
            - type: object
              description: Text block.
              properties:
                type:
                  type: string
                  description: Type of content block.
                  enum:
                  - shopping
                items:
                  type: array
                  description: The nested items in source order.
                  items:
                    "$ref": "#/components/schemas/SearchResponse/properties/inline_shopping/items"
              additionalProperties: false
              required:
              - type
              - items
            - type: object
              description: Text block.
              properties:
                type:
                  type: string
                  description: Type of content block.
                  enum:
                  - local_results
                items:
                  type: array
                  description: The nested items in source order.
                  items:
                    "$ref": "#/components/schemas/SearchResponse/properties/local_results/items"
              additionalProperties: false
              required:
              - type
              - items
        markdown:
          type: string
          description: The answer in Markdown.
        reference_links:
          type: array
          description: The sources cited by the answer.
          items:
            type: object
            properties:
              index:
                type: integer
                description: Zero-based position of this reference in `reference_links`
              title:
                type: string
                description: Page title
              link:
                type: string
                description: URL of the reference
              source:
                type: string
                description: Source website name
              snippet:
                type: string
                description: Text snippet from the referenced page
              favicon:
                type: string
                description: Favicon URL of the source
              date:
                type: string
                description: Publication date shown for the reference
              ref_id:
                type: string
                description: Provider-native reference identifier
              thumbnail:
                type: string
                description: Thumbnail image URL for the reference — the first entry
                  of `images`
              images:
                type: array
                description: Thumbnail image URLs for the reference; usually one,
                  occasionally more
                items:
                  type: string
              type:
                type: string
                description: Kind of source Naver labels the reference as, in snake
                  case.
              platform:
                type: string
                description: Name of the service or section the referenced page belongs
                  to.
              category_id:
                type: string
                description: Naver's category identifier for the place or product
                  the reference points to.
              tags:
                type: array
                description: Keyword tags Naver shows on the reference.
                items:
                  type: string
            additionalProperties: false
        web_results:
          type: array
          description: The pages retrieved for the answer.
          items:
            type: object
            properties:
              position:
                type: integer
                description: The position in the result collection.
              title:
                type: string
                description: Page title.
              link:
                type: string
                description: The destination URL.
              source:
                type: string
                description: Website name.
              platform:
                type: string
                description: Name of the service or section the page belongs to.
              snippet:
                type: string
                description: Text snippet from the page, as plain text that keeps
                  its line breaks.
              date:
                type: string
                description: Publication date and time of the page in ISO 8601 format,
                  in UTC.
              favicon:
                type: string
                description: Favicon URL of the website.
              ref_id:
                type: string
                description: Naver's reference identifier for the page, shared with
                  its entry in `reference_links`.
              type:
                type: string
                description: Kind of source Naver labels the page as, in snake case.
              thumbnail:
                type: string
                description: Thumbnail image URL of the page, the first entry of `images`.
              images:
                type: array
                description: Thumbnail image URLs of the page.
                items:
                  type: string
              tags:
                type: array
                description: Keyword tags Naver shows on the page.
                items:
                  type: string
            additionalProperties: false
        cards:
          type: array
          description: Flights, real estate and other structured results the answer
            drew on.
          items:
            oneOf:
            - type: object
              properties:
                type:
                  type: string
                  description: Type of card.
                  enum:
                  - flight
                position:
                  type: integer
                  description: The position in the result collection.
                title:
                  type: string
                  description: Title of the flight option, naming its route and airlines.
                flight_id:
                  type: string
                  description: Naver's identifier for the flight option.
                link:
                  type: string
                  description: The destination URL.
                flight_type:
                  type: string
                  description: Type of trip, round trip or one way.
                origin:
                  type: object
                  description: Where the trip starts.
                  properties:
                    city:
                      type: string
                      description: City name.
                    country:
                      type: string
                      description: Country name.
                    airport_code:
                      type: string
                      description: IATA code of the airport.
                  additionalProperties: false
                destination:
                  type: object
                  description: Where the trip goes.
                  properties:
                    city:
                      type: string
                      description: City name.
                    country:
                      type: string
                      description: Country name.
                    airport_code:
                      type: string
                      description: IATA code of the airport.
                  additionalProperties: false
                departure_date:
                  type: string
                  description: Departure date in ISO 8601 format.
                return_date:
                  type: string
                  description: Return date in ISO 8601 format.
                travel_class:
                  type: string
                  description: Cabin class as Naver shows it.
                price:
                  type: string
                  description: Price of the flight option as Naver shows it.
                extracted_price:
                  type: integer
                  description: Price of the flight option as an integer.
                description:
                  type: string
                  description: Details of the flight option as plain text that keeps
                    its line breaks.
                airline:
                  type: string
                  description: Name of the airline.
                airline_logo:
                  type: string
                  description: Logo URL of the airline.
                airline_code:
                  type: string
                  description: IATA code of the airline.
                stopover:
                  type: string
                  description: Stopover summary as Naver shows it.
                duration:
                  type: string
                  description: Flight duration as Naver shows it.
                passengers:
                  type: string
                  description: Passengers the price covers, as Naver shows it.
                has_more_flights:
                  type: boolean
                  description: Whether Naver lists more flights for the same route
                    and dates.
                is_featured:
                  type: boolean
                  description: Whether the answer shows the flight option as a card.
                is_price_confirmed:
                  type: boolean
                  description: Whether Naver marks the price as confirmed rather than
                    estimated.
                outbound:
                  type: object
                  description: Outbound leg of the itinerary.
                  properties:
                    airlines:
                      type: array
                      description: Airlines of the leg.
                      items:
                        type: object
                        properties:
                          name:
                            type: string
                            description: Name of the airline.
                          airline_logo:
                            type: string
                            description: Logo URL of the airline.
                        additionalProperties: false
                    departure_airport:
                      type: object
                      description: Airport the leg departs from.
                      properties:
                        id:
                          type: string
                          description: IATA code of the airport.
                        time:
                          type: string
                          description: Departure time as Naver shows it.
                      additionalProperties: false
                    arrival_airport:
                      type: object
                      description: Airport the leg arrives at.
                      properties:
                        id:
                          type: string
                          description: IATA code of the airport.
                        time:
                          type: string
                          description: Arrival time as Naver shows it.
                      additionalProperties: false
                    arrival_day_offset:
                      type: integer
                      description: Number of days after the departure date that the
                        leg arrives.
                    stopover:
                      type: string
                      description: Stopover summary of the leg as Naver shows it.
                    duration:
                      type: string
                      description: Duration of the leg as Naver shows it.
                    airline_code:
                      type: string
                      description: IATA code of the leg's airline.
                    flight_number:
                      type: string
                      description: Flight number of the leg, without the airline code.
                    fare_class:
                      type: string
                      description: Fare class code of the leg.
                  additionalProperties: false
                inbound:
                  type: object
                  description: Return leg of the itinerary.
                  properties:
                    airlines:
                      type: array
                      description: Airlines of the leg.
                      items:
                        type: object
                        properties:
                          name:
                            type: string
                            description: Name of the airline.
                          airline_logo:
                            type: string
                            description: Logo URL of the airline.
                        additionalProperties: false
                    departure_airport:
                      type: object
                      description: Airport the leg departs from.
                      properties:
                        id:
                          type: string
                          description: IATA code of the airport.
                        time:
                          type: string
                          description: Departure time as Naver shows it.
                      additionalProperties: false
                    arrival_airport:
                      type: object
                      description: Airport the leg arrives at.
                      properties:
                        id:
                          type: string
                          description: IATA code of the airport.
                        time:
                          type: string
                          description: Arrival time as Naver shows it.
                      additionalProperties: false
                    arrival_day_offset:
                      type: integer
                      description: Number of days after the departure date that the
                        leg arrives.
                    stopover:
                      type: string
                      description: Stopover summary of the leg as Naver shows it.
                    duration:
                      type: string
                      description: Duration of the leg as Naver shows it.
                    airline_code:
                      type: string
                      description: IATA code of the leg's airline.
                    flight_number:
                      type: string
                      description: Flight number of the leg, without the airline code.
                    fare_class:
                      type: string
                      description: Fare class code of the leg.
                  additionalProperties: false
                extensions:
                  type: array
                  description: Badge codes Naver shows on the flight option.
                  items:
                    type: string
              additionalProperties: false
              required:
              - type
            - type: object
              properties:
                type:
                  type: string
                  description: Type of card.
                  enum:
                  - real_estate_complex
                position:
                  type: integer
                  description: The position in the result collection.
                title:
                  type: string
                  description: Name of the complex.
                complex_id:
                  type: string
                  description: Naver's identifier for the complex.
                link:
                  type: string
                  description: The destination URL.
                listing_type:
                  type: string
                  description: Listing type the card covers for the complex, a sale
                    or a form of rent, as Naver labels it.
                listing_type_code:
                  type: string
                  description: Naver's code for the listing type.
                listing_count:
                  type: integer
                  description: Number of listings of that type in the complex.
                home_type:
                  type: string
                  description: Naver's code for the property type.
                address:
                  type: string
                  description: Street address of the complex.
                gps_coordinates:
                  type: object
                  description: GPS coordinates of the complex.
                  properties:
                    latitude:
                      type: number
                      description: Latitude in decimal degrees.
                    longitude:
                      type: number
                      description: Longitude in decimal degrees.
                  additionalProperties: false
                area_range:
                  type: string
                  description: Range of unit sizes in the complex as Naver shows it.
                completion_date:
                  type: string
                  description: Year and month the complex was completed, as Naver
                    shows it.
                total_units:
                  type: integer
                  description: Number of households in the complex.
                buildings:
                  type: integer
                  description: Number of buildings in the complex.
                price:
                  type: string
                  description: Price range Naver shows for the complex, for the listing
                    type in `price_listing_type`.
                price_listing_type:
                  type: string
                  description: Listing type that `price` is quoted for, as Naver labels
                    it.
                price_listing_type_code:
                  type: string
                  description: Naver's code for the listing type that `price` is quoted
                    for.
                price_ranges:
                  type: array
                  description: Price ranges of the complex's listings, one per listing
                    type.
                  items:
                    type: object
                    properties:
                      listing_type:
                        type: string
                        description: Listing type the price range is for, as Naver
                          labels it.
                      listing_type_code:
                        type: string
                        description: Naver's code for the listing type.
                      price:
                        type: string
                        description: Price range for the listing type as Naver shows
                          it.
                    additionalProperties: false
                area:
                  type: string
                  description: Unit size Naver shows as representative of the complex.
                asking_price:
                  type: string
                  description: Asking price Naver shows for the complex.
                actual_price:
                  type: string
                  description: Actual transaction price Naver shows for the complex.
                listing_counts:
                  type: array
                  description: Listing counts of the complex, one per listing type.
                  items:
                    type: object
                    properties:
                      listing_type:
                        type: string
                        description: Listing type the count is for, as Naver labels
                          it.
                      listing_type_code:
                        type: string
                        description: Naver's code for the listing type.
                      count:
                        type: integer
                        description: Number of listings of that type in the complex.
                      link:
                        type: string
                        description: The destination URL.
                    additionalProperties: false
                listings_link:
                  type: string
                  description: URL of the complex's listings on Naver.
                description:
                  type: string
                  description: Details of the complex as plain text that keeps its
                    line breaks.
                listing_ids:
                  type: array
                  description: Naver's identifiers for the complex's listings of that
                    type, matching `listing_id` on listing cards.
                  items:
                    type: string
                is_featured:
                  type: boolean
                  description: Whether the answer shows the complex as a card.
                thumbnail:
                  type: string
                  description: Thumbnail image URL of the complex.
              additionalProperties: false
              required:
              - type
            - type: object
              properties:
                type:
                  type: string
                  description: Type of card.
                  enum:
                  - real_estate_listing
                position:
                  type: integer
                  description: The position in the result collection.
                title:
                  type: string
                  description: Title of the listing as Naver shows it.
                listing_id:
                  type: string
                  description: Naver's identifier for the listing.
                link:
                  type: string
                  description: The destination URL.
                building_name:
                  type: string
                  description: Name of the complex the listing belongs to.
                home_type:
                  type: string
                  description: Naver's code for the property type.
                listing_type:
                  type: string
                  description: Listing type, a sale or a form of rent, as Naver labels
                    it.
                listing_type_code:
                  type: string
                  description: Naver's code for the listing type.
                price:
                  type: string
                  description: Price of the listing as Naver shows it, with deposit
                    and rent for a monthly rental.
                supply_area:
                  type: string
                  description: Supply area of the unit as Naver shows it.
                exclusive_area:
                  type: string
                  description: Exclusive-use area of the unit as Naver shows it.
                extracted_exclusive_area:
                  type: number
                  description: Exclusive-use area of the unit in square meters.
                floor:
                  type: string
                  description: Floor of the unit and the building's floor count, as
                    Naver shows it.
                direction:
                  type: string
                  description: Direction the unit faces, as Naver shows it.
                building_number:
                  type: string
                  description: Building within the complex that the unit is in.
                is_verified:
                  type: boolean
                  description: Whether Naver has verified the listing.
                verified_date:
                  type: string
                  description: Date Naver verified the listing.
                gps_coordinates:
                  type: object
                  description: GPS coordinates of the listing.
                  properties:
                    latitude:
                      type: number
                      description: Latitude in decimal degrees.
                    longitude:
                      type: number
                      description: Longitude in decimal degrees.
                  additionalProperties: false
                description:
                  type: string
                  description: Details of the listing as plain text that keeps its
                    line breaks.
                owner_type:
                  type: string
                  description: Owner label Naver shows on the listing.
                tags:
                  type: array
                  description: Feature tags Naver shows on the listing.
                  items:
                    type: string
                thumbnail:
                  type: string
                  description: Thumbnail image URL of the listing.
                is_featured:
                  type: boolean
                  description: Whether the answer shows the listing as a card.
              additionalProperties: false
              required:
              - type
            - "$ref": "#/components/schemas/RawCard"
        search_queries:
          type: array
          description: The searches Naver AI Mode ran for the answer, and the expressions it calculated.
          items:
            type: string
        response_metadata:
          type: object
          description: Details about the answer.
          properties:
            conversation_id:
              type: string
              description: Naver's identifier for the conversation.
            turn:
              type: integer
              description: Number of this turn in the conversation, starting at 1.
            topic:
              type: string
              description: Topic Naver classified the question under.
            topics:
              type: array
              description: Topics Naver matched the question to, each with a score.
              items:
                type: object
                properties:
                  name:
                    type: string
                    description: Name of the topic.
                  score:
                    type: number
                    description: Naver's relevance score for the topic.
                additionalProperties: false
            refined_query:
              type: string
              description: The question as Naver rewrote it, on the first turn of
                a conversation.
          additionalProperties: false
        pagination:
          type: object
          description: How to continue the conversation.
          properties:
            conversation_token:
              type: string
              description: The token to pass with the next question.
          additionalProperties: false
        disclaimer:
          type: string
          description: The disclaimer Naver shows with the answer.
        inline_images:
          type: array
          description: The images Naver retrieved for the answer.
          items:
            type: object
            properties:
              position:
                type: integer
                description: The position in the result collection.
              title:
                type: string
                description: Image title.
              link:
                type: string
                description: The destination URL.
              thumbnail:
                type: string
                description: Thumbnail URL of the image.
              platform:
                type: string
                description: Name of the service or section the image's page belongs
                  to.
              source:
                type: string
                description: Name of the website the image comes from.
              date:
                type: string
                description: Publication date and time of the image's page in ISO
                  8601 format, in UTC.
              ref_id:
                type: string
                description: Naver's reference identifier for the image's page, shared
                  with its entry in `reference_links`.
              favicon:
                type: string
                description: Favicon URL of the website.
              is_featured:
                type: boolean
                description: Whether the answer shows the image.
            additionalProperties: false
        inline_shopping:
          type: array
          description: The products Naver drew on for the answer.
          items:
            type: object
            properties:
              position:
                type: integer
                description: The position in the result collection.
              title:
                type: string
                description: Product name.
              product_id:
                type: string
                description: Naver's identifier for the product.
              ref_id:
                type: string
                description: Naver's reference identifier for the product, shared
                  with its entry in `reference_links`.
              link:
                type: string
                description: The destination URL.
              category_id:
                type: string
                description: Naver's category path for the product, as category identifiers
                  joined by colons.
              price:
                type: string
                description: Product price as Naver shows it.
              extracted_price:
                type: integer
                description: Product price as an integer.
              delivery_fee:
                type: string
                description: Delivery fee as Naver shows it.
              seller:
                type: string
                description: Name of the store selling the product.
              thumbnail:
                type: string
                description: Thumbnail image URL of the product.
              original_price:
                type: string
                description: Price before the discount as Naver shows it.
              extracted_original_price:
                type: integer
                description: Price before the discount as an integer.
              discount_percentage:
                type: integer
                description: Discount off the original price, in percent.
              rating:
                type: number
                description: Average rating of the product.
              reviews:
                type: integer
                description: Number of reviews of the product.
              description:
                type: string
                description: Details of the product as plain text that keeps its line
                  breaks.
              extensions:
                type: array
                description: Badge codes Naver shows on the product and its seller.
                items:
                  type: string
              delivery_info:
                type: object
                description: Delivery estimate for the product.
                properties:
                  type:
                    type: string
                    description: Naver's code for the kind of delivery.
                  arrival_date:
                    type: string
                    description: Arrival estimate as Naver shows it.
                additionalProperties: false
              best_pick:
                type: object
                description: The quality Naver highlights the product for.
                properties:
                  type:
                    type: string
                    description: Naver's code for the highlighted quality.
                  label:
                    type: string
                    description: Label of the highlighted quality as Naver shows it.
                  delivery_arrival:
                    type: string
                    description: Naver's code for how soon the product ships or arrives.
                  earnable_points:
                    type: integer
                    description: Reward points a buyer can earn on the purchase.
                additionalProperties: false
              is_featured:
                type: boolean
                description: Whether the answer shows the product as a card.
              departure_info:
                type: object
                description: Dispatch details for the product.
                properties:
                  type:
                    type: string
                    description: Naver's code for the day the product ships.
                  order_due_time:
                    type: string
                    description: Time to order by for that dispatch day, as Naver
                      shows it.
                additionalProperties: false
              additional_info:
                type: object
                description: Extra purchase note Naver shows on the product.
                properties:
                  text:
                    type: string
                    description: Short text of the note.
                  description:
                    type: string
                    description: Explanation of the note.
                additionalProperties: false
            additionalProperties: false
        inline_videos:
          type: array
          description: The videos Naver retrieved for the answer.
          items:
            type: object
            properties:
              position:
                type: integer
                description: The position in the result collection.
              title:
                type: string
                description: Video title.
              link:
                type: string
                description: The destination URL.
              thumbnail:
                type: string
                description: Thumbnail image URL of the video.
              source:
                type: string
                description: Name of the platform that hosts the video.
              channel:
                type: string
                description: Name of the channel that published the video.
              date:
                type: string
                description: Publication date and time of the video in ISO 8601 format,
                  in UTC.
              description:
                type: string
                description: Description of the video as plain text that keeps its
                  line breaks.
              ref_id:
                type: string
                description: Naver's reference identifier for the video, shared with
                  its entry in `reference_links`.
              is_featured:
                type: boolean
                description: Whether the answer shows the video.
            additionalProperties: false
        local_results:
          type: array
          description: The places Naver drew on for the answer.
          items:
            type: object
            properties:
              position:
                type: integer
                description: The position in the result collection.
              title:
                type: string
                description: Place name.
              place_id:
                type: string
                description: Naver's identifier for the place.
              link:
                type: string
                description: The destination URL.
              type:
                type: string
                description: Category of the place as Naver labels it.
              category_id:
                type: string
                description: Naver's identifier for the place's category.
              address:
                type: string
                description: Address of the place down to its district or neighborhood.
              gps_coordinates:
                type: object
                description: GPS coordinates of the place.
                properties:
                  latitude:
                    type: number
                    description: Latitude in decimal degrees.
                  longitude:
                    type: number
                    description: Longitude in decimal degrees.
                additionalProperties: false
              description:
                type: string
                description: Details of the place as plain text that keeps its line
                  breaks.
              open_state:
                type: string
                description: Current operating status of the place as Naver shows
                  it.
              open_hours:
                type: string
                description: When the place next opens or closes, as Naver shows it.
              rating:
                type: number
                description: Average rating of the place.
              reviews:
                type: integer
                description: Number of reviews of the place.
              thumbnail:
                type: string
                description: Thumbnail image URL of the place.
              images:
                type: array
                description: Image URLs of the place.
                items:
                  type: string
              reservation:
                type: string
                description: URL of the place's booking page on Naver.
              extensions:
                type: array
                description: Badge codes Naver shows on the place.
                items:
                  type: string
              is_featured:
                type: boolean
                description: Whether the answer shows the place as a card.
              is_day_off:
                type: boolean
                description: Whether the place is closed for the day.
              reservation_slot:
                type: object
                description: Booking times Naver offers at the place for the party
                  size and time asked about.
                properties:
                  title:
                    type: string
                    description: Name of the booking option the times are for.
                  link:
                    type: string
                    description: The destination URL.
                  day:
                    type: string
                    description: Day of the booking times as Naver shows it.
                  date:
                    type: string
                    description: Date of the booking times in ISO 8601 format, in
                      Korea Standard Time.
                  party_size:
                    type: string
                    description: Party size the booking times are for, as Naver shows
                      it.
                  reference_time:
                    type: string
                    description: Requested time the booking times are listed around,
                      as Naver shows it.
                  times:
                    type: array
                    description: Booking times offered around `reference_time`.
                    items:
                      type: object
                      properties:
                        time:
                          type: string
                          description: Booking time as Naver shows it.
                        datetime:
                          type: string
                          description: Start of the booking time in ISO 8601 format,
                            in UTC.
                        link:
                          type: string
                          description: The destination URL.
                        is_disabled:
                          type: boolean
                          description: Whether the time is closed to booking.
                      additionalProperties: false
                additionalProperties: false
            additionalProperties: false
        error:
          type: string
          description: Message saying why Naver AI Mode returned no answer.
      additionalProperties: false
      required:
      - search_metadata
      - search_parameters
    SearchParameters:
      type: object
      properties:
        engine:
          type: string
          enum:
          - naver_ai_mode
          description: Set to naver_ai_mode.
        q:
          type: string
          maxLength: 800
          description: The question to send to Naver AI Mode, up to 800 characters.
        conversation_token:
          type: string
          maxLength: 512
          description: Use pagination.conversation_token from a fresh response to
            continue the conversation.
    AiAnswerTextBlock:
      type: object
      required:
      - type
      properties:
        type:
          type: string
          enum:
          - header
          - paragraph
          - unordered_list
          - ordered_list
          - table
          - code_blocks
          description: Type of content block.
        answer:
          type: string
          description: Text of a header, paragraph or list item, with inline code
            kept in backticks.
        reference_indexes:
          type: array
          description: Zero-based indexes into `reference_links` cited by this block
          items:
            type: integer
        items:
          type: array
          description: Nested blocks within a list or list item.
          items:
            "$ref": "#/components/schemas/AiAnswerTextBlock"
        table:
          type: object
          description: Table data (for table type)
          required:
          - headers
          - rows
          properties:
            headers:
              type: array
              description: Table header row; cells keep inline-code backticks like
                `answer`
              items:
                type: string
            rows:
              type: array
              description: Table data rows; cells keep inline-code backticks like
                `answer`
              items:
                type: array
                items:
                  type: string
        language:
          type: string
          description: Programming language (for code_blocks type)
        code:
          type: string
          description: Code content (for code_blocks type)
    RawCard:
      type: object
      description: A card type without its own schema, with the source's payload unchanged under `raw`.
      required:
      - type
      - raw
      additionalProperties: false
      properties:
        type:
          type: string
          description: Provider card type (singular snake_case), never a known canonical
            type
          not:
            enum:
            - flight
            - real_estate_complex
            - real_estate_listing
        raw:
          type: object
          description: Provider-native card payload, preserved as-is; never empty
          minProperties: 1
