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.
  • approvedValuesOnly (boolean, optional, default: false): Lists only the response values for approved reviews.
  • rejectedValuesOnly (boolean, optional, default: false): Lists only the request values for rejected reviews.
  • 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",
"fields": {
"yourFieldId1": {
"suggestedValue": "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...",
"approvedValue": "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..."
},
"yourFieldId2": {
"suggestedValue": "...",
"approvedValue": "..."
}
}
},
...
]
  • groupByField=true
{
"yourFieldId1": [
{
"reviewId": "abc123456",
"createdAt": "2025-03-12T22:25:42.415Z",
"respondedAt": "2025-03-12T22:26:15.253Z",
"response": "approved",
"suggestedValue": "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...",
"approvedValue": "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..."
},
...
]
}
  • approvedValuesOnly=true groupByField=false
    (works the same for rejectedValuesOnly=true but would include suggested values)
[
{
"yourFieldId1": "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...",
"yourFieldId2": "..."
},
...
]
  • approvedValuesOnly=true groupByField=true
    (works the same for rejectedValuesOnly=true but would include suggested values)
{
"yourFieldId1": [
"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...",
"..."
],
"yourFieldId2": [
"...",
"..."
]
}