Skip to main content

Query past responses

To generate more accurate and personalized LLM outputs, use previously submitted human reviews and edits as few-shot examples in your prompts or for training and evals.

You can fetch this dataset via API.

Upgrade

This is a feature offered as part of our Pro plan

Fetch​

Endpoint:

GET https://api.gotohuman.com/queryResponses

Auth Header:

x-api-key: YOUR_API_KEY

Query Parameters:

  • formId (string, required): The ID of the review template or form.
  • fieldIds (string, required): The comma-separated IDs of the fields you are interested in.
  • filterResponse (string, optional): Filter by review status. Possible values: approved, rejected.
  • groupByField (boolean, optional, default: false): Whether to group the responses by field. If not, grouped by review.
  • limit (number, optional, default: 20, max: 50): The number of responses to return.

Example:

https://api.gotohuman.com/queryResponses?formId=FORM_ID&fieldIds=FIELD_ID1,FIELD_ID2&filterResponse=approved

Response​

Receive the values of the given fields for past submitted reviews.

groupByField=false

[
    {
      "reviewId": "abc123456",
      "createdAt": "2025-03-12T22:25:42.415Z",
      "respondedAt": "2025-03-12T22:26:15.253Z",
      "response": "approved",
      "yourFieldId": {
          "requestValue": "Hi Lenny, I saw the news about your latest model. Given your momentum in the AI space, influencer marketing could be a powerful tool to further engage and expand your developer community...",
          "responseValue": "Hello Lenny, I tested your latest model and it looks really promising. Given your momentum in the AI space, influencer marketing could be a powerful tool to further engage and expand your developer community..."
      }
    },
    ...
]

groupByField=true

{
  "yourFieldId": [
    {
      "reviewId": "abc123456",
      "createdAt": "2025-03-12T22:25:42.415Z",
      "respondedAt": "2025-03-12T22:26:15.253Z",
      "response": "approved",
      "requestValue": "Hi Lenny, I saw the news about your latest model. Given your momentum in the AI space, influencer marketing could be a powerful tool to further engage and expand your developer community...",
      "responseValue": "Hello Lenny, I tested your latest model and it looks really promising. Given your momentum in the AI space, influencer marketing could be a powerful tool to further engage and expand your developer community..."
    },
    ...
  ]
}