Cox Automotive

Kelley Blue Book IDWS 4.0 Editorial Service

InfoDriver Web Service (IDWS) 4.0 Editorial Service — Kelley Blue Book consumer ratings, consumer reviews, expert ratings, expert reviews and Top Ten lists for a vehicle, returned as JSON and authenticated with a Mashery api_key query parameter.

GitHub OpenAPI

Operations 6

GET /idws/editorial/consumerratings/id/{vehicleId} Gets a list of Consumer Ratings for a given vehicle #
GET /idws/editorial/ConsumerReviews Gets a list of Consumer Reviews for a given vehicle #
GET /idws/editorial/errorcodes #
GET /idws/editorial/expertratings/id/{vehicleId} Gets the Kelley Blue Book Expert Ratings for a vehicle. #
GET /idws/editorial/expertreviews/id/{vehicleId} Gets the Kelley Blue Book Expert Reviews for a vehicle. #
GET /idws/editorial/toptenlists Returns a list of the Top Ten Lists available on kbb.com. Each list includes a list of vehicles that are on that particular Top Ten List. #

Documentation

📖
Documentation
https://developer.kbb.com/idws/1-Default
📖
APIReference
https://developer.kbb.com/idws/98-Swagger-EDT

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/cox-automotive/refs/heads/main/openapi/cox-automotive-kbb-idws-editorial-openapi.yml

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/cox-automotive/refs/heads/main/overlays/cox-automotive-kbb-idws-editorial-overlay.yaml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/kbb-idws-editorial"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

cox-automotive-kbb-idws-editorial-openapi.yml Raw ↑ 
swagger: '2.0'
info:
  version: v1
  title: IDWS Editorial Service
