Cribble API Reference
Build Filipino-first AI products with Cribble's REST API. Search, chat, education tools, and more — in Tagalog, Bisaya, Ilocano, and English.
Who is the Cribble API for?
Cribble is the AI platform built for the Philippines. Our API gives individuals, businesses, and AI developers access to Filipino-first intelligence for their own products.
Build personal projects, bots, and tools on the free tier. No credit card — just a Solana wallet.
Add AI search, Q&A, and chat to your app. Customer support, knowledge bases, product discovery.
Build agents that search and reason in Filipino languages with structured JSON responses.
Integrate CribEdu tutoring. Subject-aware, grade-aware, built for Filipino students.
Authentication
Cribble uses wallet-based identity. Connect at cribble.ph/login to get your API key, then pass it as a Bearer token in every request.
Authorization: Bearer YOUR_API_KEY
https://cribble.ph/api
Plans & Access
Start free. Upgrade by holding $CRIB tokens — no subscriptions, no monthly billing.
- ✓ 100 requests / day
- ✓ Standard model
- ✓ 8k token context
- ✓ Search, Ask, Chat
- ✓ Filipino + English
- ✓ Unlimited requests
- ✓ Advanced model
- ✓ 200k token context
- ✓ All endpoints + CribEdu
- ✓ Agent mode
- ✓ Dedicated rate limits
- ✓ SLA & uptime guarantee
- ✓ White-label options
- ✓ Priority support
Search
Search the Cribble index with Philippine-prioritized results. Supports Filipino, Bisaya, Ilocano, and English.
| Parameter | Type | Description |
|---|---|---|
| qreq | string | Search query |
| topt | string | Tab: all · web · news · images · videos |
| langopt | string | Language: tl · ceb · ilo · en |
| pageopt | number | Page number (default: 1) |
| timeopt | string | Filter: any · hour · day · week · month |
curl "https://cribble.ph/api/search?q=Palawan+beaches&t=web" \ -H "Authorization: Bearer YOUR_API_KEY"
{
"results": [
{
"title": "Best Beaches in Palawan 2025",
"url": "https://example.com/palawan",
"snippet": "Palawan is consistently ranked...",
"domain": "example.com"
}
],
"totalResults": 42000,
"page": 1,
"lang": "en"
}AI Ask
Single-turn question answering with Philippine context and citations. Ideal for FAQs and government information lookups.
| Body param | Type | Description |
|---|---|---|
| qreq | string | The question to answer |
| modelopt | string | "standard" (default) or "advanced" (Pro) |
| langopt | string | Preferred response language |
curl -X POST "https://cribble.ph/api/ask" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"q":"Ano ang SSS contribution 2025?","model":"standard"}'{
"answer": "Ang SSS contribution para sa 2025...",
"sources": ["https://www.sss.gov.ph/"],
"lang": "tl"
}Chat
Multi-turn conversational AI with Philippine context. Ideal for customer support bots and virtual assistants.
| Body param | Type | Description |
|---|---|---|
| messagereq | string | Latest user message |
| historyopt | array | Previous messages: [{role, content}] |
| modelopt | string | "standard" or "advanced" |
| systemExtraopt | string | Additional system instructions |
const res = await fetch("https://cribble.ph/api/chat", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_KEY"
},
body: JSON.stringify({
message: "Paano mag-apply ng business permit?",
history: [],
model: "standard"
})
});
const { reply } = await res.json();CribEdu AI Tutor
Embed Filipino AI tutoring into your EdTech product. Grade-aware and subject-aware.
| Body param | Type | Description |
|---|---|---|
| messagereq | string | Student question |
| subjectreq | string | math · science · filipino · history · english · ict · values |
| levelreq | string | Grade 1–12 · College · Adult Learner |
| historyopt | array | Previous conversation turns |
Image Search
Search for images with Philippine-aware context and content filtering.
{
"images": [
{
"url": "https://example.com/image.jpg",
"thumbnail": "https://example.com/thumb.jpg",
"title": "Mayon Volcano Albay Philippines",
"width": 1200, "height": 800
}
]
}Models
Cribble offers two model tiers optimized for Philippine context and multilingual use.
Error Codes
{ "error": "Rate limit exceeded", "code": 429 }Rate Limits
| Plan | Requests/day | Model | Context |
|---|---|---|---|
| Free | 100 | Standard | 8k tokens |
| Pro ($CRIB) | Unlimited | Standard + Advanced | 200k tokens |
| Business | Custom | All | 200k tokens |
X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.Building AI Agents
All Cribble responses are structured JSON. Build autonomous agents that search and reason in Filipino languages.
import requests
API_KEY = "YOUR_API_KEY"
BASE = "https://cribble.ph/api"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}
def search(q):
return requests.get(f"{BASE}/search", params={"q": q}, headers=HEADERS).json()
def ask(question):
return requests.post(f"{BASE}/ask",
json={"q": question, "model": "advanced"},
headers=HEADERS).json()["answer"]
# Search then reason
results = search("SSS contribution 2025 Philippines")
answer = ask(f"Based on: {results['results'][0]['snippet']} "
f"— Magkano ang monthly SSS contribution?")
print(answer)systemExtra in /api/chat to give your agent a custom Filipino or English persona.Get API Access
Connect your wallet to start building for free. Hold $CRIB to unlock the Advanced model, unlimited requests, and CribEdu.