schema_version | number / number | Required | |
id | string | Required | Resource identifier returned by the operation. pattern: "^[a-zA-Z0-9_-]{1,128}$" |
workspace_id | string | Required | Workspace that owns this record. pattern: "^[a-zA-Z0-9_-]{1,128}$" |
competitor_binding | object | Optional | additional fields rejected |
competitor_binding.setId | string | Required | Identifier returned by the related operation. pattern: "^[a-zA-Z0-9_-]{1,128}$" |
competitor_binding.revision | integer | Required | Revision of the approved competitor set bound to this offer or run. Pass the current set revision as revision when preparing an offer. maximum: 9007199254740991; exclusiveMinimum: 0 |
competitor_binding.memberId | string | Required | Identifier returned by the related operation. pattern: "^[a-zA-Z0-9_-]{1,128}$" |
project_id | string | Required | Project that owns this record. pattern: "^[a-zA-Z0-9_-]{1,128}$" |
scope | object | Required | additional fields rejected |
scope.domain | string | Required | minLength: 1; maxLength: 253 |
scope.include_subdomains | boolean | Required | |
scope.website_revision | string | Required | pattern: "^[a-f0-9]{64}$" |
scope.query_version | string | Required | must equal "dataforseo-as-is-v1" |
source | string | Required | must equal "dataforseo" |
data_mode | string | Required | values: "synthetic", "provider_index" |
state | string | Required | Saved lifecycle or evidence state, as enumerated for this record. values: "queued", "fetching", "checking", "ready", "partial", "empty", "failed", "cancelled", "reconciliation_required" |
created_at | string | Required | UTC timestamp when the record was created. format: "date-time"; pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" |
updated_at | string | Required | UTC timestamp of the last record update. format: "date-time"; pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" |
execution_deadline | string | Required | format: "date-time"; pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" |
timing | object | Required | additional fields rejected |
timing.first_result_at | string / null | Required | |
timing.finished_at | string / null | Required | |
timing.first_result_ms | integer / null | Required | |
components | object | Required | additional fields rejected |
components.summary | object | Required | additional fields rejected |
components.summary.state | string | Required | Saved lifecycle or evidence state, as enumerated for this record. values: "pending", "running", "succeeded", "partial", "empty", "failed", "cancelled", "reconciliation_required" |
components.summary.run_id | string / null | Required | Identifier returned by the related operation. |
components.summary.retrieved_at | string / null | Required | |
components.summary.error_code | string / null | Required | Error code recorded for this result, or null. |
components.list | object | Required | additional fields rejected |
components.list.state | string | Required | Saved lifecycle or evidence state, as enumerated for this record. values: "pending", "running", "succeeded", "partial", "empty", "failed", "cancelled", "reconciliation_required" |
components.list.run_id | string / null | Required | Identifier returned by the related operation. |
components.list.retrieved_at | string / null | Required | |
components.list.error_code | string / null | Required | Error code recorded for this result, or null. |
components.checks | object | Required | additional fields rejected |
components.checks.state | string | Required | Saved lifecycle or evidence state, as enumerated for this record. values: "pending", "running", "succeeded", "partial", "empty", "failed", "cancelled", "reconciliation_required", "not_requested" |
components.checks.run_id | string / null | Required | Identifier returned by the related operation. |
components.checks.retrieved_at | string / null | Required | |
components.checks.error_code | string / null | Required | Error code recorded for this result, or null. |
summary | object / null | Required | |
summary.v | number | Required | must equal 1 |
summary.overview_run_id | string | Required | Identifier returned by the related operation. pattern: "^[a-zA-Z0-9_-]{1,128}$" |
summary.workspace_id | string | Required | Workspace that owns this record. pattern: "^[a-zA-Z0-9_-]{1,128}$" |
summary.project_id | string | Required | Project that owns this record. pattern: "^[a-zA-Z0-9_-]{1,128}$" |
summary.provider | string | Required | values: "linktrail_corpus", "dataforseo", "imported" |
summary.data_mode | string | Required | values: "synthetic", "owned_corpus", "provider_index", "imported" |
summary.provider_retrieved_at | string | Required | Timestamp when the upstream evidence was retrieved. format: "date-time"; pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" |
summary.provider_first_seen | string / null | Required | |
summary.provider_lost_date | string / null | Required | |
summary.verified_at | null | Required | Timestamp of the AgentLinkOps check; null until checked. |
summary.coverage | string | Required | Dataset scope and completeness, including limits on what these results establish. values: "provider_summary", "corpus_subset", "partial" |
summary.counts | object | Required | additional fields rejected |
summary.counts.backlinks | integer / null | Required | |
summary.counts.referring_domains | integer / null | Required | |
summary.counts.referring_main_domains | integer / null | Required | |
summary.counts.referring_pages | integer / null | Required | |
summary.counts.referring_ips | integer / null | Required | |
summary.counts.referring_subnets | integer / null | Required | |
summary.counts.crawled_pages | integer / null | Required | |
summary.counts.broken_backlinks | integer / null | Required | |
summary.counts.broken_pages | integer / null | Required | |
summary.provider_metrics | object / object | Required | |
summary.provider_metrics.dataforseo | object | Required | additional fields rejected |
summary.provider_metrics.dataforseo.rank | integer / null | Required | |
summary.provider_metrics.dataforseo.backlinks_spam_score | integer / null | Required | |
summary.provider_metrics.dataforseo.rank_scale | string | Required | must equal "one_thousand" |
summary.provider_metrics.linktrail_corpus | object | Required | additional fields rejected |
summary.provider_metrics.linktrail_corpus.corpus_source_pages | integer / null | Required | |
summary.provider_metrics.linktrail_corpus.corpus_last_expanded_at | string / null | Required | |
counts | object | Required | additional fields rejected |
counts.indexed_total | integer / null | Required | |
counts.retrieved_candidates | integer | Required | minimum: 0; maximum: 9007199254740991 |
counts.selected_checks | integer | Required | minimum: 0; maximum: 1000 |
counts.checked | integer | Required | minimum: 0; maximum: 1000 |
counts.present | integer | Required | minimum: 0; maximum: 1000 |
counts.absent | integer | Required | minimum: 0; maximum: 1000 |
counts.source_unavailable | integer | Required | minimum: 0; maximum: 1000 |
counts.unknown | integer | Required | minimum: 0; maximum: 1000 |
coverage | object | Required | Dataset scope and completeness, including limits on what these results establish. additional fields rejected |
coverage.whole_web | boolean | Required | must equal false |
coverage.sample | boolean | Required | Whether the result is a sample. Read coverage for the limits of that sample. must equal true |
coverage.ordering | string | Required | must equal "rank,desc" |
coverage.reason | string / null | Required | Recorded explanation; null when no explanation applies. |
selection | object | Required | additional fields rejected |
selection.policy | string | Required | must equal "distinct-host-target-order-v1" |
selection.manifest_hash | string / null | Required | |
selection.candidate_ids | array | Required | maxItems: 1000 |
selection.render_limit | number | Required | must equal 0 |
recurring_monitoring_created | boolean | Required | Whether this operation enrolled recurring monitoring. must equal false |
recovery | string | Required | values: "read_saved_run", "reconcile_receipt", "explicit_new_offer" |
progress | object | Optional | Read-time progress: live counts, last movement and an honest stalled state. Stalled work may still finish. |
progress.v | number | Required | must equal 1 |
progress.kind | string | Required | |
progress.phase | string | Required | values: "queued", "running", "stalled", "finished", "failed", "cancelled" |
progress.unit | string | Required | |
progress.done | integer / null | Required | |
progress.total | integer / null | Required | null while the total is unknown |
progress.percent | integer / null | Required | With known done and total counts, reports a whole-number percentage capped at 99 until a finished result is ready; if either count is unknown, reports null unless a finished result is ready, then 100. |
progress.lastProgressAt | string / null | Required | |
progress.stalled | boolean | Required | |
progress.stalledReason | string / null | Required | |
progress.stalledForSeconds | integer / null | Required | |
progress.resultReady | boolean | Required | |
progress.finishedAt | string / null | Required | |
progress.freshness | string / null | Required | |
progress.ageDays | integer / null | Required | |
replayed | boolean | Optional | True when the response reuses an earlier request with the same idempotency value. |