schemes:
- https
host: idws-sandbox.datasolutions.coxautoinc.com
paths:
  /idws/editorial/consumerratings/id/{vehicleId}:
    get:
      tags:
      - ConsumerRatings
      summary: Gets a list of Consumer Ratings for a given vehicle
      operationId: IdwsEditorialConsumerratingsIdByVehicleIdGet
      consumes: []
      produces:
      - application/json
      parameters:
      - name: vehicleId
        in: path
        description: The vehicle for which to fetch Consumer Ratings
        required: true
        type: integer
        format: int32
      responses:
        '200':
          description: Success
          schema:
            type: array
            items:
              $ref: '#/definitions/IDWS.Editorial.Contracts.Contracts.V1.ConsumerRatingResponse'
        '400':
          description: Bad Request
          schema:
            $ref: '#/definitions/IDWS.Platform.ResponseMessage.ReturnResponse'
        '401':
          description: Unauthorized
        '500':
          description: Server Error
  /idws/editorial/ConsumerReviews:
    get:
      tags:
      - ConsumerReviews
      summary: Gets a list of Consumer Reviews for a given vehicle
      operationId: IdwsEditorialConsumerReviewsGet
      consumes: []
      produces:
      - application/json
      parameters:
      - name: vehicleId
        in: query
        description: The vehicle for which to fetch Consumer Reviews
        required: false
        type: integer
        format: int32
      - name: sortBy
        in: query
        description: 'One of: mosthelpful, newestdate, oldestdate, highestrating, lowestrating'
        required: false
        type: string
      - name: limit
        in: query
        description: Maximum number of reviews to return. The maximum limit is 100 reviews.
        required: false
        type: integer
        format: int32
      - name: start
        in: query
        description: Index of the review that begins the return set
        required: false
        type: integer
        format: int32
      responses:
        '200':
          description: Success
          schema:
            type: array
            items:
              $ref: '#/definitions/IDWS.Editorial.Contracts.Contracts.V1.ConsumerReview'
        '400':
          description: Bad Request
          schema:
            $ref: '#/definitions/IDWS.Platform.ResponseMessage.ReturnResponse'
        '401':
          description: Unauthorized
        '500':
          description: Server Error
  /idws/editorial/errorcodes:
    get:
      tags:
      - ErrorCodes
      operationId: IdwsEditorialErrorcodesGet
      consumes: []
      produces:
      - application/json
      parameters: []
      responses:
        '200':
          description: Success
          schema:
            type: array
            items:
              type: string
        '400':
          description: Bad Request
          schema:
            $ref: '#/definitions/IDWS.Platform.ResponseMessage.ReturnResponse'
        '401':
          description: Unauthorized
        '500':
          description: Server Error
  /idws/editorial/expertratings/id/{vehicleId}:
    get:
      tags:
      - ExpertRatings
      summary: Gets the Kelley Blue Book Expert Ratings for a vehicle.
      operationId: IdwsEditorialExpertratingsIdByVehicleIdGet
      consumes: []
      produces:
      - application/json
      parameters:
      - name: vehicleId
        in: path
        description: The vehicleId for which to fetch the Expert Ratings
        required: true
        type: integer
        format: int32
      responses:
        '200':
          description: Success
          schema:
            $ref: '#/definitions/IDWS.Editorial.Contracts.Contracts.V1.ExpertRatingResponse'
        '400':
          description: Bad Request
          schema:
            $ref: '#/definitions/IDWS.Platform.ResponseMessage.ReturnResponse'
        '401':
          description: Unauthorized
        '500':
          description: Server Error
  /idws/editorial/expertreviews/id/{vehicleId}:
    get:
      tags:
      - ExpertReviews
      summary: Gets the Kelley Blue Book Expert Reviews for a vehicle.
      operationId: IdwsEditorialExpertreviewsIdByVehicleIdGet
      consumes: []
      produces:
      - application/json
      parameters:
      - name: vehicleId
        in: path
        description: The vehicleId for which to fetch the Expert Reviews
        required: true
        type: integer
        format: int32
      responses:
        '200':
          description: Success
          schema:
            $ref: '#/definitions/IDWS.Editorial.Contracts.Contracts.V1.ExpertReviewResponse'
        '400':
          description: Bad Request
          schema:
            $ref: '#/definitions/IDWS.Platform.ResponseMessage.ReturnResponse'
        '401':
          description: Unauthorized
        '500':
          description: Server Error
  /idws/editorial/toptenlists:
    get:
      tags:
      - TopTenLists
      summary: Returns a list of the Top Ten Lists available on kbb.com. Each list includes a list of vehicles that are on
        that particular Top Ten List.
      operationId: IdwsEditorialToptenlistsGet
      consumes: []
      produces:
      - application/json
      parameters:
      - name: vehicleId
        in: query
        description: Only returns lists that contain the requested vehicleId. If vehicleId is supplied, then yearId, makeId,
          and modelId are ignored
        required: false
        type: integer
        format: int32
      - name: yearId
        in: query
        description: Only returns lists that contain vehicles having the requested yearId
        required: false
        type: integer
        format: int32
      - name: makeId
        in: query
        description: Only returns lists that contain vehicles having the requested makeId
        required: false
        type: integer
        format: int32
      - name: modelId
        in: query
        description: Only returns lists that contain vehicles having the requested modelId
        required: false
        type: integer
        format: int32
      - name: limit
        in: query
        description: Number of lists to return. Default is 5.
        required: false
        type: integer
        format: int32
      - name: start
        in: query
        description: Index of the list that begins the returned set.
        required: false
        type: integer
        format: int32
      responses:
        '200':
          description: Success
          schema:
            $ref: '#/definitions/IDWS.Editorial.Contracts.Contracts.V1.TopTenListsResponse'
        '400':
          description: Bad Request
          schema:
            $ref: '#/definitions/IDWS.Platform.ResponseMessage.ReturnResponse'
        '401':
          description: Unauthorized
        '500':
          description: Server Error
