Investigating competitor citation gaps
Find domains and URLs that cite competitors, then select opportunities with supporting evidence.
When to use this workflow
“Find pages that cite competitors but leave us out.”
Before fetching
Fix the owned and competitor brands, prompt cohort, platform, and dates. Distinguish third-party citation opportunities from pages you control.
Quick reference
Use this sequence once you know the task. Read the numbered steps below for the reasoning and checks.
orc brands list --json
orc sources gaps list --json
orc sources domains list --json
orc sources urls list --json
orc reports citations get --jsonPrerequisites
Complete the CLI quickstart. These commands use CLI 0.5.0. Select the target workspace and use IDs returned by list commands.
Tracked competitors and collected citation observations.
Check the tracked competitors, then fetch citation gaps, domains, and URLs. Consider updates to your own site separately from opportunities for coverage on external sites.
1. Confirm the brand and competitors
Check the target brand ID and tracked competitors. Use the ID when filtering answers.
orc brands list --json2. Find competitor citation opportunities
Read citation differences between your brand and competitors. Keep the tracked competitor set and observed period explicit.
orc sources gaps list --json3. Inspect cited domains
Identify owned and external sites. Distinguish domain-level aggregates from observations for an individual URL.
orc sources domains list --json4. Narrow the target URLs
Select URLs for updates or investigation and check the citation period. Fetch matching conditions if the comparison period differs.
orc sources urls list --json5. Fetch citation observations
Inspect sources cited in answers. Keep citations distinct from crawls and actual visits.
orc reports citations get --json6. Verify and save the result
Keep each candidate URL, cited brand, observed period, and supporting answers. Citation counts are not crawl counts or human visits. Your prioritization is an investigation judgment, not an automatically calculated forecast of impact.
When data is missing
If data is missing, check the workspace, collection period, filters, and pagination. Keep a failed request separate from an empty result. Use --help to inspect supported options.
If a failure remains, report it and verify the fix, including this workflow and the failed step.