List dimension options — HTTP

Discover the filter labels available for the project. Method: GET Path: /projects/{project_id}/dimension-options Use the HTTP base for your authorized environment and an Authorization: Bearer header. See authentication and HTTP setup.

Parameters

This table covers the standard read profile. It excludes internal application routes and advanced analysis controls.

Name	Location	Type	Required	Default	Meaning
`project_id`	path	string	Yes	—	Project ID from list_projects. Select the project in the intended workspace and environment.

Request example

Set IQRUSH_API_BASE and IQRUSH_ACCESS_TOKEN through secure configuration. Replace project/run IDs and sample selections with values returned by your account. JSON objects and arrays are encoded as query strings.

curl --fail-with-body --silent --show-error --get \
  --header "Authorization: Bearer ${IQRUSH_ACCESS_TOKEN}" \
  --header "Accept: application/json" \
  "${IQRUSH_API_BASE%/}/projects/${IQRUSH_PROJECT_ID}/dimension-options"

Read the response

Top-level dimensions contains option arrays for platform, topic, prompt_type, intent, and user_profile. The options describe the latest run. Historical runs can differ. Use exact labels and inspect warnings on the actual measurement response.

Fields to use

These selected fields explain the example and the result to preserve. Field presence depends on the response; this is not a complete response schema.

Field	Meaning and use
`dimensions.platform`	Platform labels available from the latest run.
`dimensions.topic`	Measured topic labels available from the latest run.
`dimensions.prompt_type`	Category facet labels for query and measurement selection.
`dimensions.intent`	Customer Intent labels for selection.
`dimensions.user_profile`	Measured profile labels when present. An empty list does not establish a persona filter.

Selected response fields from IQRush Dev. Lists are shortened and project/run IDs are placeholders; this is not the full response.

{
  "project_id": "PROJECT_ID",
  "dimensions": {
    "platform": [
      "ChatGPT Search",
      "Gemini"
    ],
    "topic": [
      "Reapplication and Active Mineral SPF",
      "Tinted Mineral Face SPF"
    ],
    "prompt_type": [
      "common complaints",
      "expert recommendations",
      "feature comparisons",
      "how to choose",
      "popular options",
      "reliability and quality",
      "reputation and credibility",
      "reviews and ratings",
      "strengths and weaknesses",
      "user recommendations",
      "value for money",
      "what to look for"
    ],
    "intent": [
      "commercial",
      "informational",
      "transactional"
    ],
    "user_profile": []
  }
}

Read the actual returned scope, counts, and interval levels before interpreting these fields. MCP equivalent: list_dimension_options. Use the parameters and defaults on this page for HTTP.

If the result is unavailable

Check HTTP status and the response’s error field before using data. A successful empty response does not establish a zero value. Preserve not_available, not_available_reason, unavailable_reason, and linked where returned. Errors and recovery shows observed examples.

Get started

Connect securely

Read measurements

Build dependable integrations

Build reports

Report recipes

Reference

Session and discovery

Visibility measurements

Sources and evidence

Changes and trends

Google data

Pages and report planning

HTTP operations

List dimension options — HTTP

Parameters

Request example

Read the response

Fields to use

If the result is unavailable

​Parameters

​Request example

​Read the response

​Fields to use

​If the result is unavailable

Parameters

Request example

Read the response

Fields to use

If the result is unavailable