API & Embed Documentation

1. Get an API key

1. Open Admin > Settings and scroll to the Developer & API card.
2. Type a name (for example "Main website") and press Create key.
3. Copy the key. It looks like vms_live_a1b2c3...

You can deactivate or delete a key at any time; integrations using it stop working immediately.

2. Embed the full store in your website (easiest)

Paste this one line of HTML anywhere on your site. It renders the complete book catalog, covers, ratings, prices and Buy buttons, matching this store's theme. Buy buttons open the checkout here in a new tab.

<iframe
  src="https://books.vickymartinsingh.com/embed?api_key=YOUR_API_KEY"
  style="width:100%; min-height:900px; border:0;"
  title="Books by Vicky Martin Singh"
  loading="lazy">
</iframe>

Works in Wix, WordPress, Squarespace, plain HTML, anywhere iframes are allowed. In Wix use the "Embed HTML" element and paste the code.

3. JSON API (for custom designs)

Prefer building your own layout? Fetch the data and render it yourself.

List all books

GET https://books.vickymartinsingh.com/api/v1/books
Authorization: Bearer YOUR_API_KEY

Or pass the key in the URL: ?api_key=YOUR_API_KEY

Optional filters

• ?q=regret search title, author and tags
• ?category=Self-help filter by category
• ?limit=10 cap the result count (max 100)

One book by slug

GET https://books.vickymartinsingh.com/api/v1/books/heartbeats-of-regret
Authorization: Bearer YOUR_API_KEY

Example response

{
  "count": 1,
  "books": [
    {
      "title": "Heartbeats of Regret",
      "subtitle": "The Breaking Point of Us",
      "author": "Vicky Martin Singh",
      "slug": "heartbeats-of-regret",
      "url": "https://books.vickymartinsingh.com/books/heartbeats-of-regret",
      "description": "...",
      "price": 499, "ebookPrice": 199, "currency": "INR",
      "coverUrl": "https://books.vickymartinsingh.com/api/blob/covers/....jpg",
      "images": [{ "url": "...", "kind": "FRONT" }],
      "rating": 5, "ratingCount": 12,
      "releaseStatus": "published", "trending": true,
      "platforms": [{ "name": "Amazon", "url": "...", "price": 349 }]
    }
  ]
}

Fetch from JavaScript

const res = await fetch(
  'https://books.vickymartinsingh.com/api/v1/books?api_key=YOUR_API_KEY'
)
const { books } = await res.json()
books.forEach(b => console.log(b.title, b.price))

CORS is open, so this works directly from any browser page. Responses are cached for 60 seconds.

Errors

• 401 missing, wrong or deactivated API key
• 404 book slug not found or unpublished