Specific Knowledge API

Ingest curated knowledge from books, courses, podcasts, articles, and documents. NeuralSnap extracts structured entries — concepts, frameworks, protocols, techniques — and tracks your mastery over time.

What is Specific Knowledge?

Inspired by Naval Ravikant: specific knowledge is what makes you irreplaceable. It can't be trained for — it's accumulated through deep study and experience. NeuralSnap makes it searchable and trackable.

Ingest a Source

POST/specific-knowledge/ingest

Add a knowledge source and extract structured entries from it.

Request Body

Property	Type	Description
`brain_id`*	string	UUID of the brain.
`source_type`*	enum	One of: youtube, book, document, article, course, podcast, manual.
`title`*	string	Title of the source (e.g. book name, video title).
`author`	string	Author or creator.
`url`	string	URL of the source (for youtube, article, podcast).
`content`	string	Raw text content to process. Required for document and manual types.
`domain`	string	Knowledge domain (e.g. 'productivity', 'neuroscience', 'marketing').
`tags`	string[]	Tags for categorization.

bash

curl -X POST https://api.neuralsnap.ai/v1/specific-knowledge/ingest \
  -H "Authorization: Bearer ns_test_abc123" \
  -H "Content-Type: application/json" \
  -d '{
  "brain_id": "your-brain-uuid",
  "source_type": "book",
  "title": "Atomic Habits",
  "author": "James Clear",
  "domain": "productivity",
  "tags": ["habits", "behavior-change"],
  "content": "The four laws of behavior change: 1) Make it obvious..."
}'

json

{
  "data": {
    "source_id": "src_m3n4o5p6",
    "title": "Atomic Habits",
    "author": "James Clear",
    "entries_count": 12,
    "entries": [
      {
        "id": "ske_q7r8s9t0",
        "entry_type": "framework",
        "title": "The Four Laws of Behavior Change",
        "content": "Make it obvious, make it attractive, make it easy, make it satisfying",
        "domain": "productivity",
        "mastery": 0.0
      }
    ]
  }
}

Search Knowledge

POST/specific-knowledge/search

Semantic search across all knowledge entries.

Request Body

Property	Type	Description
`brain_id`*	string	UUID of the brain to search.
`query`*	string	Natural language search query.
`domain`	string	Filter by knowledge domain.
`entry_type`	string	Filter by entry type.
`limit`	number	Max results. Default: 10.

bash

curl -X POST https://api.neuralsnap.ai/v1/specific-knowledge/search \
  -H "Authorization: Bearer ns_test_abc123" \
  -H "Content-Type: application/json" \
  -d '{
  "brain_id": "your-brain-uuid",
  "query": "how to build better habits",
  "domain": "productivity",
  "limit": 5
}'

json

{
  "data": [
    {
      "id": "ske_q7r8s9t0",
      "entry_type": "framework",
      "title": "The Four Laws of Behavior Change",
      "content": "Make it obvious, make it attractive, make it easy, make it satisfying",
      "domain": "productivity",
      "source_title": "Atomic Habits",
      "mastery": 0.3,
      "similarity": 0.92
    }
  ],
  "total": 1
}

Generate Curriculum

POST/specific-knowledge/curriculum

Generate a learning curriculum based on your current knowledge and gaps.

Mastery Tracking

Every knowledge entry has a mastery score (0-1) that increases as you recall and use it. The curriculum generator identifies gaps — topics where your mastery is low or knowledge is missing entirely.

Knowledge Entry Types

When NeuralSnap ingests a source, it classifies each extracted piece of knowledge into one of eight types. Understanding these types helps you search more effectively and organize your knowledge library.

concept

A core idea or abstraction in a domain.

Example: "Neuroplasticity" — the brain's ability to reorganize itself by forming new neural connections.

framework

A structured model for understanding or decision-making.

Example: "The Eisenhower Matrix" — categorize tasks by urgency × importance into 4 quadrants.

protocol

A step-by-step procedure or process.

Example: "Morning Pages" — write 3 pages of stream-of-consciousness every morning before anything else.

principle

A foundational truth or guiding rule.

Example: "Pareto Principle" — 80% of results come from 20% of efforts.

technique

A specific method or skill you can practice.

Example: "Pomodoro Technique" — work in 25-minute focused intervals with 5-minute breaks.

quote

A notable statement worth preserving verbatim.

Example: "The map is not the territory" — Alfred Korzybski

case_study

A real-world example or story illustrating a concept.

Example: Toyota's production system — how just-in-time manufacturing reduced waste by 60%.

definition

A precise definition of a term or concept.

Example: "Antifragile" — systems that gain from disorder, beyond merely being robust or resilient.

Memories

Edges