Skip to main content
POST
/
v1
/
search
curl --location --request POST 'https://api.getmetal.io/v1/search' \
--header 'Content-Type: application/json' \
--header 'x-metal-api-key: <api-key>' \
--header 'x-metal-client-id: <client-id>' \
--data-raw '{
    "index": "index-id",
    "text": "Generals gathered in their masses",
    "filters": {
        "and": [{
            "field": "year",
            "value": 1984,
            "operator": "lte"
        }],
        "or": [{
            "field": "name",
            "value": "Iron Maiden",
            "operator": "eq"
        }, {
            "field": "name",
            "value": "Helloween",
            "operator": "eq"
        }]
    }
}'

{
  "data": [
    {
      "dist": "0.666",
      "id": "1",
      "text": "Eagle Fly Free",
      "metadata": {
        "name": "Helloween",
        "year": 1984
      },
      "createdAt":"2023-08-22T18:30:11.493Z"
    },
    {
      "id": "2",
      "dist": "0.999",
      "text": "The Trooper",
      "metadata": {
        "name": "Iron Maiden",
        "year": 1978
      },
      "createdAt": "2023-08-10T11:44:53.010Z"
      }
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.getmetal.io/llms.txt

Use this file to discover all available pages before exploring further.

​
Auth Headers

​
x-metal-api-key
string
required
An API key for your org.
​
x-metal-client-id
string
required
A Client ID for your org.

​
Body

​
index
string
required
Index ID
​
text
string
Text
​
imageUrl
string
Image URL
​
embedding
number[]
Custom Embeddings
​
ids
string[]
Subset of documents ids to match
​
filters
object

​
Query

​
idsOnly
boolean
default:"false"
Return only a list of ids without any metadata.
​
limit
number
default:"5"
The limit of possible reponses from your search. Max 100.

​
Response

​
data
Results Array
curl --location --request POST 'https://api.getmetal.io/v1/search' \
--header 'Content-Type: application/json' \
--header 'x-metal-api-key: <api-key>' \
--header 'x-metal-client-id: <client-id>' \
--data-raw '{
    "index": "index-id",
    "text": "Generals gathered in their masses",
    "filters": {
        "and": [{
            "field": "year",
            "value": 1984,
            "operator": "lte"
        }],
        "or": [{
            "field": "name",
            "value": "Iron Maiden",
            "operator": "eq"
        }, {
            "field": "name",
            "value": "Helloween",
            "operator": "eq"
        }]
    }
}'

{
  "data": [
    {
      "dist": "0.666",
      "id": "1",
      "text": "Eagle Fly Free",
      "metadata": {
        "name": "Helloween",
        "year": 1984
      },
      "createdAt":"2023-08-22T18:30:11.493Z"
    },
    {
      "id": "2",
      "dist": "0.999",
      "text": "The Trooper",
      "metadata": {
        "name": "Iron Maiden",
        "year": 1978
      },
      "createdAt": "2023-08-10T11:44:53.010Z"
      }
    }
  ]
}