# LookHere.help

> AI knowledge-base customer support SaaS. Upload docs (PDF/Word/PPT/HTML/Markdown/TXT) → get a shareable link → visitors self-serve answers in ANY language, grounded strictly in your content. Pay per answer. WeChat/Alipay/USDT (TRC-20) accepted.

Base URL: https://lookhere.help
Machine-readable API spec: https://lookhere.help/openapi.json

## Quickstart for AI agents (no browser needed — full API flow)

All endpoints are plain HTTPS + JSON. Auth = `Authorization: Bearer <token>`.

### 1. Register (get 100 free answers instantly)
```bash
curl -X POST https://lookhere.help/api/register \
  -H "Content-Type: application/json" \
  -d '{"email":"agent@example.com","password":"choose-a-password"}'
# → {"token":"<JWT>","user":{"id":N,"email":"...","credits":100}}
```

### 2. Create a knowledge-base bot
```bash
curl -X POST https://lookhere.help/api/bots \
  -H "Authorization: Bearer <TOKEN>" -H "Content-Type: application/json" \
  -d '{"name":"My Store Support"}'
# → {"id":N,"share_id":"xxxxxxxxxx","url":"https://lookhere.help/b/xxxxxxxxxx"}
```

### 3. Add knowledge (text or file)
```bash
# plain text / markdown
curl -X POST https://lookhere.help/api/bots/<ID>/docs/text \
  -H "Authorization: Bearer <TOKEN>" -H "Content-Type: application/json" \
  -d '{"title":"Refund policy","text":"We offer 7-day no-questions-asked refunds..."}'

# file upload (PDF/DOCX/PPTX/HTML/MD/TXT/CSV/JSON, ≤10MB, ≤20 docs per bot)
curl -X POST https://lookhere.help/api/bots/<ID>/docs \
  -H "Authorization: Bearer <TOKEN>" \
  -F "file=@/path/to/catalog.pdf"
```

### 4. Share with humans
- Link: `https://lookhere.help/b/<share_id>`
- QR code (printable PNG): `https://lookhere.help/api/qr/<share_id>.png`
- Embed bubble on any website (one line):
  `<script src="https://lookhere.help/embed.js?id=<share_id>" async></script>`

### 5. Chat as a visitor (async — submit then poll)
```bash
# submit → job id (instant)
curl -X POST https://lookhere.help/api/chat/<share_id> \
  -H "Content-Type: application/json" \
  -d '{"message":"What is your refund policy?"}'
# → {"job_id":"<uuid>"}

# poll every ~1.5s until done
curl https://lookhere.help/api/chat/result/<job_id>
# → {"status":"done","reply":"We offer 7-day no-questions-asked refunds..."}
```
Each visitor question deducts 1 credit from the bot owner.

### 6. Top up (if needed)
```bash
curl https://lookhere.help/api/pay/packs
# → starter ¥9.9/100 · basic ¥29/300 · business ¥99/1000
curl -X POST https://lookhere.help/api/pay/create \
  -H "Authorization: Bearer <TOKEN>" -H "Content-Type: application/json" \
  -d '{"method":"usdt","pack_id":"starter"}'
# method: "xunhu" (WeChat/Alipay) or "usdt" (TRC-20)
```

## Key facts
- Answers are grounded ONLY in the uploaded knowledge base; the bot says "I don't know" instead of inventing facts.
- Visitors can ask in any language (Chinese, English, Russian, Spanish, Portuguese, Turkish, Vietnamese, Arabic…); the answer comes back in the question's language.
- Rate limit: 30 questions/hour/IP on the chat endpoint.
- Free tier: 100 answers on signup, no card required.