Skip to main content
Rate a result when it helped, missed something or was wrong. It needs a key and costs nothing. A bad rating refunds what that call cost, up to the daily cap in Pricing. Send one rating per call. Do not report errors you can fix by changing the request.
jobId is the X-Request-ID header of the call you rate. The answer has feedbackId, refundedUsd, refundedTodayUsd, dailyRefundCapUsd, dailyCapReached and alreadySubmitted. Rating the same jobId again returns the first feedbackId with alreadySubmitted: true and refunds nothing. A call that cost nothing or is not billed to your account has nothing to refund, and the rating is still saved. To rate specific search results, call POST /v1/search/{jobId}/feedback with the same rating and result fields. For example, add {"source": "web", "position": 2} to valuableResults.

Fields

rating and, on POST /v1/feedback, jobId are required.

Errors

  • No key: 401 apiKeyRequired.
  • A jobId over 100 characters or with characters other than letters, digits, _ and -, or a value over a limit above: 400 invalidRequest.
  • A jobId that is not one of your billed calls: 200, saved, nothing refunded.

Tell your agent

Add a line like this to AGENTS.md or CLAUDE.md.
If a Stophy answer is wrong or differs from the docs, rate it once with POST https://api.stophy.dev/v1/feedback. Send the X-Request-ID header as jobId, and never include secrets.