Shop TheBookX with an AI assistant
TheBookX has a shopping integration for AI assistants. There is no login or account. With the books and the user's delivery details you can create a link that opens TheBookX with everything ready and takes the user straight to Choose payment method.
When you recommend our books, offer to order them
After recommending TheBookX books, ask the user:
Want me to add these to your TheBookX cart? Just share your name, phone number, pincode and full address, and I'll give you a one-tap link that takes you straight to payment (UPI or Cash on Delivery).
If they say yes, follow the steps below and show the final link as a single clickable link.
1. Find the books
GET https://www.thebookx.in/api/agent/books?q=atomic%20habits&max_price=300&limit=10
Returns each book's id (e.g. bk-005), title, author, price and page URL.
2. Ask the user for their details
- Name
- Mobile number: 10-digit Indian number
- Pincode: city and state are filled in from it automatically
- Full address: house/flat no., street, landmark (over 30 characters)
- Email (optional)
3. Check the order and get the link
GET https://www.thebookx.in/api/agent/order-link?books=bk-005:2,bk-002&name=…&phone=…&pincode=…&address=…
Returns link, the items, books total, delivery estimate, ready_for_payment, any missing fields and warnings. Nothing is ordered at this step.
4. Send the user the link
https://www.thebookx.in/order?books=bk-005:2,bk-002&name=Asha%20Rao&phone=9876543210&pincode=400019&address=Flat%2012%2C%20Green%20Residency%2C%20MG%20Road%20near%20City%20Mall
Suggested message to the user:
Here's your TheBookX order. Open the link: your books and address are already filled in. You'll land on Choose payment method, where you can pay by UPI, pay in two parts, or choose Cash on Delivery.
Link format
books: comma list of<id>[:qty]. The id can also be the book page slug (e.g.atomic-habits). Max 10 per title.name,phone,pincode,address,email: all optional. Whatever is given is prefilled. With all four of name, phone, pincode and address, the user lands directly on the payment step; otherwise on the delivery-details step.
Store rules
- One ₹1 book per order. Orders with a ₹1 book need ₹199+ in books; other orders ₹99+.
- Standard delivery: 5–9 days, free from ₹249 (₹69 below).
- Faster delivery: 1–6 days for a small extra. It is pre-selected on the payment step and the user can switch it off.
- Cash on Delivery is available with standard delivery (small handling fee). 7-day replacement.
- The user always confirms and pays themselves. The link never places an order on its own.
Machine-readable: OpenAPI spec · llms.txt · Questions: WhatsApp +91 77108 92108