AgentSEO Page Intersection
agentseo_page_intersectionDestructive
Compares ranking keywords across up to five pages to reveal shared terms or competitor keywords missing from your pages, so you can find content gaps and prioritize SEO opportunities.
Instructions
Compare ranking pages to find shared page keywords or competitor-page keywords excluded from your pages. Uses AgentSEO credits; repeating the call can create new charged work.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"pages": "<pages>"
},
"name": "agentseo_page_intersection"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sync | No | Request a bounded wait for completion when true. The API can still return a pending job; retain its job ID and poll agentseo_job_status instead of repeating this charged call. False returns a queued job without waiting. Type: Boolean. Default: true. | |
| limit | No | Maximum number of keyword intersection records to return. Type: Safe integer. Minimum: 5. Maximum: 100. Default: 25. | |
| pages | Yes | Absolute page URLs whose ranking keywords should be compared; these are URLs, not supplied page objects. Type: Array. Minimum: 1 items. Maximum: 5 items. Required. | |
| offset | No | Zero-based result offset measured in rows; use with limit for pagination. Type: Safe integer. Minimum: 0. Maximum: 20000. Default: 0. | |
| sort_by | No | Metric used to order returned results; choose one of this tool’s accepted enum values. Type: String. Accepted values: "opportunity", "search_volume", "traffic_gap", "rank", "cpc". Default: "opportunity". | opportunity |
| language | No | Supported search language code, for example en for English. Type: String. Default: "en". | en |
| location | No | Supported geographic search-market name, for example United States; this is not a coordinate pair. Type: String. Default: "United States". | United States |
| max_rank | No | Worst organic search position to include, where 1 means first. Type: Safe integer. Minimum: 1. Maximum: 100. Default: 30. | |
| item_types | No | Search-result categories to include in the page intersection analysis. Type: Array. Minimum: 1 items. Maximum: 4 items. Default: ["organic","featured_snippet"]. | |
| exclude_pages | No | Absolute page URLs to exclude from the keyword intersection comparison. Type: Array. Maximum: 5 items. Default: []. | |
| location_code | No | Numeric provider location identifier for the search market; the service validates support alongside the location name. Type: Safe integer. Must be greater than 0. Optional; no client default. | |
| ignore_synonyms | No | Ask the provider not to expand keyword matching to synonyms when true. Type: Boolean. Default: true. | |
| include_serp_info | No | Include provider search-result context in the returned records when true. Type: Boolean. Default: false. | |
| intersection_mode | No | Whether matches must cover every supplied target (all) or a supported subset (partial). Type: String. Accepted values: "union", "intersect". Default: "union". | union |
| min_search_volume | No | Minimum estimated monthly keyword searches to include; zero disables this lower-bound filter. Type: Safe integer. Minimum: 0. Maximum: 10000000. Default: 0. | |
| include_subdomains | No | Include links or ranking data for subdomains of the target when true. Type: Boolean. Default: true. | |
| include_clickstream_data | No | Request available provider clickstream-derived estimates when true; these are not your own analytics measurements. Type: Boolean. Default: false. |