Skip to main content
In this 2-step quickstart, you’ll learn how to:
  1. Upload a video and analyze it with the Interhuman API
  2. Receive social-intelligence signals in a structured JSON response
You’ll need an API key. Follow the API key guide for details, then exchange it for an access token using the Authentication guide.
You’ll also need a video file. You can download an example from here.

​
1. Upload the video

Use one of the requests below to send a local video file (any ffmpeg-supported format like MP4, AVI, MOV, MKV, WEBM; minimum 10 KB, maximum 20MB) to POST /v0/upload/analyze. The API processes the file in the background and prepares segment-level analysis for the entire video. 
export ACCESS_TOKEN="YOUR_ACCESS_TOKEN"
export VIDEO_PATH="path_to_your_video.mp4"

curl -X POST https://api.interhuman.ai/v0/upload/analyze \
  -H "Authorization: Bearer ${ACCESS_TOKEN}" \
  -F "file=@${VIDEO_PATH};type=video/mp4"

​
2. Read the response

After your upload is processed, the API returns a list of detected signals. Each signal represents a specific behavioral event identified in the video, including its timing and detailed analysis. Each signal object includes:
  • type: The category of the detected behavior. Possible values: Agreement, Confidence, Confusion, Disagreement, Disengagement, Engagement, Frustration, Hesitation, Interest, Skepticism, Stress, Uncertainty. See detailed explanations.
  • start and end: Timestamps in seconds indicating when the behavior occurred.
Here’s an example of what the API returns: 
[
  {
      "type": "Agreement",
      "start": 2.5,
      "end": 8.2
  },
  {
      "type": "Interest",
      "start": 12.3,
      "end": 19.1
  },
  ...
]
You can read more in the Upload & Analyze API Reference.