Read cited page targets

Read a page of source URLs ranked by citation share. MCP tool: get_placement_targets. Operation: read. Uses the authorized connection; no project or content changes are made by this tool.

Parameters

Name	Type	Required	Default	Meaning and accepted values
`project_id`	string	Yes	`Required`	Project ID from list_projects. Select the project in the intended workspace and environment.
`run_id`	string	Yes	`Required`	Run ID from list_runs for this project. Use the exact returned value and check readiness before reading measurements.
`limit`	integer	No	`20`	Maximum target URLs on this page. Use next_offset to continue through the available list. Minimum 1. Maximum 200.
`offset`	integer	No	`0`	Zero-based position at which to start the placement-target page. Use next_offset from the previous response. Minimum 0.

Example call

Replace ID placeholders and example selections with values from your account. This is the params object for MCP tools/call.

{
  "name": "get_placement_targets",
  "arguments": {
    "project_id": "PROJECT_ID",
    "run_id": "RUN_ID",
    "limit": 20,
    "offset": 0
  }
}

Read the response

Top-level targets includes URLs with citation_share and citation_coverage estimates. Top-level count is the current page; n_available is the full list; next_offset is null at the end. This response has no data wrapper.

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
`targets[].url`	Cited page that can be reviewed as a placement target; appearance here is not a placement agreement.
`targets[].citation_share`	Page citation-share estimate with unit and interval.
`targets[].citation_coverage`	Page citation-coverage estimate with unit and interval.
`count`	Number of URLs returned on this page of the full response.
`n_available`	Number of available target URLs before pagination.
`next_offset`	Offset for the next page; null means the list has ended.

Response example

Selected fields from an observed IQRush Dev response. Lists are shortened and project/run IDs are placeholders. Omitted fields remain available in the actual response.

{
  "targets": [
    {
      "url": "https://www.aad.org/public/everyday-care/sun-protection/shade-clothing-sunscreen/choosing-right-sunscreen",
      "citation_share": {
        "value": 0.03,
        "unit": "proportion",
        "ci": {
          "lower": 0.02,
          "upper": 0.04,
          "level": 0.95
        },
        "n": null,
        "stability": null
      },
      "citation_coverage": {
        "value": 0.092,
        "unit": "proportion",
        "ci": {
          "lower": 0.067,
          "upper": 0.11599999999999999,
          "level": 0.95
        },
        "n": null,
        "stability": null
      }
    }
  ],
  "count": 20,
  "n_available": 1567,
  "offset": 0,
  "next_offset": 20
}

Read the actual returned scope, counts, and interval levels before interpreting these fields.

Important behavior

For URL-level measurements with dimension filters, use get_citation_score with aggregation_level: url instead. Check tool and payload errors before using the result. Response handling explains estimates and empty results; errors and recovery covers invalid requests and temporary failures. HTTP equivalent: Read cited page targets. HTTP parameters and defaults can differ.

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

Read cited page targets

Parameters

Example call

Read the response

Fields to use

Response example

Important behavior

​Parameters

​Example call

​Read the response

​Fields to use

​Response example

​Important behavior

Parameters

Example call

Read the response

Fields to use

Response example

Important behavior