---
title: "Prospector, backlinks and saved audits"
description: "Read and manage saved outreach lists, backlink profile evidence, GBP audits and Batch URL Analyzer runs."
canonical_url: "https://developers.rankability.com/guides/saved-evidence"
section: "Guides"
last_updated: 2026-11-14
---

# Prospector, backlinks and saved audits

Read and manage saved outreach lists, backlink profile evidence, GBP audits and Batch URL Analyzer runs.

## Prospector — Saved outreach lists

Prospector Agent routes expose saved client outreach state without invoking discovery, backlink, enrichment, scraping, email, or contact providers. Reads require `prospector:read`; mutations require `prospector:write` plus a stable `Idempotency-Key`.

List saved lists with `GET /clients/:client_id/prospect-lists`, then read compact pipeline items with `GET /clients/:client_id/prospect-lists/:list_id/items`. Both routes accept bounded `limit` and `offset`; items also accept `status=identified|contacted|in_discussion|won|passed`.

Create lists and save known public URLs with the matching `POST` routes. URLs are normalized, unsafe/private targets are rejected, and canonical variants are de-duplicated within a list. `PATCH` changes only saved item status or notes and never sends outreach. Item deletion requires `confirm_url`; list deletion requires `confirm_name`.

See the Help Center's Prospector API guide for request examples and exact response fields.

## Backlink profile — Saved evidence

`GET /api/agent/v1/clients/:client_id/backlinks/profile` reads persisted backlink evidence without invoking DataForSEO or consuming usage. Select `section=summary|history|anchors|top_pages`; history accepts `months=1..12`, while row sections accept bounded `limit` and `offset`. `domain` defaults to the client's configured domain, and `include_subdomains=false` selects only a separately saved isolated-domain snapshot.

Every response reports `data_state`, `cached_at`, and `freshness`. `unavailable` means no matching saved snapshot exists; it is not a measured zero. Stale evidence remains visible and labeled rather than being refreshed implicitly. Raw provider payloads, individual live backlink lists, exports, and provider refresh are not exposed by this route.

## GBP and Batch URL — Saved artifacts

`GET /clients/:client_id/gbp-audits` and `GET /clients/:client_id/gbp-audits/:audit_id` expose persisted GBP audit state. Summary view returns scores and aggregate profile, review, media, post, question, checkpoint, and competitor evidence. Full view adds paginated checkpoints and competitor aggregates. Raw reviewer and question bodies are omitted in every view.

`GET /clients/:client_id/batch-url-runs` lists compact saved history. `GET /clients/:client_id/batch-url-runs/:run_id` paginates at most 100 URL rows and preserves null measurements. Each row is labeled `complete`, `partial`, or `error`; the API omits historical credit units because current account contracts are resolved through `/usage`.

These four routes never resolve a GBP listing, call Google, SerpAPI, DataForSEO, GSC, or GA4, start an audit, analyze a URL, or mutate usage. New run endpoints remain outside this saved-artifact contract.
