---
title: "Suggest Sources"
method: POST
path: "/content/briefs/{brief_id}/sources/suggest"
tags: ["content"]
---

# Suggest Sources

`POST /content/briefs/{brief_id}/sources/suggest`

## Request

- Base URL: `https://api.xeorank.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.xeorank.com/content/briefs/{brief_id}/sources/suggest`
- Auth: API key in header `X-Agent-Key`

Candidate sources for every '[SOURCE NEEDED]' marker and unsourced figure
in the draft. Candidates are found, never generated: the brief's first-party
evidence, the vendor's own page from the SERP, and a live Google search per
claim. Each web candidate is fetched and checked for whether it states the
claim's figure. Pro (Writing Agent).

## Path parameters

- `brief_id` string, uuid, required

## Query parameters

- `email` string, nullable

## Request body

- SuggestSourcesBody
  - `max_claims` integer
  - `web_search` boolean

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/xeorank/apis/seo-intelligence-engine.md) · [All operations](https://skmtc.dev/xeorank/apis/seo-intelligence-engine/llms.txt) · [OpenAPI document](https://skmtc.dev/xeorank/apis/seo-intelligence-engine/revisions/449a3fd73454?raw)
