# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for DataForSEO Backlinks API
  version: 1.0.0
extends: openapi/dataforseo-backlinks-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 24
- target: $.paths['/v3/backlinks/id_list'].post
  update:
    x-apievangelist-phrasing:
      intent: List IDs of Backlinks tasks in a time period
      effect: read
      questions:
      - Can I get the IDs of every Backlinks task I created during a given time window?
      - Which Backlinks tasks did I run last week, including ones that didn't complete?
      instructions:
      - text: List the IDs and metadata of all Backlinks tasks I created this month.
      - text: Pull every Backlinks task ID from my account for yesterday, successful or not.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/backlinks/errors'].post
  update:
    x-apievangelist-phrasing:
      intent: List Backlinks tasks that failed recently
      effect: read
      questions:
      - Which of my Backlinks API calls returned an error in the past seven days?
      - Why did some of my backlink requests fail this week?
      instructions:
      - text: Show the Backlinks API tasks that errored in the last 7 days.
      - text: Get the error details for my failed backlink requests this week.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/backlinks/available_filters'].get
  update:
    x-apievangelist-phrasing:
      intent: List filters usable in Backlinks requests
      effect: read
      questions:
      - What fields can I filter and sort on when pulling backlink data?
      - Do filtering or sorting rules on backlink requests cost extra?
      instructions:
      - text: Get the list of filters supported by the Backlinks endpoints.
      - text: Show which backlink fields I can use in filter expressions.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/backlinks/index'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the size of the backlinks database
      effect: read
      questions:
      - How many backlinks, domains and pages does the DataForSEO index hold right now?
      - How has the backlink database grown over the last 12 months?
      instructions:
      - text: Report the current total of backlinks, domains and pages in the index.
      - text: Show the backlink index growth stats for the past year.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/backlinks/summary/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a backlink profile overview for a target
      effect: read
      questions:
      - What does the overall backlink profile of a domain look like at a glance?
      - Can I get a single summary of backlinks for one webpage or subdomain?
      instructions:
      - text: Give me a backlink summary for my domain.
      - text: Summarize the backlink profile of this subdomain in one overview.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/backlinks/history/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Get historical backlink data for a domain
      effect: read
      questions:
      - How many backlinks did my domain have back in 2019 compared with today?
      - Can I see how my backlinks and referring domains changed over the years?
      instructions:
      - text: Pull the historical backlink counts for my domain since 2019.
      - text: Show the long-term history of new and lost backlinks for this domain.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/backlinks/backlinks/live'].post
  update:
    x-apievangelist-phrasing:
      intent: List the backlinks pointing to a target
      effect: read
      questions:
      - Which individual links point to my website?
      - Can I get the full list of backlinks to a specific page, not just counts?
      instructions:
      - text: List every backlink pointing to my domain with its link data.
      - text: Get the individual backlinks to this webpage.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/backlinks/anchors/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Analyze anchor texts linking to a site
      effect: read
      questions:
      - What anchor text do other sites use when they link to me?
      - Which anchors bring the most backlinks to a website?
      instructions:
      - text: Break down the anchor texts used in links to my site.
      - text: Show the anchor text distribution with backlink data for this website.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/backlinks/domain_pages/live'].post
  update:
    x-apievangelist-phrasing:
      intent: List a domain's pages with their backlink data
      effect: read
      questions:
      - Which pages on my domain are attracting backlinks?
      - Can I see the pages of a site along with backlink data for each one?
      instructions:
      - text: List the pages of my domain with backlink data for each.
      - text: Show which pages on this site have the most links.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/backlinks/domain_pages_summary/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Summarize backlink metrics per page of a domain
      effect: read
      questions:
      - What are the summarized backlink metrics for each page on a domain?
      - Can I get per-page backlink summaries rather than raw page lists?
      instructions:
      - text: Give me backlink summary metrics for each page on my domain.
      - text: Produce a per-page backlink metrics rollup for this subdomain.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/backlinks/referring_domains/live'].post
  update:
    x-apievangelist-phrasing:
      intent: List the referring domains for a target
      effect: read
      questions:
      - Which domains link to my website?
      - What are the referring domains for a page, with details on each?
      instructions:
      - text: List the referring domains pointing to my site.
      - text: Show the detailed referring domain breakdown for this target.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/backlinks/referring_networks/live'].post
  update:
    x-apievangelist-phrasing:
      intent: List referring IPs and subnets for a target
      effect: read
      questions:
      - Which IP addresses and subnets do my backlinks come from?
      - Are many of a site's links coming from the same network?
      instructions:
      - text: Show the referring IPs and subnets linking to my domain.
      - text: Break down this target's backlinks by referring network.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/backlinks/competitors/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Find sites sharing a backlink profile
      effect: read
      questions:
      - Which websites share the most backlinks with mine?
      - Who are my link-building competitors and how do they rank?
      instructions:
      - text: Find competitors that overlap with my domain's backlink profile.
      - text: List sites sharing backlinks with this website, with their intersection counts and rank.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/backlinks/domain_intersection/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Find domains linking to competitors but not you
      effect: read
      questions:
      - Which domains link to my competitors but not to my site?
      - Can I build a link gap report at the domain level?
      instructions:
      - text: Run a domain-level link gap between my site and two competitors.
      - text: List referring domains that point to all of these websites.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/backlinks/page_intersection/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Find pages linking to competitors but not you
      effect: read
      questions:
      - Which specific referring pages link to my competitors but not to me?
      - Can I find link opportunities at the page level rather than the domain level?
      instructions:
      - text: Find the referring pages that link to my competitors and not my site.
      - text: Run a page-level backlink intersection across these targets.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/backlinks/timeseries_summary/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Get backlink metrics over a date range
      effect: read
      questions:
      - How did my backlink metrics trend between two dates, grouped by week or month?
      - Can I chart a domain's backlink data day by day for a custom period?
      instructions:
      - text: Chart my domain's backlink metrics month by month for this year.
      - text: Get weekly backlink summary data for this domain between two dates.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/backlinks/timeseries_new_lost_summary/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Track new and lost backlinks for a domain over time
      effect: read
      questions:
      - How many backlinks and referring domains did my domain gain and lose over time?
      - When did a site lose a big chunk of its links?
      instructions:
      - text: Show new versus lost backlinks and referring domains for my domain over time.
      - text: Plot the gained and lost links timeline for this domain.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/backlinks/bulk_ranks/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Get rank scores for many targets at once
      effect: read
      questions:
      - What is the 0 to 1,000 rank score of each domain in my list?
      - Can I compare authority ranks for a batch of pages in one request?
      instructions:
      - text: Get rank scores for this list of domains.
      - text: Compare the backlink rank of these pages and subdomains in bulk.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/backlinks/bulk_backlinks/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Count backlinks for many targets at once
      effect: read
      questions:
      - How many live backlinks does each site in my list have?
      - Can I get total backlink counts for a batch of URLs in one call?
      instructions:
      - text: Count the live backlinks for each of these domains.
      - text: Get bulk backlink totals for this list of pages.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/backlinks/bulk_spam_score/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Get spam scores for many targets at once
      effect: read
      questions:
      - How spammy are the domains in my outreach list on a 0 to 100 scale?
      - Can I check spam scores for a batch of pages before linking to them?
      instructions:
      - text: Score these domains for spam.
      - text: Get the spam score of each URL in this list.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/backlinks/bulk_referring_domains/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Count referring domains for many targets
      effect: read
      questions:
      - How many referring domains does each site in my list have?
      - Can I compare the number of linking domains across a batch of competitors?
      instructions:
      - text: Count referring domains for each of these targets.
      - text: Get bulk referring domain totals for this list of competitor sites.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/backlinks/bulk_new_lost_backlinks/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Count new and lost backlinks for many targets
      effect: read
      questions:
      - How many backlinks did each site in my list gain or lose recently?
      - Can I check new and lost link counts for a batch of pages at once?
      instructions:
      - text: Get new and lost backlink counts for each of these domains.
      - text: Compare recent backlink gains and losses across this list of URLs.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/backlinks/bulk_new_lost_referring_domains/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Count new and lost referring domains in bulk
      effect: read
      questions:
      - How many linking domains did each site in my list gain or lose?
      - Which of my competitors lost referring domains recently?
      instructions:
      - text: Get new and lost referring domain counts for each of these sites.
      - text: Check referring domain gains and losses across this batch of targets.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/backlinks/bulk_pages_summary/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Summarize backlinks for up to 1,000 targets
      effect: read
      questions:
      - Can I get full backlink summaries for up to a thousand pages in one request?
      - What is the most efficient way to audit backlinks for a large list of URLs?
      instructions:
      - text: Produce a backlink summary for each URL in this list of pages.
      - text: Run a bulk backlink overview across these domains and subdomains.
      method: generated
      generated: '2026-10-01'