Connect agents and scripts to reviewed keyword research workflows.

TOKEN="gk_live_..."
BASE="https://discoverkeywords.co"

curl -H "Authorization: Bearer $TOKEN" \
  "$BASE/api/research/byok/readiness"

curl -X POST "$BASE/api/research/byok/pipeline/expand/quote" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: expand-example-001" \
  -d '{"keywords":["ai resume builder"],"days":90,"filterTerms":["news"]}'

# Copy quoteId, requestHash, and estimatedCostUsd from the quote response.
curl -X POST "$BASE/api/research/byok/pipeline/expand/execute" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: execute-expand-example-001" \
  -d '{"quoteId":"...","requestHash":"...","confirmedEstimatedCostUsd":0.016}'

curl -H "Authorization: Bearer $TOKEN" \
  "$BASE/api/research/byok/pipeline/jobs/JOB_ID"

# If status is partial, request an additional quote for failed stages only.
curl -X POST "$BASE/api/research/byok/pipeline/jobs/JOB_ID/retry/quote" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: retry-expand-example-001" \
  -d '{}'

# Confirm the returned retry quote through the same expand/execute endpoint.
# Successful stages are loaded from private checkpoints and are not repurchased.

curl -H "Authorization: Bearer $TOKEN" \
  "$BASE/api/research/byok/pipeline/history?limit=20"

const headers = {
  Authorization: `Bearer ${process.env.DISCOVER_KEYWORDS_API_KEY}`,
  "Content-Type": "application/json",
  "Idempotency-Key": crypto.randomUUID(),
};
const quoted = await fetch(
  "https://discoverkeywords.co/api/research/byok/pipeline/compare/quote",
  { method: "POST", headers, body: JSON.stringify({
      keywords, benchmark: "gpts", days: 90,
  }) },
).then((response) => response.json());

// Show quoted.quote.estimatedCostUsd to the operator before executing.
const job = await fetch(
  "https://discoverkeywords.co/api/research/byok/pipeline/compare/execute",
  { method: "POST", headers: { ...headers,
      "Idempotency-Key": crypto.randomUUID() },
    body: JSON.stringify({
      quoteId: quoted.quote.quoteId,
      requestHash: quoted.quote.requestHash,
      confirmedEstimatedCostUsd: quoted.quote.estimatedCostUsd,
    }) },
).then((response) => response.json());