@builtwith/sdk 1.1.0 → 1.3.0

package/README.md

@@ -59,6 +59,10 @@ if (result.ok) {
 | `trust({ lookup })` | Root domain | Trust scoring |
 | `financial({ lookup })` | Root domain | Financial data |
 | `social({ lookup })` | Root domain | Social profile related domains |
+| `vector_search({ query, limit? })` | Search query | Semantic technology/category search |
+| `payment_discovery()` | — | Agent Payment API: credit balance |
+| `payment_configuration()` | — | Agent Payment API: spending limits |
+| `payment_purchase({ credits })` | Integer ≥ 2000 | Agent Payment API: purchase credits |
 
 ### Response Format
 
@@ -124,6 +128,10 @@ All methods accept a `CancellationToken` as an optional last parameter.
 | `trust(lookup)` | `string` | Trust scoring |
 | `financial(lookup)` | `string` | Financial data |
 | `social(lookup)` | `string` | Social profile related domains |
+| `vector_search(query, limit?)` | `string`, `int?` | Semantic technology/category search |
+| `payment_discovery()` | — | Agent Payment API: credit balance |
+| `payment_configuration()` | — | Agent Payment API: spending limits |
+| `payment_purchase(credits)` | `int` ≥ 2000 | Agent Payment API: purchase credits |
 
 ### Response Format
 
@@ -146,6 +154,23 @@ BUILTWITH_API_KEY=your-key dotnet run
 
 ---
 
+## Agent Payment API
+
+The payment methods let AI agents check credit balances, view spending configuration, and purchase credits. They route through the standard MCP endpoint using your existing API key. Configure billing at [payments.builtwith.com/agent-payment-api-config](https://payments.builtwith.com/agent-payment-api-config).
+
+```js
+// Node.js
+const result = await client.payment_discovery();
+// result.data => { credits_total, credits_used, credits_available }
+```
+
+```csharp
+// C#
+var result = await client.payment_discovery();
+```
+
+---
+
 ## Prompt Helpers
 
 Both SDKs include prompt helper methods for use with AI agents:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@builtwith/sdk",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "BuiltWith AI-first SDK for Node.js",
   "main": "src/index.js",
   "exports": {

package/src/index.js

@@ -1,6 +1,7 @@
 'use strict';
 
 const https = require('https');
+const http = require('http');
 const { URL } = require('url');
 
 // ── Constants ──────────────────────────────────────────────────────────────────
@@ -100,10 +101,11 @@ function _parse_sse_body(raw_body) {
 function _http_post(url_str, body, headers, timeout_ms) {
   return new Promise((resolve, reject) => {
     const parsed = new URL(url_str);
+    const transport = parsed.protocol === 'http:' ? http : https;
     const payload = JSON.stringify(body);
     const opts = {
       hostname: parsed.hostname,
-      port: parsed.port || 443,
+      port: parsed.port || (parsed.protocol === 'http:' ? 80 : 443),
       path: parsed.pathname + parsed.search,
       method: 'POST',
       headers: {
@@ -115,7 +117,7 @@ function _http_post(url_str, body, headers, timeout_ms) {
       timeout: timeout_ms,
     };
 
-    const req = https.request(opts, (res) => {
+    const req = transport.request(opts, (res) => {
       const chunks = [];
       res.on('data', chunk => chunks.push(chunk));
       res.on('end', () => {
@@ -328,6 +330,38 @@ class BuiltWithClient {
     return this._request('vector-search', { query, ...(limit != null ? { limit } : {}) });
   }
 
+  async keyword_search(params) {
+    const { keyword, limit, offset } = params || {};
+    _validate_string('keyword', keyword);
+    return this._request('keyword-search-api', {
+      keyword,
+      ...(limit != null ? { limit } : {}),
+      ...(offset != null ? { offset } : {}),
+    });
+  }
+
+  async payment_discovery() {
+    return this._request('payment-balance', {});
+  }
+
+  async payment_configuration() {
+    return this._request('payment-config', {});
+  }
+
+  async payment_purchase(params) {
+    const { credits } = params || {};
+    if (credits === undefined || credits === null) {
+      throw new BuiltWithError('VALIDATION_ERROR', 'credits is required.', 0, null, 'Provide a credits value (minimum 2000).');
+    }
+    if (typeof credits !== 'number' || !Number.isInteger(credits)) {
+      throw new BuiltWithError('VALIDATION_ERROR', 'credits must be an integer.', 0, null, 'Provide a whole number of credits.');
+    }
+    if (credits < 2000) {
+      throw new BuiltWithError('VALIDATION_ERROR', 'credits must be at least 2000.', 0, null, 'Minimum purchase is 2000 credits.');
+    }
+    return this._request('payment-purchase', { credits });
+  }
+
   // ── Prompt helpers ─────────────────────────────────────────────────────────
 
   prompt_analyze_tech_stack(params) {