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