Coveo · JSON Structure

Coveo Search Restqueryparentresult Structure

Type: Properties: 0
AIAnalyticsCatalogCommerceCustomersExperiencesMachine LearningPersonalizationRecommendationsSearch

RestQueryParentResult is a JSON Structure definition published by Coveo.

Meta-schema:

JSON Structure

Raw ↑
{
  "name": "RestQueryParentResult",
  "structure": {
    "anyOf": [
      {
        "required": [
          "absentTerms",
          "childResults",
          "clickUri",
          "excerpt",
          "excerptHighlights",
          "firstSentences",
          "firstSentencesHighlights",
          "flags",
          "hasHtmlVersion",
          "hasMobileHtmlVersion",
          "isRecommendation",
          "isTopResult",
          "isUserActionView",
          "parentResult",
          "percentScore",
          "printableUri",
          "printableUriHighlights",
          "rankingInfo",
          "rating",
          "raw",
          "score",
          "summary",
          "summaryHighlights",
          "title",
          "titleHighlights",
          "totalNumberOfChildResults",
          "uniqueId",
          "primaryid",
          "uri"
        ],
        "type": "object",
        "properties": {
          "title": {
            "type": "string",
            "description": "The item title.  \n  \n**Note:** When logging a **Click** usage analytics event for an opened query result item, the `documentTitle` field of that event should be set to the `title` value of the opened query result item.",
            "example": "Differences between Coveo Cloud V2 and V1"
          },
          "uri": {
            "type": "string",
            "description": "The item URI.\n\n**Notes:**\n\n- Avoid using the `uri` value to create hyperlinks to the item. Use the `ClickUri` value instead.\n- When logging a **Click** usage analytics event for an opened query result item, the `documentUrl` field of that event should be set to the `uri` value of the opened query result item.",
            "example": "https://example.com/Root:0/topic:898/post:2"
          },
          "printableUri": {
            "type": "string",
            "description": "The human readable item URI.\n\n**Note:** Avoid using the `printableUri` value to create hyperlinks to the item. Use the `ClickUri` value instead.",
            "example": "https://example.com/topic:898/post:2"
          },
          "clickUri": {
            "type": "string",
            "description": "The hyperlinkable item URI.\n\n**Notes:**\n\n- Use the `clickUri` value when you want to create hyperlinks to the item, rather than the `uri` or `printableUri` value.\n- The `clickUri` value is not necessarily unique for each item.",
            "example": "https://example.com/t/1/898/2"
          },
          "uniqueId": {
            "type": "string",
            "description": "The unique item identifier. You should consider the `uniqueId` value as an opaque string.",
            "example": "84.72597$https://example.com/Root:0/Topic:898/Post:2"
          },
          "primaryid": {
            "type": "string",
            "nullable": true,
            "description": "The primary identifier of the item. See [primaryid field](https://docs.coveo.com/en/pa9c0434) for more details.",
            "example": "KVUVKMCSIZLEYVLVMNLGQ4JQK4XDMNBQGY4C4ZDFMZQXK3DU"
          },
          "excerpt": {
            "type": "string",
            "description": "The contextual excerpt generated for the item (see the `excerptLength` query parameter).",
            "example": "... the new Coveo Cloud V2 and Coveo Cloud V1 ... the main differences between the two Coveo Cloud versions ..."
          },
          "firstSentences": {
            "type": "string",
            "nullable": true,
            "description": "The first sentences retrieved from the item (see the `retrieveFirstSentences` query parameter).",
            "example": "Hello, I know Coveo currently hosts organizations in two independent cloud platforms, the new Coveo Cloud V2 and Coveo Cloud V1, the original Coveo offering in the cloud. I would like to learn the main differences between the two Coveo Cloud versions ..."
          },
          "summary": {
            "type": "string",
            "nullable": true,
            "description": "The item summary (see the `summaryLength` query parameter)."
          },
          "flags": {
            "type": "string",
            "description": "The flags that are set on the item by the index. Distinct values are separated by semicolons.",
            "example": "HasHtmlVersion;HasMobileHtmlVersion"
          },
          "hasHtmlVersion": {
            "type": "boolean",
            "description": "Whether the index contains an HTML version of this item.",
            "example": true
          },
          "hasMobileHtmlVersion": {
            "type": "boolean",
            "description": "Whether the index contains a mobile HTML version of this item.",
            "example": true
          },
          "score": {
            "type": "integer",
            "description": "The total ranking score computed for the item (see the `sortCriteria` and `rankingFunctions` query parameters).",
            "format": "int32",
            "example": 1626
          },
          "percentScore": {
            "type": "number",
            "description": "The item ranking score expressed as a percentage (see the `sortCriteria` and `rankingFunctions` query parameters).",
            "format": "double",
            "example": 90.73539
          },
          "rankingInfo": {
            "type": "string",
            "nullable": true,
            "description": "The raw debug information generated by the index to detail how the item was ranked. This property is `null` unless the `debug` query parameter is set to `true`.",
            "example": "Document weights:\nTitle: 0; Quality: 180; Date: 596; Adjacency: 0; Source: 500; Custom: 350; Collaborative rating: 0; QRE: 0; Ranking functions: 0;\n\nTotal weight: 1626"
          },
          "rating": {
            "type": "number",
            "description": "**Note:** The value of this property is always `3`.",
            "format": "double",
            "example": 3
          },
          "isTopResult": {
            "type": "boolean",
            "description": "Whether the item score was boosted by a featured result rule in the query pipeline.",
            "example": false
          },
          "isRecommendation": {
            "type": "boolean",
            "description": "Whether the item score was boosted as a Coveo ML recommendation.",
            "example": false
          },
          "isUserActionView": {
            "type": "boolean",
            "description": "Whether the item score was boosted as a Coveo ML recommendation.",
            "example": false
          },
          "rankingModifier": {
            "type": "string",
            "description": "If applicable, represents the type of ranking modification that was applied to this result.  \n  \n**Note:** When logging a **Click** usage analytics event for an opened query result item, the `rankingModifier` field of that event should be set to the `rankingModifier` value of the opened query result item, if available.",
            "example": "TopResult"
          },
          "titleHighlights": {
            "type": "array",
            "description": "The length and offset of each word to highlight in the item `title` string.",
            "items": {
              "$ref": "#/components/schemas/RestHighlightResponse"
            }
          },
          "firstSentencesHighlights": {
            "type": "array",
            "description": "The length and offset of each word to highlight in the item `firstSentences` string.",
            "items": {
              "$ref": "#/components/schemas/RestHighlightResponse"
            }
          },
          "excerptHighlights": {
            "type": "array",
            "description": "The length and offset of each word to highlight in the item `excerpt` string.",
            "items": {
              "$ref": "#/components/schemas/RestHighlightResponse"
            }
          },
          "printableUriHighlights": {
            "type": "array",
            "description": "The length and offset of each word to highlight in the item `printableUri` string.",
            "items": {
              "$ref": "#/components/schemas/RestHighlightResponse"
            }
          },
          "summaryHighlights": {
            "type": "array",
            "description": "The length and offset of each word to highlight in the item `summary` string.",
            "items": {
              "$ref": "#/components/schemas/RestHighlightResponse"
            }
          },
          "parentResult": {
            "$ref": "#/components/schemas/RestQueryParentResult"
          },
          "childResults": {
            "type": "array",
            "description": "An array of references to the children of this item, if result folding was applied (see the `filterField` query parameter). The query results contained in this field will have both their parent and child results set to `null`.",
            "items": {
              "anyOf": [
                {
                  "$ref": "#/components/schemas/RestQueryResult"
                }
              ]
            }
          },
          "totalNumberOfChildResults": {
            "type": "integer",
            "description": "The total number of children available in the index for this item, if result folding was applied (see the `filterField` query parameter).",
            "format": "int64"
          },
          "absentTerms": {
            "type": "array",
            "description": "The basic query expression terms which this query result item does not match.\n\n**Note:**\n> This property is populated by terms from the query pipeline-processed `q` value (not from the original `q` value).",
            "example": [
              "platform",
              "native",
              "solution"
            ],
            "items": {
              "type": "string"
            }
          },
          "raw": {
            "type": "object",
            "additionalProperties": true,
            "description": "The values of the fields which were retrieved for this item (see the `fieldsToInclude` and `fieldsToExclude` query parameters).",
            "example": {
              "clickableuri": "https://example.com/t/1/898/2",
              "author": "Anonymous",
              "date": 1502796809427,
              "filetype": "forumpost",
              "language": [
                "English"
              ],
              "conversationid": 898,
              "messageid": 2,
              "childid": 2,
              "adjustednumberoflikes": 46
            }
          },
          "Title": {
            "type": "string",
            "description": "> This property is deprecated; it should not be populated by Search API V2 searches.",
            "deprecated": true
          },
          "Uri": {
            "type": "string",
            "description": "> This property is deprecated; it should not be populated by Search API V2 searches.",
            "deprecated": true
          },
          "PrintableUri": {
            "type": "string",
            "description": "> This property is deprecated; it should not be populated by Search API V2 searches.",
            "deprecated": true
          },
          "ClickUri": {
            "type": "string",
            "description": "> This property is deprecated; it should not be populated by Search API V2 searches.",
            "deprecated": true
          },
          "UniqueId": {
            "type": "string",
            "description": "> This property is deprecated; it should not be populated by Search API V2 searches.",
            "deprecated": true
          },
          "Excerpt": {
            "type": "string",
            "description": "> This property is deprecated; it should not be populated by Search API V2 searches.",
            "deprecated": true
          },
          "FirstSentences": {
            "type": "string",
            "description": "> This property is deprecated; it should not be populated by Search API V2 searches.",
            "deprecated": true
          }
        }
      },
      {
        "type": "object",
        "nullable": true
      }
    ]
  }
}