Skip to main content
POST
/
infer
/
preview
curl --request POST \
  --url https://api.datalinks.com/api/v1/infer/preview \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "data": [
    {
      "name": "Braveheart",
      "year": 1995,
      "budget": 72000000,
      "director": "Mel Gibson"
    },
    {
      "name": "Argo",
      "year": 2012,
      "budget": 44500000,
      "director": "Ben Affleck"
    },
    {
      "name": "A Quiet Place",
      "year": 2018,
      "budget": 17000000,
      "director": "John Krasinski"
    },
    {
      "name": "Dances with Wolves",
      "year": 1990,
      "budget": 22000000,
      "director": "Kevin Costner"
    },
    {
      "name": "Unforgiven",
      "year": 1992,
      "budget": 14000000,
      "director": "Clint Eastwood"
    },
    {
      "name": "The Postman",
      "year": 1997,
      "budget": 80000000,
      "director": "Kevin Costner"
    }
  ],
  "link": {
    "ExactMatch": null
  }
}
'
[
  {
    "id": "001",
    "__metadata_textToTable": "name -> John Smith, age -> 28, department -> Engineering",
    "name": "John Smith",
    "age": "28",
    "gender": "Male",
    "department": "Engineering",
    "location": "New York"
  },
  {
    "id": "002",
    "__metadata_textToTable": "name -> Sarah Johnson, age -> 32, department -> Marketing",
    "name": "Sarah Johnson",
    "age": "32",
    "gender": "Female",
    "department": "Marketing",
    "location": "California"
  },
  {
    "id": "003",
    "name": "Michael Brown",
    "age": "45",
    "gender": "Male",
    "department": "Finance",
    "location": "Texas",
    "__metadata_normalize": "Normalized department field from 'Fin Dept' to 'Finance'"
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.datalinks.com/llms.txt

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

Authorizations

​
Authorization
string
header
required

Use a Bearer token for authentication. Submit the token using the Authorization header: Authorization: Bearer <token>.

Body

application/json
​
data
object[]
required
​
infer
object
​
link
object
​
curate
boolean | null
​
dataDescription
string

A description of the dataset to help the AI system understand the context.

Maximum string length: 10000
Example:

"Employee dataset containing demographics and compensation."

​
schemaDefinition
object

A schema definition mapping field names to descriptions, to guide the AI system in structuring the extracted data.

Example:
{
  "id": "unique employee identifier",
  "name": "full employee name",
  "age": "employee age in years",
  "department": "work department",
  "salary": "annual salary in USD"
}
​
additionalInstructions
string

Additional instructions to guide the AI system during ingestion.

Response

Returns the processed preview data.

Example:
[
  {
    "id": "001",
    "__metadata_textToTable": "name -> John Smith, age -> 28, department -> Engineering",
    "name": "John Smith",
    "age": "28",
    "gender": "Male",
    "department": "Engineering",
    "location": "New York"
  },
  {
    "id": "002",
    "__metadata_textToTable": "name -> Sarah Johnson, age -> 32, department -> Marketing",
    "name": "Sarah Johnson",
    "age": "32",
    "gender": "Female",
    "department": "Marketing",
    "location": "California"
  },
  {
    "id": "003",
    "name": "Michael Brown",
    "age": "45",
    "gender": "Male",
    "department": "Finance",
    "location": "Texas",
    "__metadata_normalize": "Normalized department field from 'Fin Dept' to 'Finance'"
  }
]