Antwoorden API

Via het Olostep /v1/answers endpoint kun je het web doorzoeken met natuurlijke taal en AI-aangedreven antwoorden en gegevens in de gewenste JSON-vorm terugkrijgen. Dit stelt je in staat om je producten te baseren op real-world data en bronnen, gegevenspunten of spreadsheets te verrijken.

Stel een vraag of geef AI een gegevenspunt dat je wilt verrijken
Optioneel: specificeer de JSON-structuur die je terug wilt krijgen

Het zal:

Zoeken, schoonmaken, valideren en de gegevens die het op het web heeft gevonden teruggeven
Bronnen teruggeven die zijn gebruikt om het antwoord te genereren
Onzekerheid afhandelen met NOT_FOUND waarden wanneer gegevens niet kunnen worden geverifieerd

Voor API-details, zie de Antwoorden Endpoint API Referentie. Standaard gebruiken we een generieke webindex en een kostenefficiënte LLM-validator. Enterprise-klanten hebben toegang tot eigen branchespecifieke webindexen, exclusieve privégegevens (inclusief telefoonnummers en e-mails) en aangepaste LLM-modellen die het beste passen bij hun gebruikssituatie. Neem contact met ons op voor toegang: info@olostep.com

Gebruiksscenario’s

Het antwoorden endpoint kan worden gebruikt om:

AI-toepassingen te baseren op real-world data en feiten
Spreadsheets en gegevenspunten te verrijken voor Werving, Financiën, Consultancy en Verkoop

Hier is een demo van een AI-aangedreven spreadsheet aangedreven door het Antwoorden endpoint: https://www.olostep.com/demos/spreadsheet-enrich

Installatie

pip install olostep

npm install olostep

# curl is standaard beschikbaar op macOS, Linux en Windows

npm install node-fetch

pip install requests

Gebruik

Stel een vraag en geef een JSON-schema door om de output te sturen. Je kunt ook de json parameter niet doorgeven en de API zal een json-object teruggeven met de antwoordtekst binnen het result veld.

from olostep import Olostep

client = Olostep(api_key="YOUR_REAL_KEY")

answer = client.answers.create(
    task="Wat is het nieuwste boek van J.K. Rowling?",
    json_format={"book_title": "", "author": "", "release_date": ""},
)

print(answer.json_content)
print(answer.sources)

import Olostep from 'olostep'

const client = new Olostep({ apiKey: 'YOUR_REAL_KEY' })

const answer = await client.answers.create({
  task: 'Wat is het nieuwste boek van J.K. Rowling?',
  jsonFormat: { book_title: '', author: '', release_date: '' },
})

console.log(answer.json_content)
console.log(answer.sources)

curl -s -X POST "https://api.olostep.com/v1/answers" \
  -H "Authorization: Bearer $OLOSTEP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "Wat is het nieuwste boek van J.K. Rowling?",
    "json": {"book_title": "", "author": "", "release_date": ""}
  }'

olostep answer "Wat is het nieuwste boek van J.K. Rowling?" \
  --json-format '{"book_title":"","author":"","release_date":""}'

const res = await fetch('https://api.olostep.com/v1/answers', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer <YOUR_API_KEY>', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    task: 'Wat is het nieuwste boek van J.K. Rowling?',
    json: { book_title: '', author: '', release_date: '' }
  })
})
console.log(await res.json())

import requests, json

endpoint = "https://api.olostep.com/v1/answers"
payload = {
  "task": "Wat is het nieuwste boek van J.K. Rowling?",
  "json": {"book_title": "", "author": "", "release_date": ""}
}
headers = {"Authorization": "Bearer <YOUR_API_KEY>", "Content-Type": "application/json"}

response = requests.post(endpoint, json=payload, headers=headers)
print(json.dumps(response.json(), indent=2))

Antwoord

Net als bij andere Olostep endpoints, ontvang je een answer object als antwoord. Het answer object heeft een paar eigenschappen zoals id en result.

{
  "id": "answer_9bi0sbj9xa",
  "object": "answer",
  "created": 1760327323,
  "metadata": {},
  "task": "Wat is het nieuwste boek van J.K. Rowling?",
  "result": {
    "json_content": "{\"book_title\":\"The Hallmarked Man\",\"author\":\"J.K. Rowling (as Robert Galbraith)\",\"release_date\":\"2 September 2025\"}",
    "json_hosted_url": "https://olostep-storage.s3.us-east-1.amazonaws.com/answer_9bi0sbj9xa.json",
    "sources": [
      "https://strikefans.com/the-books/",
      "https://www.facebook.com/groups/496943608606523/posts/1136830134617864/",
      "https://robert-galbraith.com/strike-books/",
      "https://www.novelsuspects.com/series-list/robert-galbraith-cormoran-strike-series-in-order/",
      "https://www.reddit.com/r/books/comments/1na833a/jk_rowlings_new_strike_novel_900_pages_of_romance/",
      "https://www.harrypotter.com/writing-by-jk-rowling",
      "https://stories.jkrowling.com/book-news/",
      "https://deadline.com/2024/09/jk-rowling-writing-futuristic-novel-1236093909/",
      "https://www.reddit.com/r/FantasticBeasts/comments/1cl1shn/jk_rowling_may_2024_ive_got_six_more_books_in_my/",
      "https://www.jkrowling.com/news/"
    ]
  }
}

