Save the keyword research post ideas are built on
PUT /api/v1/projects/{project}/reddit/research
Replaces the project's saved keyword research with a pasted list: a CSV or a markdown table (columns keyword and volume, and optionally reddit rank, reddit url and title for the Reddit thread Google ranks for it), or plain "keyword, volume" lines. Keywords barely change, so this is done once and refreshed now and then; nothing is looked up live. Empty text clears it.
A full-access key (ss_sk_…), or an editor or owner signed in.
Parameters
| Name | Type | Description |
|---|---|---|
project requiredpath |
string | The project's id. |
Request body
JSON, sent with Content-Type: application/json.
| Name | Type | Description |
|---|---|---|
text required |
string up to 200000 characters |
The research as CSV, a markdown table or keyword, volume lines. |
source |
string up to 200 characters |
Where it came from, e.g. "DataForSEO, Oct 2026". |
Returns
{ data: { count, source, updated_at, top } }
Example
curl -X PUT "https://sniffington.com/api/v1/projects/{project}/reddit/research" \
-H "Authorization: Bearer $SCOUT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"…"}'