Page intersection

Compare ranking pages to find shared page keywords or competitor-page keywords excluded from your pages. Costs 5 credits per 100 requested keywords, minimum 5. Clickstream enrichment doubles credit cost.

post/pages/intersection

Request

  • Base URL: https://www.agentseo.dev/api/v1
  • URL: https://www.agentseo.dev/api/v1/pages/intersection
  • Auth: API key in header x-api-key

Query parameters

syncboolean

Open a short inline processing window when supported by the endpoint. If the result is not ready yet, the endpoint may still return 202 with a queued payload that includes poll_url, events_url, and retry_after_seconds.

Headers

x-project-idstring

Optional attribution label for grouping usage and jobs by project.

x-workflow-idstring

Optional attribution label for grouping usage and jobs by workflow or agent run.

Request body

pagesstring[] required

Absolute page URLs or wildcard URL patterns to compare.

exclude_pagesstring[]

Absolute page URLs or wildcard URL patterns to exclude, usually your own page group.

locationstring

Human-friendly search market. If provided with location_code, location_code wins.

location_codeinteger

Optional provider location code for deterministic geo-targeting.

languagestring
item_typesstring[]
limitinteger
offsetinteger
include_subdomainsboolean
intersection_mode'union' | 'intersect'
include_serp_infoboolean
include_clickstream_databoolean

Doubles credit cost when true.

ignore_synonymsboolean
min_search_volumeinteger
max_rankinteger
sort_by'opportunity' | 'search_volume' | 'traffic_gap' | 'rank' | 'cpc'

Response

Completed page intersection workflow with agent_workflow

pagesstring[]
exclude_pagesstring[]
locationobject
page_intersectionobject
markdown_summarystring

Changes

No recorded changes to this operation across all 1 revision of this API.