Je gevraagde antwoord, geformatteerd volgens de json parameter, bevindt zich in response.result.json_content en de lijst van bronnen in response.result.sources. Je kunt de geparste JSON-string gebruiken om toegang te krijgen tot de gestructureerde gegevens.

{
  "book_title": "The Hallmarked Man",
  "author": "J.K. Rowling",
  "release_date": "2 september 2025"
}

Voorbeeld van bronnen:

[
    "https://www.harrypotter.com/writing-by-jk-rowling",
    "https://stories.jkrowling.com/book-news/",
    "https://deadline.com/2024/09/jk-rowling-writing-futuristic-novel-1236093909/",
    "https://www.reddit.com/r/FantasticBeasts/comments/1cl1shn/jk_rowling_may_2024_ive_got_six_more_books_in_my/",
    "https://www.jkrowling.com/news/"
]

Wanneer je de json parameter niet doorgeeft, zal de API een json-object teruggeven met de antwoordtekst binnen het result veld.

{
  "result": "Het nieuwste boek van J.K. Rowling is The Hallmarked Man."
}

Flexibele `json` parameter

Geef een JSON-object met lege waarden als een schema, of een string die de gegevens beschrijft die je wilt.
Als de agent niet zeker is, retourneert het NOT_FOUND voor dat veld.

from olostep import Olostep

client = Olostep(api_key="YOUR_REAL_KEY")

answer = client.answers.create(
    task="Wanneer wordt React 30 uitgebracht?",
    json_format={"release_date": ""},
)

print(answer.json_content)

import Olostep from 'olostep'

const client = new Olostep({ apiKey: 'YOUR_REAL_KEY' })

const answer = await client.answers.create({
  task: 'Wanneer wordt React 30 uitgebracht?',
  jsonFormat: { release_date: '' },
})

console.log(answer.json_content)

import requests, json

endpoint = "https://api.olostep.com/v1/answers"
payload = {
  "task": "Wanneer wordt React 30 uitgebracht?", 
  "json": {
    "release_date": ""
  }
}
headers = {
  "Authorization": "Bearer <YOUR_API_KEY>",
  "Content-Type": "application/json"
}
response = requests.post(endpoint, json=payload, headers=headers)
print(json.dumps(response.json(), indent=2))

olostep answer "Wanneer wordt React 30 uitgebracht?" --json-format '{"release_date":""}'

Dit zou teruggeven:

{
  "release_date": "NOT_FOUND"
}

Opslag

Opgeslagen bestanden voor een antwoord worden standaard 7 dagen bewaard. Geef een storage object door bij POST /v1/answers om ze langer of voor onbepaalde tijd te bewaren. De instelling dekt het antwoordresultaat en de pagina’s die zijn opgehaald om het te bouwen.

Parameter	Type	Standaard	Beschrijving
`storage.expires_in`	`string`	`7d`	Hoelang de opgeslagen bestanden bewaard moeten blijven. Een van `7d`, `10d`, `30d`, `60d`, `90d`, `180d`, `365d`, of `never` (onbepaald).

Als je storage weglaat, of storage zonder expires_in stuurt, wordt 7d gebruikt. Zowel de creatie respons als GET /v1/answers/{answer_id} bevatten de waarde die van kracht is:

"storage": { "expires_in": "30d" }

cURL

curl -s -X POST "https://api.olostep.com/v1/answers" \
  -H "Authorization: Bearer $OLOSTEP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "Wat is de nieuwste stabiele versie van PostgreSQL?",
    "storage": { "expires_in": "30d" }
  }'

Een ongeldige waarde retourneert 400:

{
  "type": "invalid_request_error",
  "message": "Invalid storage.expires_in. Allowed values: \"7d\", \"10d\", \"30d\", \"60d\", \"90d\", \"180d\", \"365d\", \"never\".",
  "code": "invalid_storage_expires_in"
}

Prijsstelling

Antwoorden kosten 20 credits per aanvraag.

Aan de slag

Functies

Saldo & Facturering

Gebruiksscenario’s

Installatie

Gebruik

Antwoord

Flexibele `json` parameter

Opslag

Prijsstelling

​Gebruiksscenario’s

​Installatie

​Gebruik

​Antwoord

​Flexibele json parameter

​Opslag

​Prijsstelling

Gebruiksscenario’s

Installatie

Gebruik

Antwoord

Flexibele `json` parameter

Opslag

Prijsstelling