Top Items Report

Use a Customer Journey Analytics API Top Items Report to see the top-performing items for a specified dimension.

The CJA API Top Items Report is used as a specialized helper to identify top-performing items (ranked by a specified metric) for a specified dimension over a specified date range. The Top Items Report uses a GET method to retrieve data, instead of a POST method used in all other report requests.

To retrieve a Top Items Report, use the following endpoint:

GET https://cja.adobe.io/reports/topItems

Path segments

The following path segments are usually included in a Top Items Report GET request:

• dataview ID (required)
• dimension ID (required)
• metric ID
• date range
• limit

If no metric or date range is supplied in the path, the report will default to values for those items as set in the target dataview configuration. If no limit is supplied, the default value is determined by a fixed internal default on the backend of the reporting service.

The path segments above are included in an example URL path below:

GET /reports/topItems
  ?dataViewId=dv_12345
  &dimensionId=variables/country
  &metricId=metrics/visits
  &startDate=2026-03-01
  &endDate=2026-03-31
  &limit=50

Example request

data-slots=heading, code

data-repeat=1

data-languages=CURL

curl -X GET "https://cja.adobe.io/reports/topItems?limit=3&page=0&lookupNoneValues=true&dataId=dv_554445545&dimension=pages" \
  -H "accept: application/json" \
  -H "x-api-key: {API_KEY}" \
  -H "x-gw-ims-org-id: {ORG_ID}" \
  -H "Authorization: Bearer {ACCESS_TOKEN}"

Example response

data-slots=heading, code

data-repeat=1

data-languages=JSON

{
  "totalPages": 1,
  "firstPage": true,
  "lastPage": true,
  "numberOfElements": 3,
  "number": 0,
  "totalElements": 3,
  "columns": {
    "dimension": {
      "id": "variables/page",
      "type": "string"
    },
    "columnIds": [
      "0"
    ]
  },
  "rows": [
    {
      "itemId": "3306266643",
      "value": "home",
      "data": [
        219567
      ]
    },
    {
      "itemId": "2796092754",
      "value": "category 5",
      "data": [
        90943
      ]
    },
    {
      "itemId": "1738577623",
      "value": "category 2",
      "data": [
        84192
      ]
    }
  ],
  "summaryData": {
    "filteredTotals": [
      3080619
    ],
    "totals": [
      3080619
    ]
  }
}

Example request details

The example above requests a Top Items Report with the following:

• The dimension pages within the dataview dv_554445545.
• Because no date range is supplied, the default target dataview setting (such as Last 30 days), is used.
• Becuase no metric is supplied, the default dataview setting (such as Events), is used.
• A limit of three items.

Example response details

The example above returns the top three items (those with the highest metric counts) in descending order:

• The page home with a count of 219567.
• The page category 5 with a count of 90943.
• The page category 2 with a count of 84192.

Request parameters

The following table describes the request parameters for the GET /reports/topItems endpoint:

Response parameters

The following table describes the response parameters for the GET /reports/topItems endpoint:

More information

For general information on the Customer Journey Analytics API Report endpoint, see the Reporting API Overview. See the CJA API reference for complete data models of the CJA APIs.