Partner API

The TutorQ Partner API lets you integrate curriculum-grounded search into your own application. Your students ask questions, our API returns answers from the actual course materials — no hallucinations, no generic content.

How It Works

Your App → POST /api/v1/partner/search → TutorQ → Grounded Results

Setup (one-time): We create a university tenant for you, you upload course materials, we process them
Integration: Your backend calls our search API with an API key
Runtime: Students get answers grounded in your curriculum

Endpoints

Method	Endpoint	Description
`GET`	`/api/v1/partner/courses`	List your available courses
`POST`	`/api/v1/partner/search`	Search course materials

What You Get

Course listing — See all your courses with processed materials, get course IDs for search
Search API — Query course materials and get relevant passages
Data Isolation — Your API key is tied to your organization. You only see your materials.
Usage Tracking — Every request is logged. Monthly summaries available for billing.
Rate Limiting — Default 100 requests/minute per API key (configurable)

Base URL

https://api.tutorq.ai

Quick Start

curl -X POST https://api.tutorq.ai/api/v1/partner/search \
  -H "Content-Type: application/json" \
  -H "x-api-key: tq_pk_your_api_key_here" \
  -d '{
    "query": "What is the anatomy of the retina?",
    "course_id": "your-course-id"
  }'

Response:

{
  "success": true,
  "results": [
    {
      "title": "Anatomy of the Eye - Retinal Layers",
      "content": "The retina is a thin layer of neural tissue...",
      "key_terms": ["retina", "photoreceptors", "rods", "cones"],
      "images": ["Cross-section diagram showing retinal layers"]
    }
  ],
  "total_results": 1,
  "query": "What is the anatomy of the retina?"
}

Next Steps

Authentication — How API keys work
Search Endpoint — Full API reference
Usage & Billing — Track usage and costs
Integration Guide — Step-by-step setup

For Students Authentication