Serpapi iconSerpapiSep 18, 2026 ~7 min source read

Getting Started with Jev and SerpApi: A practical fact-checker tutorial

This tutorial shows how to combine TypeSafe’s Jev — a System One decision model — with SerpApi search results to build a lightweight fact-checker. It walks through the core workflow, required setup, verdict types, and implementation notes using Python and OpenRouter.

Getting Started with Jev: Building a Fact Checker with SerpApi

Share this story

Send the public story page.

Useful takeaways from this story.

A simple fact-checker workflow: fetch Google organic results with SerpApi, send titles/links/snippets to Jev via OpenRouter, and receive a verdict: supported, contradicted, mixed, or insufficient_evidence.

For yes/no or statement checks use Jev’s Choice decision type so the model returns a fixed verdict and associated probabilities that your code can act on.

# What Jev is and why it's different

Jev is TypeSafe's System One model designed for fast, structured decision-making. Unlike a large language model that generates free-form prose, Jev returns a decision in a fixed schema and attaches confidence probabilities. It accepts plain text, JSON objects, and arrays and supports three decision types: Choice, Score, and Noul.

# What the tutorial builds

The example project builds a fact-checker that evaluates a claim using fresh web evidence. Workflow in two API calls:

  • Use SerpApi to fetch Google organic results for the user's query.
  • Send the user input plus the returned titles, links, and snippets to Jev through OpenRouter and receive a verdict.

The verdict set for this tutorial is: supported, contradicted, mixed, or insufficient_evidence. For yes/no questions, supported maps to evidence for "yes," contradicted maps to evidence for "no." For general statements the verdict indicates whether the snippets support the statement.

# Practical workflow and data flow

  1. Receive user claim or question. Example used in the tutorial: "Did Marie Curie win two Nobel Prizes?"
  2. Call SerpApi's Google search endpoint to fetch organic results (titles, links, snippets). Keep the returned items alongside the user query.
  3. Build a structured input that includes the question and the search snippets and send that payload to Jev via OpenRouter.
  4. Jev responds with a Choice verdict and probabilities. Store or display the verdict with the accompanying search results.

This flow keeps the raw search evidence available for inspection while letting Jev produce a concise decision your application can act on.

# Setup and implementation notes

  • Language and runtime: Python 3.10 or newer.
  • Dependencies and commands: the tutorial references a repo on GitHub and a dependency install step (the text shows an install command that includes a sync/locked step). Follow the repository for exact commands and files.
  • Accounts and keys: you need an active SerpApi account to call Google organic results and an OpenRouter API key with access to Jev.
  • Integration: the tutorial uses Python and calls Jev through OpenRouter. The project demonstrates how to format the search results and the question for Jev's Choice decision type.

# Verdict meanings and how to use them in code

  • supported: snippets support the claim (for yes/no, supports yes).
  • contradicted: snippets argue against the claim (for yes/no, supports no).
  • insufficient_evidence: the search snippets do not provide enough information to decide.

Use the returned probabilities to drive thresholds in your application (for example, only label strongly supported when probability exceeds your chosen cutoff). Keep the original snippets available so a human can inspect sources when needed.

# Where to find the code and next steps

The tutorial points to a GitHub repository containing the full code and example project. The implementation focuses on using Jev for decision outputs and SerpApi for fresh web evidence. From here, teams can adapt the input formatting, extend the set of verdict labels, or incorporate additional search sources supported by SerpApi.

More context around this story.

Jev: как устроен его API решений и что на нём уже строят
Habr iconHabrSep 19, 2026

Jev: как устроен его API решений и что на нём уже строят

За три дня вокруг Jev выросла маленькая экосистема: браузерный агент искал авиабилеты за семь секунд, разработчики собрали торгового бота, фильтры контента и даже Tesla FSD. Но Jev не пишет текст. Его API выбирает ответ из пространства, которое заранее задало приложение. Я разобрал документацию TypeSafe, код jev-ultraf

Loading more related stories...

Keep reading in the app

Open the app view to save this story, compare related coverage, and continue from the same source.

Open in app