definitions:
  IDWS.Editorial.Contracts.Contracts.V1.ConsumerRatingResponse:
    type: object
    properties:
      vehicleId:
        format: int32
        type: integer
      generationName:
        type: string
      generationStartYear:
        type: string
      generationEndYear:
        type: string
      numberOfReviews:
        format: int32
        type: integer
      ratingScale:
        format: int32
        type: integer
      ratings:
        type: array
        items:
          $ref: '#/definitions/IDWS.Editorial.Contracts.Contracts.V1.Rating'
  IDWS.Editorial.Contracts.Contracts.V1.Rating:
    type: object
    properties:
      name:
        type: string
      value:
        type: string
  IDWS.Platform.ResponseMessage.ReturnResponse:
    type: object
    properties:
      errors:
        type: array
        items:
          $ref: '#/definitions/IDWS.Platform.ResponseMessage.ReturnResponse+ResponseMessage'
      warnings:
        type: array
        items:
          $ref: '#/definitions/IDWS.Platform.ResponseMessage.ReturnResponse+ResponseMessage'
  IDWS.Platform.ResponseMessage.ReturnResponse+ResponseMessage:
    type: object
    properties:
      code:
        type: string
      message:
        type: string
  IDWS.Editorial.Contracts.Contracts.V1.ConsumerReview:
    type: object
    properties:
      productId:
        format: int32
        type: integer
      reviewId:
        format: int32
        type: integer
      generationName:
        type: string
      generationStartYear:
        type: string
      generationEndYear:
        type: string
      submissionDate:
        type: string
      nickName:
        type: string
      year:
        format: int32
        type: integer
      title:
        type: string
      pros:
        type: string
      cons:
        type: string
      characterCount:
        format: int32
        type: integer
      text:
        type: string
      ownershipStatus:
        type: string
      mileage:
        format: int32
        type: integer
      numberOfFeedbacks:
        format: int32
        type: integer
      numberOfPositiveFeedbacks:
        format: int32
        type: integer
      overallRating:
        format: int32
        type: integer
      value:
        format: int32
        type: integer
      reliability:
        format: int32
        type: integer
      comfort:
        format: int32
        type: integer
      quality:
        format: int32
        type: integer
      performance:
        format: int32
        type: integer
      styling:
        format: int32
        type: integer
      recommendation:
        format: int32
        type: integer
      ratingScale:
        format: int32
        type: integer
  IDWS.Editorial.Contracts.Contracts.V1.ExpertRatingResponse:
    type: object
    properties:
      ratings:
        type: array
        items:
          $ref: '#/definitions/IDWS.Editorial.Contracts.Contracts.V1.ExpertRatingResponse+Rating'
      ratingScale:
        format: int32
        type: integer
        readOnly: true
      year:
        format: int32
        type: integer
      make:
        type: string
      model:
        type: string
      vehicleId:
        format: int32
        type: integer
  IDWS.Editorial.Contracts.Contracts.V1.ExpertRatingResponse+Rating:
    type: object
    properties:
      name:
        type: string
      value:
        type: string
  IDWS.Editorial.Contracts.Contracts.V1.ExpertReviewResponse:
    type: object
    properties:
      year:
        format: int32
        type: integer
      make:
        type: string
      model:
        type: string
      reviewSections:
        type: array
        items:
          $ref: '#/definitions/IDWS.Editorial.Contracts.Contracts.V1.ReviewSection'
      authorName:
        type: string
      publishDate:
        type: string
  IDWS.Editorial.Contracts.Contracts.V1.ReviewSection:
    type: object
    properties:
      sectionHeader:
        type: string
      text:
        type: string
  IDWS.Editorial.Contracts.Contracts.V1.TopTenListsResponse:
    type: object
    properties:
      topTenLists:
        type: array
        items:
          $ref: '#/definitions/IDWS.Editorial.Contracts.Contracts.V1.TopTenListsResponse+TopTenList'
  IDWS.Editorial.Contracts.Contracts.V1.TopTenListsResponse+TopTenList:
    type: object
    properties:
      topTenListTitle:
        type: string
      overviewUrl:
        type: string
      vehicles:
        type: array
        items:
          $ref: '#/definitions/IDWS.Editorial.Contracts.Contracts.V1.TopTenListsResponse+TopTenVehicle'
  IDWS.Editorial.Contracts.Contracts.V1.TopTenListsResponse+TopTenVehicle:
    type: object
    properties:
      articleTitle:
        type: string
      articleUrl:
        type: string
      rank:
        format: int32
        type: integer
      yearId:
        format: int32
        type: integer
      makeId:
        format: int32
        type: integer
      modelId:
        format: int32
        type: integer
      vehicleId:
        format: int32
        type: integer
securityDefinitions:
  apiKey:
    name: api_key
    in: query
    type: apiKey
    description: Mashery API Key
security:
- apiKey: []