One Endpoint to Rule Them All
Most enrichment tools force you to pick your lane. “We enrich company data.” Or “We enrich leads.” Cute, but not helpful if you’re working in biotech, gaming, real estate, and finance on the same Tuesday.
NiftyBot doesn’t care what you throw at it. Send us a basketball player, a legal case, a protein sequence, or your fantasy football roster. /v1/enrich figures it out. You define the fields you want, we go hunt them down, run them through our AI pipeline, and hand you back answers with reasoning and confidence baked in.
Think of it like asking a bartender for “something good.” Normally that gets you a PBR. With us, it gets you a craft cocktail, the recipe, and a confidence score that says, “We’re 94% sure this is what you needed.”
What Happens Behind the Curtain
Here’s the rough play-by-play when you hit /v1/enrich:
- Gatekeeping – First we sanity-check the request. Are you asking for something real? Or did your intern paste “lol pls gimme cat facts” into the JSON?
- Field Typing – You tell us what fields you want (numeric, text, boolean). This keeps the response tight. No paragraphs where you wanted an integer.
- Custom Instructions - Want your data a specific way? Feed us a list of options to choose from, dictate custom formatting, etc.
- Web Search or Internal Reasoning – If it needs the outside world, we hit our search pipeline. If it’s derivable, we compute internally. We don’t waste cycles.
- LLM Extraction – AI pulls the right nugget out of the noise. No hallucinated fluff — actual values.
- Synthesis – We package it up with reasoning and a confidence score so you know whether to trust it, double-check it, or laugh at your own source data.
- Delivery – All under ~2–3 seconds on average. About as long as it takes you to question your career choices in data engineering.
Why This Matters
Because data enrichment has historically been a nightmare. Every vertical has its “specialist” vendor who promises accuracy and delivers CSVs last updated when Vine was still a thing. Integrating five different APIs just to get a single customer profile stitched together? That’s time you could spend shipping product, raising capital, or arguing about whether tabs or spaces will ruin civilization.
With /v1/enrich, enrichment isn’t a project. It’s a utility. One endpoint. Works everywhere. No middle tiers, no “plans that only unlock LinkedIn data,” no praying the vendor doesn’t go down the night before launch.
The Magic API Philosophy
We built NiftyBot around one principle: developers shouldn’t need a PhD in vendor integration to make their data useful. APIs should just… work.
That’s why /v1/enrich has intentionally limited knobs. You don’t need 50 query parameters or arcane documentation. You send JSON with your source and requests, you get JSON back with values, confidence, and reasoning. Done.
We call it a magic API. Not because it’s mystical, but because it feels like cheating when you realize how much complexity we’ve buried under the hood.
Examples, Because We’re Nice
Enriching sports data? Easy:
{
"source": {
"player_name": "LeBron James",
"sport": "Basketball"
},
"requests": [
{ "field_name": "career_points" }, → 49,999
{ "field_name": "championships_won" } → 4
]
}
Want academic data instead? Swap the source:
{
"source": {
"author_name": "Dr. Jane Smith",
"institution": "MIT"
},
"requests": [
{ "field_name": "total_research_citations" }, → 6,905
{ "field_name": "research_areas" }, → Numerical Modeling, Civil Engineering, Simulation
{ "field_name": "most_recent_paper"} → Shifting alpine plant distributions with global change, 2024
]
}
Same endpoint. Same flow. Zero extra integrations.
What You Don’t See
You don’t see the retries, the search fallbacks, the extraction rescues, the normalization passes, the vector lookups, the caching logic. That’s all under the hood. What you do see is a clean response that fits into your pipeline without stress.
TL;DR
Enrichment shouldn’t be hard. With /v1/enrich, it isn’t. We take whatever messy source data you’ve got, figure out what you’re actually asking, and give you structured answers with reasoning and confidence in under a few seconds.
It’s universal. It’s fast. It’s simple. And yes, it’s a little bit magic.
Stop wrestling with brittle APIs and overpriced vendors. Just enrich it.
