---
openapi: 3.0.0
info:
  title: Yahoo Scout API
  description: Get Yahoo Scout answers as structured JSON. To continue an answer,
    pass pagination.conversation_token with the next question. Keep the same country
    for the conversation. Search results and cards depend on the question and the
    answer provided by Yahoo Scout.
  version: 1.0.0
servers:
- url: https://www.searchapi.io/api/v1
paths:
  "/search":
    get:
      summary: Yahoo Scout Search
      security:
      - ApiKeyAuth: []
      - ApiKeyQuery: []
      parameters:
      - name: engine
        in: query
        required: true
        description: Set to yahoo_scout.
        schema:
          type: string
          enum:
          - yahoo_scout
      - name: q
        in: query
        required: true
        description: The question to send to Yahoo Scout, up to 10000 characters.
          The limit counts UTF-16 code units; a supplementary character such as an
          emoji counts as two.
        schema:
          type: string
          maxLength: 10000
      - name: country
        in: query
        required: false
        description: The country for the answer. Keep the same country when continuing
          a conversation.
        schema:
          type: string
          enum:
          - us
          - gb
          - uk
          default: us
      - name: conversation_token
        in: query
        required: false
        description: Use pagination.conversation_token from a fresh response to continue
          the conversation.
        schema:
          type: string
          maxLength: 2048
      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"
        error:
          type: string
          description: Message saying why Yahoo Scout returned no answer.
        text_blocks:
          type: array
          description: The answer split into structured blocks.
          items:
            "$ref": "#/components/schemas/AiAnswerTextBlock"
        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
              date:
                type: string
                description: Publication date shown for the reference
              thumbnail:
                type: string
                description: Thumbnail image URL of the reference.
            additionalProperties: false
        citations:
          type: array
          description: Where the answer cites its sources.
          items:
            type: object
            properties:
              index:
                type: integer
                description: Character offset in `markdown` immediately after the
                  cited phrase.
              source_indexes:
                type: array
                description: The zero-based `reference_links` indexes of the sources
                  cited there.
                items:
                  type: integer
              cited_text:
                type: string
                description: The phrase of the answer the citation is attached to.
            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: Host name of the page's website.
              snippet:
                type: string
                description: Excerpt of the page's text, as plain text that keeps
                  its line breaks.
              date:
                type: string
                description: Publication date and time of the page, in ISO 8601 UTC.
              thumbnail:
                type: string
                description: Thumbnail image URL of the page.
            additionalProperties: false
        top_stories:
          type: array
          description: News stories Yahoo Scout shows with the answer.
          items:
            type: object
            description: A top story.
            properties:
              position:
                type: integer
                description: The position in the result collection.
              id:
                type: string
                description: Identifier Yahoo assigns to the story.
              title:
                type: string
                description: Story headline.
              link:
                type: string
                description: The destination URL.
              source:
                type: string
                description: Publisher of the story as Yahoo credits it.
              date:
                type: string
                description: How long ago the story was published, as Yahoo shows
                  it.
              iso_date:
                type: string
                description: Publication date and time of the story, in ISO 8601 UTC.
              snippet:
                type: string
                description: Short excerpt of the story.
              thumbnail:
                type: string
                description: Thumbnail image URL of the story.
            additionalProperties: false
        shopping_ads:
          type: array
          description: Sponsored products Yahoo Scout shows with the answer.
          items:
            type: object
            properties:
              position:
                type: integer
                description: The position in the result collection.
              block_position:
                type: string
                description: Ad slot of the answer the product appears in, with `position`
                  counted within that slot.
              product_id:
                type: string
                description: The seller's identifier for the product.
              title:
                type: string
                description: Product title.
              link:
                type: string
                description: The destination URL.
              tracking_link:
                type: string
                description: URL the ad links to, including its click tracking.
              extracted_price:
                type: number
                description: Product price as a number, in the currency named by `currency`.
              currency:
                type: string
                description: Three-letter currency code of the price.
              rating:
                type: number
                description: Average customer rating of the product.
              reviews:
                type: integer
                description: Number of customer reviews of the product.
              thumbnail:
                type: string
                description: Product image URL.
              seller:
                type: string
                description: Name of the retailer selling the product, as Yahoo labels
                  it.
              description:
                type: string
                description: Product description shown with the ad.
            additionalProperties: false
        ads:
          type: array
          description: Sponsored text ads Yahoo Scout shows with the answer.
          items:
            type: object
            properties:
              position:
                type: integer
                description: The position in the result collection.
              title:
                type: string
                description: Ad headline.
              link:
                type: string
                description: The destination URL.
              tracking_link:
                type: string
                description: URL the ad links to, including its click tracking.
              displayed_link:
                type: string
                description: Advertiser's domain as shown with the ad.
              snippet:
                type: string
                description: Ad description text.
            additionalProperties: false
        related_questions:
          type: array
          description: Follow-up questions Yahoo Scout suggests after the answer.
          items:
            type: object
            properties:
              question:
                type: string
                description: Suggested follow-up question text.
            additionalProperties: false
        response_metadata:
          type: object
          description: Details about the answer.
          properties:
            model:
              type: string
              description: The model that wrote the answer.
            conversation_id:
              type: string
              description: Yahoo Scout's identifier for the conversation.
            message_id:
              type: string
              description: Yahoo Scout's identifier for the answer.
            title:
              type: string
              description: The title Yahoo Scout gave the conversation.
            intent:
              type: string
              description: The broad category Yahoo Scout assigned to the question.
            is_web_search_performed:
              type: boolean
              description: Whether Yahoo Scout searched the web for the answer.
            has_warning:
              type: boolean
              description: Whether Yahoo Scout flagged the answer with a warning.
            subcategory:
              type: string
              description: The narrower category Yahoo Scout assigned to the question
                within `intent`.
          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
        cards:
          type: array
          description: Structured cards Yahoo Scout shows with the answer, each identified
            by its `type`.
          items:
            oneOf:
            - type: object
              properties:
                type:
                  type: string
                  description: The card type, which is always weather for this card.
                  enum:
                  - weather
                source:
                  type: object
                  description: Who supplied the card's data.
                  properties:
                    name:
                      type: string
                      description: Name of the data provider.
                    link:
                      type: string
                      description: The destination URL.
                  additionalProperties: false
                location:
                  type: string
                  description: City the forecast is for.
                region:
                  type: string
                  description: State or region of the forecast location.
                timezone:
                  type: string
                  description: IANA time zone name of the forecast location.
                current:
                  type: object
                  description: Current weather conditions.
                  properties:
                    temperature:
                      type: integer
                      description: Current temperature, in the unit named by `unit`.
                    unit:
                      type: string
                      description: Temperature unit of the card, F for Fahrenheit
                        or C for Celsius.
                    condition:
                      type: string
                      description: Current weather condition as text.
                    condition_icon:
                      type: string
                      description: Yahoo's icon code for the current condition.
                    humidity:
                      type: integer
                      description: Relative humidity in percent.
                    uv_index:
                      type: integer
                      description: Current UV index.
                    wind_speed:
                      type: integer
                      description: Current wind speed, as Yahoo shows it.
                    pressure:
                      type: number
                      description: Barometric pressure in inches of mercury.
                    precipitation_chance:
                      type: integer
                      description: Chance of precipitation in percent.
                    air_quality:
                      type: object
                      description: Current air quality at the location.
                      properties:
                        aqi:
                          type: integer
                          description: Air quality index Yahoo reports for the location.
                        description:
                          type: string
                          description: Air quality level in words, as Yahoo rates
                            it.
                      additionalProperties: false
                    moon_phase:
                      type: string
                      description: Name of the current moon phase.
                  additionalProperties: false
                forecast:
                  type: array
                  description: Daily forecast, one entry per day starting with the
                    current day.
                  items:
                    type: object
                    properties:
                      date:
                        type: string
                        description: Forecast day as an ISO 8601 date.
                      day_of_week:
                        type: string
                        description: English weekday name for `date`.
                      high:
                        type: integer
                        description: High temperature, in the unit named by `current.unit`.
                      low:
                        type: integer
                        description: Low temperature, in the unit named by `current.unit`.
                      condition:
                        type: string
                        description: Forecast weather condition for the day as text.
                      condition_icon:
                        type: string
                        description: Yahoo's icon code for the day's condition.
                      uv_index:
                        type: integer
                        description: UV index forecast for the day.
                      sunrise:
                        type: string
                        description: Local sunrise time as Yahoo shows it.
                      sunset:
                        type: string
                        description: Local sunset time as Yahoo shows it.
                      moon_phase:
                        type: string
                        description: Name of the moon phase on that day.
                      hourly:
                        type: array
                        description: Hour-by-hour readings for the hours of that day.
                        items:
                          type: object
                          properties:
                            time:
                              type: string
                              description: Local date and time of the reading, formatted
                                YYYY-MM-DD HH:MM.
                            temperature:
                              type: integer
                              description: Temperature at that hour, in the unit named
                                by `current.unit`.
                            precipitation_chance:
                              type: integer
                              description: Chance of precipitation in percent.
                            wind_speed:
                              type: integer
                              description: Wind speed at that hour, as Yahoo shows
                                it.
                          additionalProperties: false
                    additionalProperties: false
              additionalProperties: false
              required:
              - type
            - type: object
              properties:
                type:
                  type: string
                  description: The card type, which is always knowledge_entity for
                    this card.
                  enum:
                  - knowledge_entity
                name:
                  type: string
                  description: The entity's name.
                category:
                  type: string
                  description: The entity type as Yahoo classifies it.
                disambiguation:
                  type: string
                  description: A short qualifier distinguishing the entity.
                details:
                  type: object
                  description: The contents of the entity's knowledge panel.
                  properties:
                    description:
                      type: string
                      description: The lead summary paragraph of the entity card.
                    source:
                      type: object
                      description: The site the description comes from.
                      properties:
                        name:
                          type: string
                          description: Name of the site the description comes from.
                        link:
                          type: string
                          description: The destination URL.
                      additionalProperties: false
                    website:
                      type: string
                      description: URL of the entity's official website.
                    sections:
                      type: array
                      description: Labeled facts from the panel, with a film or show's
                        ratings listed first.
                      items:
                        type: object
                        properties:
                          title:
                            type: string
                            description: Label of the fact, or the name of the site
                              behind a rating.
                          text:
                            type: string
                            description: Value of the fact, with several values joined
                              by commas, or the rating's score.
                        additionalProperties: false
                    profiles:
                      type: array
                      description: The entity's pages on other sites, such as its
                        social profiles.
                      items:
                        type: object
                        properties:
                          name:
                            type: string
                            description: Name of the site the profile is on, as Yahoo
                              labels it.
                          link:
                            type: string
                            description: The destination URL.
                        additionalProperties: false
                    related_entities:
                      type: array
                      description: Entities related to this one, including the cast
                        of a film or show.
                      items:
                        type: object
                        properties:
                          name:
                            type: string
                            description: The related entity's name.
                          category:
                            type: string
                            description: The related entity type as Yahoo classifies
                              it.
                          query:
                            type: string
                            description: The click-through search query Yahoo ties
                              to this related entity.
                          id:
                            type: string
                            description: Yahoo's identifier for the related entity.
                          thumbnail:
                            type: string
                            description: Thumbnail image URL of the related entity.
                          subtitle:
                            type: string
                            description: The character a cast member plays in the
                              film or show.
                        additionalProperties: false
                    inline_images:
                      type: array
                      description: Images of the entity shown in the panel.
                      items:
                        type: object
                        properties:
                          title:
                            type: string
                            description: Image title.
                          thumbnail:
                            type: string
                            description: Thumbnail image URL.
                          original:
                            type: string
                            description: URL of the original image.
                          width:
                            type: integer
                            description: Image width in pixels.
                          height:
                            type: integer
                            description: Image height in pixels.
                        additionalProperties: false
                    streaming_offers:
                      type: array
                      description: Streaming services where the film or show can be
                        watched.
                      items:
                        type: object
                        properties:
                          provider:
                            type: string
                            description: Name of the streaming service.
                          price:
                            type: string
                            description: Cost of watching on the service as displayed,
                              a price or an access type.
                          link:
                            type: string
                            description: The destination URL.
                        additionalProperties: false
                  additionalProperties: false
              additionalProperties: false
              required:
              - type
            - type: object
              properties:
                type:
                  type: string
                  description: The card type, which is always finance for this card.
                  enum:
                  - finance
                source:
                  type: object
                  description: Who supplied the card's data.
                  properties:
                    name:
                      type: string
                      description: Name of the data provider.
                    link:
                      type: string
                      description: The destination URL.
                  additionalProperties: false
                symbol:
                  type: string
                  description: Ticker symbol.
                name:
                  type: string
                  description: Company or instrument name.
                exchange:
                  type: string
                  description: Listing exchange as Yahoo names it.
                price:
                  type: number
                  description: Latest price in the regular trading session, in the
                    currency named by `currency`.
                currency:
                  type: string
                  description: Three-letter currency code of the quote.
                change:
                  type: number
                  description: Price change from the previous close.
                change_percent:
                  type: number
                  description: Price change from the previous close, in percent.
                previous_close:
                  type: number
                  description: Previous session's closing price.
                market_cap:
                  type: integer
                  description: Approximate market capitalization in the quote currency,
                    expanded from an abbreviated figure.
                pe_ratio:
                  type: number
                  description: Price to earnings ratio over the trailing twelve months.
                dividend_yield:
                  type: number
                  description: Dividend yield in percent.
                price_open:
                  type: number
                  description: Opening price of the trading day.
                price_high:
                  type: number
                  description: Intraday high price.
                price_low:
                  type: number
                  description: Intraday low price.
                price_52w_high:
                  type: number
                  description: 52-week high price.
                price_52w_low:
                  type: number
                  description: 52-week low price.
                quote_time:
                  type: string
                  description: As-of time of the quote, in ISO 8601 UTC.
                is_market_open:
                  type: boolean
                  description: Whether the listing exchange is inside its regular
                    trading session.
                extended_hours:
                  type: object
                  description: Quote from outside the regular trading session.
                  properties:
                    price:
                      type: number
                      description: Extended-hours price.
                    change:
                      type: number
                      description: Absolute change versus the regular-session close.
                    change_percent:
                      type: number
                      description: Percent change versus the regular-session close.
                    session:
                      type: string
                      description: Extended session the quote belongs to.
                    quote_time:
                      type: string
                      description: As-of time of the extended-hours quote, in ISO
                        8601 UTC.
                  additionalProperties: false
              additionalProperties: false
              required:
              - type
            - type: object
              properties:
                type:
                  type: string
                  description: The card type, which is always sports for this card.
                  enum:
                  - sports
                title:
                  type: string
                  description: Heading of the card, naming the team or league it covers.
                league:
                  type: string
                  description: Yahoo's short code for the league.
                games:
                  type: array
                  description: Games featured on the card, each with its venue and
                    teams.
                  items:
                    type: object
                    properties:
                      id:
                        type: string
                        description: Yahoo's identifier for the game.
                      date:
                        type: string
                        description: Start time of the game in UTC.
                      status:
                        type: string
                        description: Game status as Yahoo shows it, which is the start
                          time for a game yet to begin.
                      link:
                        type: string
                        description: The destination URL.
                      venue:
                        type: string
                        description: Venue of the game with its city, as Yahoo shows
                          it.
                      teams:
                        type: array
                        description: Teams playing in the game.
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                              description: Yahoo's identifier for the team.
                            name:
                              type: string
                              description: Full name of the team.
                            score:
                              type: integer
                              description: The team's score in a game that has started.
                          additionalProperties: false
                    additionalProperties: false
                schedule:
                  type: array
                  description: The team's recent and upcoming games.
                  items:
                    type: object
                    properties:
                      id:
                        type: string
                        description: Yahoo's identifier for the game.
                      date:
                        type: string
                        description: Date of the game.
                      status:
                        type: string
                        description: Yahoo's code for the game's state, which tells
                          a finished game from an upcoming one.
                      link:
                        type: string
                        description: The destination URL.
                      home_team:
                        type: object
                        description: The team playing at home.
                        properties:
                          id:
                            type: string
                            description: Yahoo's identifier for the team.
                          name:
                            type: string
                            description: Full name of the team.
                          score:
                            type: integer
                            description: The team's score in a game that has started.
                        additionalProperties: false
                      away_team:
                        type: object
                        description: The visiting team.
                        properties:
                          id:
                            type: string
                            description: Yahoo's identifier for the team.
                          name:
                            type: string
                            description: Full name of the team.
                          score:
                            type: integer
                            description: The team's score in a game that has started.
                        additionalProperties: false
                    additionalProperties: false
                standings:
                  type: array
                  description: League standings, with a team listed once in each table
                    it is ranked in.
                  items:
                    type: object
                    properties:
                      team:
                        type: string
                        description: Full name of the team.
                      position:
                        type: integer
                        description: The team's rank in its table.
                      conference:
                        type: string
                        description: Grouping the team's table sits under, a conference
                          or the league's playoff view.
                      division:
                        type: string
                        description: Name of the table the team is ranked in, a division
                          or a conference-wide table.
                      played:
                        type: integer
                        description: Number of games the team has played.
                      wins:
                        type: integer
                        description: Number of games the team has won.
                      losses:
                        type: integer
                        description: Number of games the team has lost.
                      games_behind:
                        type: number
                        description: Games behind the table leader.
                      streak:
                        type: string
                        description: Current winning or losing streak.
                      last_10_record:
                        type: string
                        description: Win-loss record for the team's most recent games, up to ten.
                      winning_percentage:
                        type: number
                        description: Share of games the team has won, as a decimal
                          from 0 to 1.
                    additionalProperties: false
              additionalProperties: false
              required:
              - type
            - "$ref": "#/components/schemas/RawCard"
        product_phrases:
          type: array
          description: Phrases of the answer that Yahoo Scout links to a product search.
          items:
            type: object
            properties:
              phrase:
                type: string
                description: The phrase as it appears in the answer.
              query:
                type: string
                description: Product search query Yahoo Scout ties to the phrase.
              link:
                type: string
                description: The destination URL.
              seller:
                type: string
                description: Name of the retailer the product search is on, as Yahoo
                  labels it.
            additionalProperties: false
        inline_shopping:
          type: array
          description: Products Yahoo Scout recommends in the answer.
          items:
            type: object
            properties:
              position:
                type: integer
                description: The position in the result collection.
              title:
                type: string
                description: Product title.
              link:
                type: string
                description: The destination URL.
              price:
                type: string
                description: Product price as displayed, with its currency symbol.
              extracted_price:
                type: number
                description: Product price as a number, parsed from `price`.
              rating:
                type: number
                description: Average customer rating of the product.
              reviews:
                type: integer
                description: Number of customer reviews of the product.
              seller:
                type: string
                description: Name of the store selling the product.
              domain:
                type: string
                description: Domain of the store's website.
              description:
                type: string
                description: Yahoo Scout's short note on who the product suits.
              thumbnail:
                type: string
                description: Product image URL.
            additionalProperties: false
        local_results:
          type: array
          description: Local businesses Yahoo Scout lists with the answer.
          items:
            type: object
            properties:
              position:
                type: integer
                description: The position in the result collection.
              title:
                type: string
                description: Business name.
              link:
                type: string
                description: The destination URL.
              id:
                type: string
                description: Yahoo's identifier for the business.
              listing_id:
                type: string
                description: Identifier of the business's listing, as Yahoo provides
                  it.
              chain_id:
                type: string
                description: Yahoo's identifier for the chain the business belongs
                  to.
              type:
                type: string
                description: Business type or category.
              category_id:
                type: string
                description: Yahoo's identifier for the business category.
              rating:
                type: number
                description: Average review rating of the business.
              reviews:
                type: integer
                description: Number of reviews the rating is based on.
              reviews_source:
                type: string
                description: Name of the site the rating and reviews come from.
              price:
                type: string
                description: Price level of the business, shown as dollar signs.
              address:
                type: string
                description: Street address of the business.
              city:
                type: string
                description: City of the business.
              state:
                type: string
                description: State or region of the business.
              gps_coordinates:
                type: object
                description: GPS coordinates of the business.
                properties:
                  latitude:
                    type: number
                    description: Latitude in decimal degrees.
                  longitude:
                    type: number
                    description: Longitude in decimal degrees.
                additionalProperties: false
              phone:
                type: string
                description: Phone number of the business.
              open_state:
                type: string
                description: Current opening status as Yahoo shows it.
              is_closed:
                type: boolean
                description: Whether the business is currently closed.
              is_sponsored:
                type: boolean
                description: Whether the listing is a paid placement.
              website:
                type: string
                description: URL of the business's website.
              order:
                type: string
                description: URL for ordering from the business online.
              menu:
                type: string
                description: URL of the business's menu.
              thumbnail:
                type: string
                description: Business photo URL.
            additionalProperties: false
        product_highlights:
          type: array
          description: Phrases of the answer that Yahoo Scout ties to a sponsored
            product.
          items:
            type: object
            properties:
              position:
                type: integer
                description: The position in the result collection.
              phrase:
                type: string
                description: The phrase as it appears in the answer.
              product_id:
                type: string
                description: The seller's identifier for the product.
              title:
                type: string
                description: Product title.
              link:
                type: string
                description: The destination URL.
              tracking_link:
                type: string
                description: URL the ad links to, including its click tracking.
              extracted_price:
                type: number
                description: Product price as a number, in the currency named by `currency`.
              currency:
                type: string
                description: Three-letter currency code of the price.
              rating:
                type: number
                description: Average customer rating of the product.
              reviews:
                type: integer
                description: Number of customer reviews of the product.
              description:
                type: string
                description: Product description shown with the ad.
              thumbnail:
                type: string
                description: Product image URL.
              seller:
                type: string
                description: Name of the retailer selling the product, as Yahoo labels
                  it.
            additionalProperties: false
        inline_images:
          type: array
          description: Images Yahoo Scout shows with the answer.
          items:
            type: object
            properties:
              title:
                type: string
                description: Image title.
              link:
                type: string
                description: The destination URL.
              thumbnail:
                type: string
                description: Thumbnail image URL.
              original:
                type: string
                description: URL of the original image.
              width:
                type: integer
                description: Image width in pixels.
              height:
                type: integer
                description: Image height in pixels.
            additionalProperties: false
        inline_videos:
          type: array
          description: Videos Yahoo Scout shows with 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.
              source:
                type: string
                description: Name of the site hosting the video.
              duration:
                type: string
                description: Video duration in m:ss or h:mm:ss.
              date:
                type: string
                description: Publication date of the video as an ISO 8601 date.
              thumbnail:
                type: string
                description: Thumbnail image URL of the video.
            additionalProperties: false
      additionalProperties: false
      required:
      - search_metadata
      - search_parameters
    SearchParameters:
      type: object
      properties:
        engine:
          type: string
          enum:
          - yahoo_scout
          description: Set to yahoo_scout.
        q:
          type: string
          maxLength: 10000
          description: The question to send to Yahoo Scout, up to 10000 characters.
            The limit counts UTF-16 code units; a supplementary character such as
            an emoji counts as two.
        country:
          type: string
          enum:
          - us
          - gb
          - uk
          default: us
          description: The country for the answer. Keep the same country when continuing
            a conversation.
        conversation_token:
          type: string
          maxLength: 2048
          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 with no schema of its own, with the source's payload 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:
            - weather
            - knowledge_entity
            - finance
            - sports
        raw:
          type: object
          description: Provider-native card payload, preserved as-is; never empty
          minProperties: 1
