API ReferenceCompanions

/public/companions/semantic

Search the companion catalog by meaning

GET
/public/companions/semantic

Search the companion catalog by meaning

Query Parameters

search*string
ethnicity?string
gender?string
Value in"male" | "female" | "nonBinary"
statuses?array<>
tags?
personaType?string
Value in"digitalTwin" | "companion"
pageIndex?integer
Formatint32
pageSize?integer
Formatint32

Header Parameters

X-API-Version?string

Response Body

application/problem+json

application/problem+json

application/json

application/json

curl -X GET "https://companion-api.napster.com/public/companions/semantic?search=string"
[
  {
    "id": "string",
    "firstName": "string",
    "lastName": "string",
    "previewUrl": "string",
    "videoLoopUrl": "string",
    "ethnicity": "string",
    "gender": "string",
    "headline": "string",
    "tags": {
      "property1": "string",
      "property2": "string"
    },
    "status": "pending",
    "createdAt": 0,
    "externalClientId": "string",
    "versions": [
      "v1"
    ]
  }
]
{
  "errors": {
    "property1": [
      "string"
    ],
    "property2": [
      "string"
    ]
  },
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}
{
  "code": "string",
  "description": "string",
  "type": "failure",
  "numericType": 0
}
{
  "code": "string",
  "description": "string",
  "type": "failure",
  "numericType": 0
}
{
  "code": "string",
  "description": "string",
  "type": "failure",
  "numericType": 0
}