Contents

API reference / Reddit

Save the keyword research post ideas are built on

PUT /api/v1/projects/{project}/reddit/research

set_reddit_keyword_research Write MCP tool

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

NameTypeDescription
project required
path
string The project's id.

Request body

JSON, sent with Content-Type: application/json.

NameTypeDescription
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":"…"}'