Find keyword cannibalization
Queries for which several of your pages each get a real share of the impressions, found from Search Console query and page data.
https://api.rankparse.com/v1/gsc/cannibalizationFreeAPI key + connected Google accountReads the query and page rows for a date range and groups them per query. A query is reported when two or more different pages each get a real share of its impressions, because those pages split clicks and rankings between them. Each result lists the competing pages with their clicks, impressions, share and average position, the top page by clicks, and split_impressions, the impressions the other pages received.
The same page reached through several URLs (http and https, with and without www, a trailing slash, a query string or a fragment) is merged into one page first. A query where that is the only duplication comes back as kind: "url_variants": a canonical problem, fixed by pointing the variants at one canonical URL, not a cannibalization problem. Check which canonical Google chose with Inspect URLs.
Query parameters
sitestringrequiredThe property, or a bare host such as example.com, matched to a property you own. See Query search analytics for how a site is matched.
startDatestringrequiredFirst day, YYYY-MM-DD.
endDatestringrequiredLast day, YYYY-MM-DD. It must not be before startDate.
minQueryImpressionsnumberdefault 50A query needs at least this many impressions across its pages.
minPageImpressionsnumberdefault 5A page competes when it has at least this many impressions for the query.
minPageSharenumberdefault 0.1A page competes when it also has at least this share of the query's impressions, between 0.01 and 0.5.
limitintegerdefault 25Queries to return, 1 to 100, ordered by split_impressions.
Response
queriesarrayOne entry per query: query, kind (cannibalization or url_variants), total_clicks, total_impressions, top_page, split_impressions, position_spread (worst position minus best among the competing pages) and pages, each with page, clicks, impressions, share, position and, when URLs were merged, variants.
total_matchedintegerQueries that matched before limit, with cannibalization_count and url_variants_count splitting them by kind.
rows_scannedintegerQuery and page rows read from Search Console.
truncatedbooleanPresent and true when Search Console had more than 3000 rows. They are read in order of clicks, so the long tail of small queries is missing, and note says so. Use a shorter date range to see more.
Behavior and limits
- Credits: 0. It reads Google live, up to three calls of 1000 rows each.
- Web search only. Image, video, news and Discover rows are not included.
Errors
| HTTP | Code | When |
|---|---|---|
| 400 | missing_site, missing_dates, invalid_date, invalid_param | A parameter is missing or out of range. |
| 400, 401, 403, 404, 429, 502, 503 | Search Console codes | The same as Query search analytics. |
| 401 | invalid_api_key | Missing, invalid or revoked API key. |
| 429 | rate_limited | More than 60 requests per minute for this key. |
Related
MCP tool: get_gsc_cannibalization.