FAQ: Can I fetch the IP address, User Agent, and interview thumbnails through the API?

Yes, all requests must be authenticated using your API key. You can retrieve:

• All IP addresses used during the interview
• User agents
• Interview thumbnail links

1. Fetch Interview-Level Metadata

To retrieve:

• Interview id
• Interview hash
• All ipAddresses
• All userAgents
• All thumbnails

Use the following query:

query InterviewDeduped($id: String!) {
  interview(id: $id) {
    id
    hash
    ipAddresses
    thumbnails
    userAgents
  }
}

Example Response

{
  "data": {
    "interview": {
      "id": "68dcfd087d1ffc3422058d19",
      "hash": "yka4ArD5",
      "ipAddresses": [
        "83.56.102.236"
      ],
      "userAgents": [
        "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.1 Safari/605.1.15"
      ],
      "thumbnails": ["<Long Thumbnail Links>"]
    }
  }
}

This provides a deduplicated list of IP addresses and user agents used during the interview session.

---

2. Fetch IP Address and User Agent Per Question

If you need more granular data (per interview question/step), you can query each step and its answers.

query InterviewUAByStep($id: String!) {
  interview(id: $id) {
    id
    steps(input: {}) {
      __typename
      ... on InterviewStepTextQuestionWithVideoAnswer {
        id
        index
        title
        answers(input: { onlyMostRecent: false }) {
          __typename
          ... on InterviewStepTextQuestionWithVideoAnswerAnswer {
            userAgent
            ip
          }
        }
      }
      ... on InterviewStepVideoQuestionWithVideoAnswer {
        id
        index
        title
        answers(input: { onlyMostRecent: false }) {
          __typename
          ... on InterviewStepVideoQuestionWithVideoAnswerAnswer {
            userAgent
            ip
          }
        }
      }
    }
  }
}

Example Response Structure

{
  "data": {
    "interview": {
      "id": "68dcfd087d1ffc3422058d19",
      "steps": [
        {
          "__typename": "InterviewStepTextQuestionWithVideoAnswer",
          "id": "68dcfd087d1ffc3422058d1a",
          "index": 0,
          "title": "Hola",
          "answers": [
            {
              "__typename": "InterviewStepTextQuestionWithVideoAnswerAnswer",
              "userAgent": "Mozilla/5.0 (...) Safari/605.1.15",
              "ip": "83.56.102.236"
            }
          ]
        }
      ]
    }
  }
}

What’s the Difference Between the Two Queries?

Use Case	Recommended Query
Get all IPs, user agents, and thumbnails for the entire interview	InterviewDeduped
Get IP and user agent per question/step	InterviewUAByStep