curl --request POST \
--url https://api.footstep.ai/v1/predict \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"profile": "despondent",
"area": {
"type": "circle",
"center": {
"lat": 51.5074,
"lng": -0.1278
},
"radius_m": 2000
},
"params": {
"age_years": 75,
"initial_bearing_deg": 180,
"datetime": "2025-06-15T14:00:00Z"
}
}
'{
"profile": "<string>",
"model_version": "<string>",
"results": [
{
"hex": "<string>",
"score": 15
}
],
"summary": {
"hex_count": 123,
"processing_time_ms": 123
},
"confidence": "high"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}Predict
Predict
Generate spatial probability predictions for behavioural profiles
POST
/
v1
/
predict
curl --request POST \
--url https://api.footstep.ai/v1/predict \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"profile": "despondent",
"area": {
"type": "circle",
"center": {
"lat": 51.5074,
"lng": -0.1278
},
"radius_m": 2000
},
"params": {
"age_years": 75,
"initial_bearing_deg": 180,
"datetime": "2025-06-15T14:00:00Z"
}
}
'{
"profile": "<string>",
"model_version": "<string>",
"results": [
{
"hex": "<string>",
"score": 15
}
],
"summary": {
"hex_count": 123,
"processing_time_ms": 123
},
"confidence": "high"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}Research Preview — Predictions are generated from behavioural models that have not yet been fully validated against real-world outcomes. Access is granted on request — contact support@footstep.ai.
predict returns a probability-ranked grid covering that area — so search teams can prioritise the highest-likelihood ground.
The search area can be a circle (centre + radius), a polygon (GeoJSON), or a buffered path (LineString + buffer width). Weather and time-of-day are folded in automatically; weather can be overridden with explicit conditions or disabled entirely.Authorizations
Your Footstep API key
Body
application/json
Response
Prediction results with per-hex probabilities
The profile used for this prediction
Model version that produced the prediction
Per-hex predictions sorted by score (highest first)
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Model confidence level for the search area
Available options:
high, medium, low