curl -X POST https://api.rankraft.ai/v1/sites/3f2c9a10-7b1e-4c55-9d2a-1a2b3c4d5e6f/prompts \
  -H "X-API-Key: $RANKRAFT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompts": [
      { "text": "best mixed pickle brand", "category": "Discovery" },
      { "text": "achar price per kg", "category": "Pricing", "active": false }
    ],
    "dry_run": false
  }'

// npm install rankraft-js · https://www.npmjs.com/package/rankraft-js
import { RankRaft, PromptLimitError } from "rankraft-js";

const rr = new RankRaft(); // reads RANKRAFT_API_KEY (needs "Read and manage prompts")

try {
  const result = await rr.prompts.create({
    site_id: "3f2c9a10-7b1e-4c55-9d2a-1a2b3c4d5e6f",
    prompts: [
      { text: "best mixed pickle brand", category: "Discovery" },
      { text: "achar price per kg", category: "Pricing", active: false },
    ],
    dry_run: false,
  });
  console.log(result.created, result.existing);
} catch (err) {
  if (err instanceof PromptLimitError) console.log(`Only ${err.remaining} slots left`);
  else throw err;
}

# pip install rankraft-py · https://pypi.org/project/rankraft-py/
from rankraft import RankRaft, PromptLimitError

with RankRaft() as rr:  # reads RANKRAFT_API_KEY (needs "Read and manage prompts")
    try:
        result = rr.prompts.create(
            site_id="3f2c9a10-7b1e-4c55-9d2a-1a2b3c4d5e6f",
            prompts=[
                {"text": "best mixed pickle brand", "category": "Discovery"},
                {"text": "achar price per kg", "category": "Pricing", "active": False},
            ],
            dry_run=False,
        )
        print(result["created"], result["existing"])
    except PromptLimitError as err:
        print(f"Only {err.remaining} slots left")

{
  "dry_run": false,
  "created": 1,
  "existing": 1,
  "data": [
    {
      "id": "8a1e4b2c-6d0f-4e3a-9b51-2c7d8e9f0a1b",
      "text": "best mixed pickle brand",
      "category": "Discovery",
      "market": null,
      "status": "active",
      "created_at": "2026-09-02T08:12:00.000Z",
      "updated_at": "2026-09-02T08:12:00.000Z"
    },
    {
      "id": "0c4f1d7e-2a9b-4c3d-8e5f-6a7b8c9d0e1f",
      "text": "achar price per kg",
      "category": "Pricing",
      "market": null,
      "status": "disabled",
      "created_at": "2026-10-16T09:00:00.000Z",
      "updated_at": "2026-10-16T09:00:00.000Z"
    }
  ]
}

{
  "error": {
    "code": "prompt_limit_reached",
    "message": "This would make 501 active prompts; the enterprise plan allows 500.",
    "details": { "limit": 500, "active": 500, "requested": 1, "remaining": 0 }
  },
  "request_id": "8c1f2a3b4c5d6e7f-LHR"
}