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 forrejectedValuesOnly=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 forrejectedValuesOnly=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": [
"...",
"..."
]
}