GET
/
higgsfield
/
motions
Get Higgsfield Motions
curl --request GET \
  --url https://api.unifically.com/higgsfield/motions \
  --header 'Authorization: Bearer <token>'
{
  "code": 200,
  "data": {
    "items": [
      {
        "id": "d2389a9a-91c2-4276-bc9c-c9e35e8fb85a",
        "name": "General",
        "media": {
          "url": "https://d1xarpci4ikg0w.cloudfront.net/...",
          "type": "animated",
          "width": 320,
          "height": 180
        },
        "priority": -262,
        "tags": ["top_choice"],
        "categories": ["basic_camera_control", "trending"]
      }
    ],
    "total": 229,
    "cursor": -255,
    "error": {}
  }
}
Fetch available motion presets for Higgsfield Video models.

​
Pricing

For current pricing, see the Pricing page.

​
Authentication

All endpoints require authentication using Bearer token authorization: 
-H 'Authorization: Bearer YOUR_API_KEY'

​
Request

curl -X GET 'https://api.unifically.com/higgsfield/motions?size=30' \
  -H 'Authorization: Bearer YOUR_API_KEY'

​
Parameters

​
size
integer
Number of motion presets to return per pageDefault: 30
​
cursor
integer
Pagination cursor for fetching next page
​
preset_family
string
Preset family filter (automatically forced to "higgsfield")Default: "higgsfield"

​
Response

{
  "code": 200,
  "data": {
    "items": [
      {
        "id": "d2389a9a-91c2-4276-bc9c-c9e35e8fb85a",
        "name": "General",
        "media": {
          "url": "https://d1xarpci4ikg0w.cloudfront.net/...",
          "type": "animated",
          "width": 320,
          "height": 180
        },
        "priority": -262,
        "tags": ["top_choice"],
        "categories": ["basic_camera_control", "trending"]
      }
    ],
    "total": 229,
    "cursor": -255,
    "error": {}
  }
}

​
Response Fields

​
code
integer
default:"200"
HTTP status code (200 for success)
​
data
object
Response data
​
items
array
Array of motion preset objects
​
id
string
Unique motion preset identifier (UUID format)
​
name
string
Display name of the motion preset
​
media
object
Preview media for the motion preset
​
url
string
URL of the preview media
​
type
string
Media type (e.g., animated, video)
​
width
number
Width of the preview media in pixels
​
height
number
Height of the preview media in pixels
​
priority
number
Priority ranking for the motion preset
​
tags
array
Array of tag strings for the motion preset
​
categories
array
Array of category tags for the motion preset
​
total
number
Total number of available motions
​
cursor
number
Pagination cursor for fetching more results