Skip to main content
Feedback tells Stophy that an answer was good, partly right or wrong, in one free call. A bad rating also refunds what that call cost, up to $0.10 a day. An agent or a developer can send it. It needs an API key.

When to report

Report an answer that is wrong or incomplete, or a search that missed what you needed. Send one rating for each call, with the call’s requestId as jobId. Do not report errors you can fix by changing the request.

Make a request

This request rates a search as good. jobId is the requestId from the search answer.

Read the response

feedbackId names your report. refundedUsd is what this rating gave back, and refundedTodayUsd is what has been refunded today out of dailyRefundCapUsd. dailyCapReached is true once the cap is used. Rating the same jobId again returns the first feedbackId with alreadySubmitted: true and refunds nothing.
POST /v1/search/{jobId}/feedback rates a search and takes the search’s requestId in the path. Use it to say which results helped and what was missing.
The answer has the same fields as above. This call saved with alreadySubmitted: false.

Options

Both calls take these fields. rating is required. POST /v1/feedback also takes these:

Refunds

A bad rating refunds what the rated call cost, back into your balance. The refunds add up to at most $0.10 a day. After that the rating is still saved and dailyCapReached is true. A call that cost nothing, or one that was not billed to your account, has nothing to refund. Each call can be rated once.

Limits and errors

Tell your agent

Add a line like this to your agent’s instructions file, such as AGENTS.md or CLAUDE.md.