Skip to content

Prospector, backlinks and saved audits

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

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.

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.

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.