{"_id":"serpkite","_rev":"13-985d6728e53e4043c8b00d41a5cadd5c","name":"serpkite","dist-tags":{"latest":"0.10.0"},"versions":{"0.0.0-stage":{"name":"serpkite","version":"0.0.0-stage","_id":"serpkite@0.0.0-stage","stub":true,"maintainers":[{"name":"serpkite","email":"support@serpkite.com"}],"dist":{"shasum":"1621f9057db22e23ad2960e0109829a118b3dda4","tarball":"https://registry.npmjs.org/serpkite/-/serpkite-0.0.0-stage.tgz","fileCount":2,"integrity":"sha512-WUEJsx2s2pqz3dE+3VMfFRTWp8lNGiQNl8vlCgX/mO0tZSNN6WfS5q8Zjj4LGjVbWvkxVKd3NSF0yBjYN0OjXg==","signatures":[{"sig":"MEYCIQD5Ej4kS1yeatQ/cEZ/V4voLP9Hj2k6WQ9mS44v6S0HyQIhAMsi8wtFDBah2YewFznXmDBvgVpz6nNZ6N75vVgXAQkd","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":330},"_npmUser":{"name":"serpkite","email":"support@serpkite.com"},"description":"Temporary package placeholder for staged publishing","directories":{}},"0.1.1":{"name":"serpkite","version":"0.1.1","keywords":["serpkite","google","search","serp","api","ai","agents","llm","markdown"],"author":{"name":"SerpKite"},"license":"MIT","_id":"serpkite@0.1.1","maintainers":[{"name":"serpkite","email":"support@serpkite.com"}],"homepage":"https://serpkite.com/docs","bugs":{"url":"https://github.com/SerpKite/serpkite-js/issues"},"dist":{"shasum":"cd2ea7df7f0a393723451a9981f818c78b6f032b","tarball":"https://registry.npmjs.org/serpkite/-/serpkite-0.1.1.tgz","fileCount":9,"integrity":"sha512-/+vSSTqXhsCltm2YYca9nw6exGukgrMizf0R9u1OBuyuflSJShHO+HD385nX6PJGjQYIHrfZkNGHi/RH5dFg0Q==","signatures":[{"sig":"MEUCIBQfACqYLFq8JZW+RWwUA5lJa+CXjhUBvDvF6UCTgu6/AiEA8VO4idImpovbsVO9xQIsCT+DnFFYTidxQ6HXnJPgo28=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQDQIBUmdGbTfL9PMW1P717y7oH1jcHYlhHZ4NiRhaiXqwIgOvSoLr1uFyD31zjvi+2AC2Ena/Qu+O1+HeNx9eHX7Vo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/serpkite@0.1.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":296191},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=18"},"exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}},"./package.json":"./package.json"},"gitHead":"6b7e237bc8ccc133a4033faabe8120166195ddfa","scripts":{"gen":"bun scripts/gen.ts","test":"bun test","build":"tsup","typecheck":"tsc --noEmit","prepublishOnly":"bun run build"},"_npmUser":{"name":"serpkite","email":"support@serpkite.com"},"repository":{"url":"git+https://github.com/SerpKite/serpkite-js.git","type":"git"},"_npmVersion":"12.2.0","description":"Official TypeScript/JavaScript SDK for SerpKite, the Google search API built for AI agents: clean JSON or Markdown results.","directories":{},"sideEffects":false,"_nodeVersion":"24.21.0","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.0","@types/bun":"^1.3.0","typescript":"^6.0.3","openapi-typescript":"^7.13.0"},"_npmOperationalInternal":{"tmp":"tmp/serpkite_0.1.1_1790959938690_0.8499028821040344","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"serpkite","version":"0.2.0","keywords":["serpkite","google","search","serp","api","ai","agents","llm","markdown"],"author":{"name":"SerpKite"},"license":"MIT","_id":"serpkite@0.2.0","maintainers":[{"name":"serpkite","email":"support@serpkite.com"}],"homepage":"https://serpkite.com/docs","bugs":{"url":"https://github.com/SerpKite/serpkite-js/issues"},"dist":{"shasum":"85d283ff54fbf1af72c8c5be4af1c592ac200cda","tarball":"https://registry.npmjs.org/serpkite/-/serpkite-0.2.0.tgz","fileCount":9,"integrity":"sha512-xf6b13ji5/x4sTS9+XfIX1p0iYljngei8E7bPKVUHcywzoPASjPfrcctVHgT0JNBU6IXimpeUpZ6AEl8/AHHNw==","signatures":[{"sig":"MEUCIGQxYSexDKsvPu3o+xOwIpEmuhf1X2qTHrDzTcXR/Y+aAiEAimSwf7MwDqoBz5/72uCSxYpSotZni8t0dlgAGRtpc4E=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQDFOSyWQhwKKtvWbwMbUTi+6/qvfPXk3KJHVZUc7VHRDwIhANNazqh5liOZSDGo1JLeodmoJ+eszghSNl081Qj+BUI0","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/serpkite@0.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":288862},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=18"},"exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}},"./package.json":"./package.json"},"gitHead":"8fc28d5f73041076501f0d0cee956ac652035e64","scripts":{"gen":"bun scripts/gen.ts","test":"bun test","build":"tsup","typecheck":"tsc --noEmit","prepublishOnly":"bun run build"},"_npmUser":{"name":"serpkite","email":"support@serpkite.com"},"repository":{"url":"git+https://github.com/SerpKite/serpkite-js.git","type":"git"},"_npmVersion":"12.2.0","description":"Official TypeScript/JavaScript SDK for SerpKite, the Google search API built for AI agents: clean JSON or Markdown results.","directories":{},"sideEffects":false,"_nodeVersion":"24.21.0","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.0","@types/bun":"^1.3.0","typescript":"^6.0.3","openapi-typescript":"^7.13.0"},"_npmOperationalInternal":{"tmp":"tmp/serpkite_0.2.0_1790972637291_0.4493468592700429","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"serpkite","version":"0.3.0","keywords":["serpkite","google","search","serp","api","ai","agents","llm","markdown"],"author":{"name":"SerpKite"},"license":"MIT","_id":"serpkite@0.3.0","maintainers":[{"name":"serpkite","email":"support@serpkite.com"}],"homepage":"https://serpkite.com/docs","bugs":{"url":"https://github.com/SerpKite/serpkite-js/issues"},"dist":{"shasum":"2a97871e43590b71b492129c5b663a2023601b2d","tarball":"https://registry.npmjs.org/serpkite/-/serpkite-0.3.0.tgz","fileCount":9,"integrity":"sha512-n42B3iXObX6ifKUaoi7ILFmY/m328lV5VJ3hOwcFPlVVaidSKTaimdlNIAsjlfuQrk6HiIBTG8GmzW+FmvwAAQ==","signatures":[{"sig":"MEUCIGM4/uprGR5f+Vxq4luJSzxBsNscP2ji6W/q2UKAXe5gAiEAzPj6GLOplkKb6U0hknl2WNshuU2K80ovjiteMMBFCF0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIF9aRu0AOwfLJCYmnSwpUBlXjBuYRTmIWmfQS1RgidmmAiBuELid8OLwU9CxWUhoGr0evpORma0hezUijX8+09QhJQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/serpkite@0.3.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":282483},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=18"},"exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}},"./package.json":"./package.json"},"gitHead":"0d9eea532b4d7337df25ebca6a5fdd0e0f87237c","scripts":{"gen":"bun scripts/gen.ts","test":"bun test","build":"tsup","typecheck":"tsc --noEmit","prepublishOnly":"bun run build"},"_npmUser":{"name":"serpkite","email":"support@serpkite.com"},"repository":{"url":"git+https://github.com/SerpKite/serpkite-js.git","type":"git"},"_npmVersion":"12.2.0","description":"Official TypeScript/JavaScript SDK for SerpKite, the Google search API built for AI agents: clean JSON or Markdown results.","directories":{},"sideEffects":false,"_nodeVersion":"24.21.0","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.0","@types/bun":"^1.3.0","typescript":"^6.0.3","openapi-typescript":"^7.13.0"},"_npmOperationalInternal":{"tmp":"tmp/serpkite_0.3.0_1791044154039_0.4567763316418456","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"serpkite","version":"0.4.0","keywords":["serpkite","google","search","serp","api","ai","agents","llm","markdown"],"author":{"name":"SerpKite"},"license":"MIT","_id":"serpkite@0.4.0","maintainers":[{"name":"serpkite","email":"support@serpkite.com"}],"homepage":"https://serpkite.com/docs","bugs":{"url":"https://github.com/SerpKite/serpkite-js/issues"},"dist":{"shasum":"a60e57f0be230790d5e8b5453c3cac6a8c0ffe52","tarball":"https://registry.npmjs.org/serpkite/-/serpkite-0.4.0.tgz","fileCount":9,"integrity":"sha512-kYqt2QuxLPLMdc+Wnbe8WrIIZySawFIZxPzYqkDEGebYskZJtq5T67wRHqLovPQ0z4F5e19HQeLbGqW/nwkf5Q==","signatures":[{"sig":"MEYCIQC5GlMBebBGgMM9NS4a0JufNneCHtKtFh4Yie1FIUlAAAIhAJXvON1Apo+DE5xL3fjv0XuLqQippYKNliAuvLjyabQY","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIDCeWZNTqVnK52sViKctP1EPT3D51wcwh5ghmaCTsfsqAiBZzPWxdIqzhJZQZ/YIGbrKOdkx+hP9bDV4Mgv9wRpZ2Q==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/serpkite@0.4.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":472399},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=18"},"exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}},"./package.json":"./package.json"},"gitHead":"fa6c264be6745fb93efc64212379c5ceb3e37962","scripts":{"gen":"bun scripts/gen.ts","test":"bun test","build":"tsup","typecheck":"tsc --noEmit","prepublishOnly":"bun run build"},"_npmUser":{"name":"serpkite","email":"support@serpkite.com"},"repository":{"url":"git+https://github.com/SerpKite/serpkite-js.git","type":"git"},"_npmVersion":"12.2.0","description":"Official TypeScript/JavaScript SDK for SerpKite, the Google search API built for AI agents: clean JSON or Markdown results.","directories":{},"sideEffects":false,"_nodeVersion":"24.21.0","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.0","@types/bun":"^1.3.0","typescript":"^6.0.3","openapi-typescript":"^7.13.0"},"_npmOperationalInternal":{"tmp":"tmp/serpkite_0.4.0_1791077128405_0.1430149351023995","host":"s3://npm-registry-packages-npm-production"}},"0.5.0":{"name":"serpkite","version":"0.5.0","keywords":["serpkite","google","search","serp","api","ai","agents","llm","markdown"],"author":{"name":"SerpKite"},"license":"MIT","_id":"serpkite@0.5.0","maintainers":[{"name":"serpkite","email":"support@serpkite.com"}],"homepage":"https://serpkite.com/docs","bugs":{"url":"https://github.com/SerpKite/serpkite-js/issues"},"dist":{"shasum":"29a1d4694283774c28f82911715ae16b0c2105cb","tarball":"https://registry.npmjs.org/serpkite/-/serpkite-0.5.0.tgz","fileCount":9,"integrity":"sha512-54GXTMkO15tgD4gjnRsjaU2QsCpgmpAVS1ac/bCKtEfxB+ivKMsmE85uaacqp2mbu7SsGKFDHBrKpXuwngOf2w==","signatures":[{"sig":"MEUCIQDl94czaLaUlfEpLlRKPt0+XyWw3V05xh8g/9Q5koh4+wIgK2SiFOB0axBBrb8ihkr3YuHisd+fr6MuYP8Nd+UsC9g=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQDepubd0P2fUnluofDAPvuqzYu8d7xFx80gzYCP6zlmuQIgHRUj+T9z5UIVFYIu8OlEOUFcLE87iukXwVJ8orNF8nc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/serpkite@0.5.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":498596},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=18"},"exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}},"./package.json":"./package.json"},"gitHead":"149cabd60cdb36f30537c4ea6730b221db948e51","scripts":{"gen":"bun scripts/gen.ts","test":"bun test","build":"tsup","typecheck":"tsc --noEmit","prepublishOnly":"bun run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"08555057-d429-43dc-9755-0533122a979c"}},"repository":{"url":"git+https://github.com/SerpKite/serpkite-js.git","type":"git"},"_npmVersion":"12.2.0","description":"Official TypeScript/JavaScript SDK for SerpKite, the Google search API built for AI agents: clean JSON or Markdown results.","directories":{},"sideEffects":false,"_nodeVersion":"24.21.0","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.0","@types/bun":"^1.3.0","typescript":"^6.0.3","openapi-typescript":"^7.13.0"},"_npmOperationalInternal":{"tmp":"tmp/serpkite_0.5.0_1792571650103_0.4784274688740304","host":"s3://npm-registry-packages-npm-production"}},"0.6.0":{"name":"serpkite","version":"0.6.0","keywords":["serpkite","google","search","serp","api","ai","agents","llm","markdown"],"author":{"name":"SerpKite"},"license":"MIT","_id":"serpkite@0.6.0","maintainers":[{"name":"serpkite","email":"support@serpkite.com"}],"homepage":"https://serpkite.com/docs","bugs":{"url":"https://github.com/SerpKite/serpkite-js/issues"},"dist":{"shasum":"1d51d1661da642f0d1c76da22173cec0cdfcc758","tarball":"https://registry.npmjs.org/serpkite/-/serpkite-0.6.0.tgz","fileCount":9,"integrity":"sha512-dojK4IcluGfEaRQGroDMtBsySwyG17rw1L7Fq9nVU8HpdmN9d0R4dKybJd09SnyOpJNR9Wv8OOCbgb2+12Qjrg==","signatures":[{"sig":"MEYCIQCAei+SESDzFpBSDWAc8rduBnpLjhXTzVTry9NA7lMtIwIhAOsB+qMRruZXnAs6QxEQ+OTzpKQ8AaefgqPfQqs6wkxC","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIDvawd0mZKPUOGZ/7qpVe/pCK9LjAbbyDMepZa7OjX7DAiEAsDArd8VmKnZ8EuAdv5oDxhFRd7uje0zmiMBQEK0uXF8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/serpkite@0.6.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":503823},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=18"},"exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}},"./package.json":"./package.json"},"gitHead":"ff1e37bc5e3e1e14b797612b523e943dbfd8a69c","scripts":{"gen":"bun scripts/gen.ts","test":"bun test","build":"tsup","typecheck":"tsc --noEmit","prepublishOnly":"bun run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"08555057-d429-43dc-9755-0533122a979c"}},"repository":{"url":"git+https://github.com/SerpKite/serpkite-js.git","type":"git"},"_npmVersion":"12.2.0","description":"Official TypeScript/JavaScript SDK for SerpKite, the Google search API built for AI agents: clean JSON or Markdown results.","directories":{},"sideEffects":false,"_nodeVersion":"24.21.0","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.0","@types/bun":"^1.3.0","typescript":"^6.0.3","openapi-typescript":"^7.13.0"},"_npmOperationalInternal":{"tmp":"tmp/serpkite_0.6.0_1792576022456_0.38057966494531326","host":"s3://npm-registry-packages-npm-production"}},"0.7.0":{"name":"serpkite","version":"0.7.0","keywords":["serpkite","google","search","serp","api","ai","agents","llm","markdown"],"author":{"name":"SerpKite"},"license":"MIT","_id":"serpkite@0.7.0","maintainers":[{"name":"serpkite","email":"support@serpkite.com"}],"homepage":"https://serpkite.com/docs","bugs":{"url":"https://github.com/SerpKite/serpkite-js/issues"},"dist":{"shasum":"39d88387aa337fbec0a61654ee2517f11938776f","tarball":"https://registry.npmjs.org/serpkite/-/serpkite-0.7.0.tgz","fileCount":9,"integrity":"sha512-5ZOozKDLuN2LMQqemWQwOFXzvOtVXMv8o9rpi4r10dS2Frc2ZZawjxpi/IDrMErmwpmA3nHHtCeFlI3cmZTZJQ==","signatures":[{"sig":"MEUCIQCWAT1hrNQT9qgne0OYWxbxNe8FwUuPkv722kSPRO6E6AIgQSYQ8nOMW3hSHvtg5nPW9gsYBLxpzpQbLa0SeDBxSVw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQDNDvO//5EfpU974ct/megbEnsfmgcYe6KVRkuZdEBgCAIgMDmRNKxr/lXkJIzY3whI48vIojNwqNdeQbs2vIF3Cm4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/serpkite@0.7.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":634865},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=18"},"exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}},"./package.json":"./package.json"},"gitHead":"ef9901977b9f3cbb9a726b7871eb5a27fd4088fb","scripts":{"gen":"bun scripts/gen.ts","test":"bun test","build":"tsup","typecheck":"tsc --noEmit","prepublishOnly":"bun run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"08555057-d429-43dc-9755-0533122a979c"}},"repository":{"url":"git+https://github.com/SerpKite/serpkite-js.git","type":"git"},"_npmVersion":"12.2.1","description":"Official TypeScript/JavaScript SDK for SerpKite, the Google search API built for AI agents: clean JSON or Markdown results.","directories":{},"sideEffects":false,"_nodeVersion":"24.21.0","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.0","@types/bun":"^1.3.0","typescript":"^6.0.3","openapi-typescript":"^7.13.0"},"_npmOperationalInternal":{"tmp":"tmp/serpkite_0.7.0_1792844398477_0.38804165650301514","host":"s3://npm-registry-packages-npm-production"}},"0.8.0":{"name":"serpkite","version":"0.8.0","keywords":["serpkite","google","search","serp","api","ai","agents","llm","markdown"],"author":{"name":"SerpKite"},"license":"MIT","_id":"serpkite@0.8.0","maintainers":[{"name":"serpkite","email":"support@serpkite.com"}],"homepage":"https://serpkite.com/docs","bugs":{"url":"https://github.com/SerpKite/serpkite-js/issues"},"dist":{"shasum":"4e5996c8700d058e7cab45726df953a7a0b84556","tarball":"https://registry.npmjs.org/serpkite/-/serpkite-0.8.0.tgz","fileCount":9,"integrity":"sha512-/U+ZMSAVZ2gtMqWWdCoAYMz8H2AfcLmCohAcDxBrsLg6VMH4O3+brnuOLQuz72aRx7uuMlb603Skw27+qm87Gg==","signatures":[{"sig":"MEUCIQCayQRVS0u3DMe3+FTsqDtpl83GvPHB+nBUPjNarW2SEAIgR0ZXM18mCt4sXGdt/09gUMC5jrHaI/nMM4yqVDbFHug=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIG0RecWYBY+K/j108+9QIP/fNlzW+aTJhgX4Y7T5DYwiAiAIyG48GYAjBJSP7JpeaNXQMHdv/+mqhvc8XM4pvOg70A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/serpkite@0.8.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":700124},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=18"},"exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}},"./package.json":"./package.json"},"gitHead":"03f64126adce5d37a3ee3f5195e932381ac595da","scripts":{"gen":"bun scripts/gen.ts","test":"bun test","build":"tsup","typecheck":"tsc --noEmit","prepublishOnly":"bun run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"08555057-d429-43dc-9755-0533122a979c"}},"repository":{"url":"git+https://github.com/SerpKite/serpkite-js.git","type":"git"},"_npmVersion":"12.2.1","description":"Official TypeScript/JavaScript SDK for SerpKite, the Google search API built for AI agents: clean JSON or Markdown results.","directories":{},"sideEffects":false,"_nodeVersion":"24.22.1","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.0","@types/bun":"^1.3.0","typescript":"^6.0.3","openapi-typescript":"^7.13.0"},"_npmOperationalInternal":{"tmp":"tmp/serpkite_0.8.0_1793202563531_0.5593201604524594","host":"s3://npm-registry-packages-npm-production"}},"0.8.1":{"name":"serpkite","version":"0.8.1","keywords":["serpkite","google","search","serp","api","ai","agents","llm","markdown"],"author":{"name":"SerpKite"},"license":"MIT","_id":"serpkite@0.8.1","maintainers":[{"name":"serpkite","email":"support@serpkite.com"}],"homepage":"https://serpkite.com/docs","bugs":{"url":"https://github.com/SerpKite/serpkite-js/issues"},"dist":{"shasum":"4701aac4d7a5318150d956319e8a3fada31b0dbc","tarball":"https://registry.npmjs.org/serpkite/-/serpkite-0.8.1.tgz","fileCount":9,"integrity":"sha512-GNfCxW2s5APY5SOLeQiuAFhvXfaazKNP8zGoGQ+c3fDXgGu1fM4oUxHEZe2Ohk/1F3YJg+BVTrnIuAQvd5rlXA==","signatures":[{"sig":"MEYCIQD8U37y1pezvMCwAtzp5Aj4EKb/GIihz2g80kP/v/MMogIhAN+fW7695OdtMORoQcOiZOEi8LirUsbPu8M0dvI7pc3f","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIE9NiSyEW+WLKyU4GKM6YC7E/qk51FABlF5EWl2PNYvSAiEA3rRmJLYUETVA9g4wfzTePMhYFsbmKuWe+8wn6bWKj5Q=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/serpkite@0.8.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":702189},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=18"},"exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}},"./package.json":"./package.json"},"gitHead":"a2c0a6040caf02c15146af6f6d1fc659bf469cc3","scripts":{"gen":"bun scripts/gen.ts","test":"bun test","build":"tsup","typecheck":"tsc --noEmit","prepublishOnly":"bun run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"08555057-d429-43dc-9755-0533122a979c"}},"repository":{"url":"git+https://github.com/SerpKite/serpkite-js.git","type":"git"},"_npmVersion":"12.2.1","description":"Official TypeScript/JavaScript SDK for SerpKite, the Google search API built for AI agents: clean JSON or Markdown results.","directories":{},"sideEffects":false,"_nodeVersion":"24.22.1","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.0","@types/bun":"^1.3.0","typescript":"^6.0.3","openapi-typescript":"^7.13.0"},"_npmOperationalInternal":{"tmp":"tmp/serpkite_0.8.1_1793207444880_0.7389970809912841","host":"s3://npm-registry-packages-npm-production"}},"0.8.2":{"name":"serpkite","version":"0.8.2","keywords":["serpkite","google","search","serp","api","ai","agents","llm","markdown"],"author":{"name":"SerpKite"},"license":"MIT","_id":"serpkite@0.8.2","maintainers":[{"name":"serpkite","email":"support@serpkite.com"}],"homepage":"https://serpkite.com/docs","bugs":{"url":"https://github.com/SerpKite/serpkite-js/issues"},"dist":{"shasum":"4d19e3f762b1c1881e751fccdc614c218cfd5fa0","tarball":"https://registry.npmjs.org/serpkite/-/serpkite-0.8.2.tgz","fileCount":9,"integrity":"sha512-1tNi6icu1VYUakKDxUR9iyyWI8aHeNBM4zbUkOL5eiiUOfj8OAWiH9r0aAIdTNT6iC5aivvd4hZCR/iKnKoAzQ==","signatures":[{"sig":"MEQCICtSygtrJ+kW2sC5Wrk4/MyrnzNWRshf1pbc8Vz63kRKAiA+EP1fi9MGYwLaSgLnMqh+PHmBhCZj8NpIyb/2Pemi9g==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQCgOLhV0udf5nj5sHKt03k79vChA+Tz2x88G0clvDlSrQIgCVLqeAN62Zs8JD04Ruf6GGTQ/iOxObZ4octL4Ygra8I=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/serpkite@0.8.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":702045},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=18"},"exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}},"./package.json":"./package.json"},"gitHead":"70e9e6b70588bf18f02cdf50222e315c60b6498a","scripts":{"gen":"bun scripts/gen.ts","test":"bun test","build":"tsup","typecheck":"tsc --noEmit","prepublishOnly":"bun run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"08555057-d429-43dc-9755-0533122a979c"}},"repository":{"url":"git+https://github.com/SerpKite/serpkite-js.git","type":"git"},"_npmVersion":"12.2.1","description":"Official TypeScript/JavaScript SDK for SerpKite, the Google search API built for AI agents: clean JSON or Markdown results.","directories":{},"sideEffects":false,"_nodeVersion":"24.22.1","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.0","@types/bun":"^1.3.0","typescript":"^6.0.3","openapi-typescript":"^7.13.0"},"_npmOperationalInternal":{"tmp":"tmp/serpkite_0.8.2_1793230843037_0.9188480119917515","host":"s3://npm-registry-packages-npm-production"}},"0.9.0":{"name":"serpkite","version":"0.9.0","keywords":["serpkite","google","search","serp","api","ai","agents","llm","markdown"],"author":{"name":"SerpKite"},"license":"MIT","_id":"serpkite@0.9.0","maintainers":[{"name":"serpkite","email":"support@serpkite.com"}],"homepage":"https://serpkite.com/docs","bugs":{"url":"https://github.com/SerpKite/serpkite-js/issues"},"dist":{"shasum":"92de09bd52e9594b53c0df44b1c77ec0af883b90","tarball":"https://registry.npmjs.org/serpkite/-/serpkite-0.9.0.tgz","fileCount":9,"integrity":"sha512-vDCpQj4snWjFDdkqTawkpqOe2SNJ6sa5elSftDqHYwVsDa27OOJtD3jCEDl8dT+unHYVc74Jhv0MatyEh8o0Dw==","signatures":[{"sig":"MEUCIQDfxrWHrmVGg/hvPpnsQXId9BOEBgmWkCvMVJu2CVeTEgIgYKZMlVnWiRLxmEW+jdK0jFBpq3N4HvORM53rlpR5pO4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIFRj8VgVk+MzFoV6VdudqFe5e+sqU6R/8Lxir52I3WIFAiEAt+lFxCelp4lGnRbjmQQqXddth5Pk4c1LG0gVLPZ/258=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/serpkite@0.9.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":720791},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=18"},"exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}},"./package.json":"./package.json"},"gitHead":"37005cb7382fde133c268a898236335d09f14cae","scripts":{"gen":"bun scripts/gen.ts","test":"bun test","build":"tsup","typecheck":"tsc --noEmit","prepublishOnly":"bun run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"08555057-d429-43dc-9755-0533122a979c"}},"repository":{"url":"git+https://github.com/SerpKite/serpkite-js.git","type":"git"},"_npmVersion":"12.2.2","description":"Official TypeScript/JavaScript SDK for SerpKite, the Google search API built for AI agents: clean JSON or Markdown results.","directories":{},"sideEffects":false,"_nodeVersion":"24.22.1","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.0","@types/bun":"^1.3.0","typescript":"^6.0.3","openapi-typescript":"^7.13.0"},"_npmOperationalInternal":{"tmp":"tmp/serpkite_0.9.0_1793842840386_0.953009761701513","host":"s3://npm-registry-packages-npm-production"}},"0.10.0":{"_id":"serpkite@0.10.0","bugs":{"url":"https://github.com/SerpKite/serpkite-js/issues"},"dist":{"shasum":"06871aaaf61e573d13b97d7242768deb33207dab","tarball":"https://registry.npmjs.org/serpkite/-/serpkite-0.10.0.tgz","fileCount":9,"integrity":"sha512-OcAG0A4A6ee8/ly0MlbTavuUusP1VXOEWMOB3+yqvDttBQSRrSuz5H1s8te/UlDQUDZECUc34xtMMt0bofeA6Q==","signatures":[{"sig":"MEQCIEuctpC2eW9cdzkF3PAjKff3mQuZofTpFQxxbskPce4SAiBdfV5PusVOcPYmHyiPtdH3vMJZuKu9EeLds+xxUTymFQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCICnCkF/aXjrygQQlJM9XON9pQxGAAdRnrGE1khX+cJVeAiEAtkd6Zm1fbclUNQnOHYwmQBsGKx/KD1Sms0t3XS6UVt8="}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/serpkite@0.10.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":723516},"main":"./dist/index.cjs","name":"serpkite","type":"module","types":"./dist/index.d.ts","author":{"name":"SerpKite"},"module":"./dist/index.js","engines":{"node":">=18"},"exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}},"./package.json":"./package.json"},"gitHead":"3a0e60cd0073311ca0d761cdc72b4197ab9dbe9c","license":"MIT","scripts":{"gen":"bun scripts/gen.ts","test":"bun test","build":"tsup","typecheck":"tsc --noEmit","prepublishOnly":"bun run build"},"version":"0.10.0","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"08555057-d429-43dc-9755-0533122a979c"}},"homepage":"https://serpkite.com/docs","keywords":["serpkite","google","search","serp","api","ai","agents","llm","markdown"],"repository":{"url":"git+https://github.com/SerpKite/serpkite-js.git","type":"git"},"_npmVersion":"12.2.2","description":"Official TypeScript/JavaScript SDK for SerpKite, the Google search API built for AI agents: clean JSON or Markdown results.","directories":{},"maintainers":[{"name":"serpkite","email":"support@serpkite.com"}],"sideEffects":false,"_nodeVersion":"24.22.2","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.0","@types/bun":"^1.3.0","typescript":"^6.0.3","openapi-typescript":"^7.13.0"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/serpkite_0.10.0_1793920766902_0.1349405073800195"}}},"time":{"created":"2026-10-02T16:49:40.869Z","modified":"2026-11-05T23:19:27.362Z","0.0.0-stage":"2026-10-02T16:49:40.869Z","0.1.1":"2026-10-02T16:52:18.828Z","0.2.0":"2026-10-02T20:23:57.385Z","0.3.0":"2026-10-03T16:15:54.142Z","0.4.0":"2026-10-04T01:25:28.478Z","0.5.0":"2026-10-21T08:34:10.201Z","0.6.0":"2026-10-21T09:47:02.538Z","0.7.0":"2026-10-24T12:19:58.603Z","0.8.0":"2026-10-28T15:49:23.841Z","0.8.1":"2026-10-28T17:10:44.983Z","0.8.2":"2026-10-28T23:40:43.178Z","0.9.0":"2026-11-05T01:40:40.500Z","0.10.0":"2026-11-05T23:19:27.045Z"},"bugs":{"url":"https://github.com/SerpKite/serpkite-js/issues"},"author":{"name":"SerpKite"},"license":"MIT","homepage":"https://serpkite.com/docs","keywords":["serpkite","google","search","serp","api","ai","agents","llm","markdown"],"repository":{"url":"git+https://github.com/SerpKite/serpkite-js.git","type":"git"},"description":"Official TypeScript/JavaScript SDK for SerpKite, the Google search API built for AI agents: clean JSON or Markdown results.","maintainers":[{"name":"serpkite","email":"support@serpkite.com"}],"readme":"# serpkite\n\nOfficial TypeScript/JavaScript SDK for [SerpKite](https://serpkite.com), the Google search API built\nfor AI agents: clean JSON or Markdown, credits that never expire.\n\n- Zero runtime dependencies: uses the global `fetch`.\n- Works in Node 18+, Bun, Deno, Cloudflare Workers and other edge runtimes.\n- ESM and CommonJS builds with full type definitions, generated from the OpenAPI contract.\n- Retries with exponential backoff and jitter on `429`, `5xx` and network errors (honours `Retry-After`).\n\n## Install\n\n```bash\nnpm install serpkite\n# or: bun add serpkite / pnpm add serpkite / yarn add serpkite\n```\n\nDeno: `import { SerpKite } from \"npm:serpkite\";`\n\n## Quickstart\n\n```ts\nimport { SerpKite } from \"serpkite\";\n\nconst sk = new SerpKite(); // reads SERPKITE_API_KEY\nconst res = await sk.search({ q: \"best espresso machine\", country: \"us\" });\nconsole.log(res.results[0].title, res.meta.credits_used);\n\n// Markdown for an LLM prompt: `format: \"markdown\"` resolves to a string.\nconst md = await sk.search({ q: \"best espresso machine\", format: \"markdown\" });\n```\n\nGet an API key at [app.serpkite.com](https://app.serpkite.com) and export it:\n\n```bash\nexport SERPKITE_API_KEY=skt_live_...\n```\n\n## Configuration\n\n```ts\nconst sk = new SerpKite({\n  apiKey: \"skt_live_...\", // default: process.env.SERPKITE_API_KEY\n  baseUrl: \"https://api.serpkite.com\", // default: SERPKITE_BASE_URL or https://api.serpkite.com\n  timeoutMs: 60_000, // per attempt\n  maxRetries: 2, // retries after the first attempt\n  retryDelayMs: 500, // base of the exponential backoff\n  fetch: customFetch, // default: globalThis.fetch\n  headers: { \"X-Request-Id\": \"my-trace-id\" }, // sent with every request\n});\n```\n\nThe constructor throws a `SerpKiteError` with code `missing_api_key` when no key is found. On\nruntimes without `process.env` (browsers, some edge platforms) pass `apiKey` explicitly. Don't\nship a secret key to a public web page.\n\nEvery method also takes a second `options` argument:\n\n```ts\nawait sk.search(\n  { q: \"espresso\" },\n  {\n    signal: AbortSignal.timeout(10_000),\n    timeoutMs: 20_000,\n    maxRetries: 0,\n    headers: { \"X-Request-Id\": \"trace-123\" },\n    onResponse: (info) => console.log(info.creditsUsed, info.creditsRemaining, info.cache),\n  },\n);\n```\n\n`onResponse` receives the billing headers of the successful response: `requestId`, `creditsUsed`,\n`creditsRemaining`, `costUsd`, `cache` (`HIT` | `MISS`), `latencyMs`, `tokensEstimate`, plus the raw\n`headers` and `status`.\n\n## Methods\n\nAll request and response fields are snake_case, exactly as in the HTTP API. Every vertical returns\nthe same envelope: `request` (the normalised request), `results` (the vertical's primary list),\nvertical-specific extras and `meta` (`request_id`, `credits_used`, `cached`, `latency_ms`, …).\n\n| Method | Endpoint | Params | Returns |\n| --- | --- | --- | --- |\n| `search(params)` | `POST /v1/search` | `SearchParams` | `SearchResponse` (results, `answer_box`, `knowledge_graph`, `people_also_ask`, `related_searches`, `top_stories`, `places`, `ads`) |\n| `images(params)` | `POST /v1/images` | `SearchParams` | `ImagesResponse` |\n| `videos(params)` | `POST /v1/videos` | `SearchParams` | `VideosResponse` |\n| `news(params)` | `POST /v1/news` | `SearchParams` | `NewsResponse` |\n| `maps(params)` | `POST /v1/maps` | `SearchParams` (+ `ll`: `\"@lat,lng,14z\"`) | `PlacesResponse` |\n| `places(params)` | `POST /v1/places` | `SearchParams` | `PlacesResponse` |\n| `place(params)` | `POST /v1/place` | `PlaceParams` (`place_id` \\| `cid` \\| `fid` \\| `oid` (Yandex Maps), `country`, `language`) | `PlacesResponse` (one place: `weekly_hours`, `photos`, `timezone`, …; empty when the id is unknown) |\n| `reviews(params)` | `POST /v1/reviews` | `ReviewsParams` (`place_id` \\| `cid` \\| `fid`, `sort`, `page_token`, `num` ≤ 50) | `ReviewsResponse` (+ `next_page_token`) |\n| `shopping(params)` | `POST /v1/shopping` | `SearchParams` | `ShoppingResponse` |\n| `scholar(params)` | `POST /v1/scholar` | `SearchParams` | `ScholarResponse` |\n| `patents(params)` | `POST /v1/patents` | `SearchParams` | `PatentsResponse` |\n| `autocomplete(params)` | `POST /v1/autocomplete` | `SearchParams` | `AutocompleteResponse` (`results[].value`) |\n| `webpage(params)` | `POST /v1/webpage` | `WebpageParams` (`url`, `include_html`) | `WebpageResponse` (`markdown`, `text`, `metadata`) |\n| `chatgpt(params)` | `POST /v1/chatgpt` | `ChatGPTParams` (`prompt`, `web_search`, `country`, `track`, `include_html`) | `AssistantResponse` |\n| `gemini` / `copilot` / `aiMode` / `braveAi(params)` | `POST /v1/gemini` / `copilot` / `ai_mode` / `brave_ai` | `AssistantParams` (`prompt`, `country`, `language`, `track`, `include_html`) | `AssistantResponse` (`text`, `markdown`, `sources`, `search_queries`, `products`, `places`, `mentions`) |\n| `rank(params)` | `POST /v1/rank` | `RankParams` (`q`, `domain`, `num`: 10\\|20\\|30\\|50\\|100) | `RankResponse` (`position` or `null`, `matches`, `checked`) |\n| `resolve(links)` | `POST /v1/resolve` | `string[]`: `link` values of results with `link_resolved: false` | `ResolveResponse` (`results[].status`/`destination`, `retry_after`; free) |\n| `answer(params)` | `POST /v1/answer` | `AnswerParams` (`q`, `depth`: `fast`\\|`standard`, `num_sources` 1-5, `output_schema`, search options) | `AnswerResponse` (`answer`, `citations`, `results`, `output`) |\n| `answerStream(params)` | `POST /v1/answer` (`stream: true`) | `AnswerParams` | `AsyncIterable<AnswerStreamEvent>` (`results`, `delta`…, `done`) |\n| `extract(params)` | `POST /v1/extract` | `ExtractParams` (`urls` ≤ 20, `format`, `query`, `highlights`, `summary`, `output_schema`, `prompt`, …) | `ExtractResponse` (`results`, `failed`) |\n| `map(params)` | `POST /v1/map` | `MapParams` (`url`, `search`, `limit`, `sitemap`, path filters) | `MapResponse` (`results[].url`) |\n| `crawl(params)` | `POST /v1/crawl` | `CrawlParams` (`url`, `limit` ≤ 1000, `max_depth` ≤ 10, …) | `TaskCreated` (`202`) |\n| `getCrawl(id)` / `cancelCrawl(id)` | `GET` / `DELETE /v1/crawl/{id}` | task id | `CrawlTask` / `TaskCancelResponse` |\n| `waitForCrawl(idOrTask, options?)` | polls `GET /v1/crawl/{id}` | task id or task | `CrawlTask` (`completed`, `failed` or `canceled`) |\n| `research(params)` | `POST /v1/research` | `ResearchParams` (`input`, `effort`: `lite`\\|`standard`\\|`deep`, `output_schema`, domains, `webhook_url`) | `TaskCreated` (`202`) |\n| `getResearch(id)` / `cancelResearch(id)` | `GET` / `DELETE /v1/research/{id}` | task id | `ResearchTask` / `TaskCancelResponse` |\n| `waitResearch(idOrTask, options?)` | polls `GET /v1/research/{id}` | task id or task | `ResearchTask` (`completed`, `failed` or `canceled`) |\n| `monitors.create/list/get/update/delete/run` | `/v1/monitors…` | `MonitorCreateParams`, `MonitorUpdateParams` | `Monitor`, `MonitorList` |\n| `monitors.runs(id, params?)` / `monitors.iterRuns(id)` | `GET /v1/monitors/{id}/runs` | `limit`, `before` | `MonitorRunList` / `AsyncIterable<MonitorRun>` |\n| `account()` | `GET /v1/account` | none | `Account` (`balance`, `plan`, `rate_limit_rps`, `month`, …) |\n| `batches.create(params)` | `POST /v1/batches` | `BatchCreateParams` | `BatchCreateResponse` |\n| `batches.get(id)` | `GET /v1/batches/{id}` | batch id | `Batch` |\n| `batches.wait(id, options?)` | polls `GET /v1/batches/{id}` | batch id or entry | `Batch` (`done` or `failed`) |\n\nCommon `SearchParams`: `q` (required), `country` (default `us`), `language` (default `en`),\n`location`, `uule`, `num` (10, or 100 for the depth bundle), `page` (1-10), `time`\n(`hour`|`day`|`week`|`month`|`year`), `tbs`, `device` (`desktop`|`mobile`), `safe`, `autocorrect`,\n`format` (`json`|`markdown`|`compact`), `fields`, `include_content` (0-5), `ads`, `max_age`,\n`engine`, `include_answer` (`search` and `news`).\n\n### Examples\n\n```ts\n// News from the last day in Germany\nconst news = await sk.news({ q: \"EZB Zinsen\", country: \"de\", language: \"de\", time: \"day\" });\n\n// Top 3 organic pages fetched as Markdown (+1 credit per page)\nconst deep = await sk.search({ q: \"rust async runtime comparison\", include_content: 3 });\nconsole.log(deep.results[0].content);\n\n// Only the fields you need\nconst lean = await sk.search({ q: \"espresso\", fields: \"results.title,results.link,answer_box\" });\n\n// Token-lean JSON for agents\nconst compact = await sk.search({ q: \"espresso\", format: \"compact\" });\n\n// One place in full: structured hours, phones, time zone, photos\nconst { results } = await sk.place({ place_id: \"ChIJN1t_tDeuEmsRUsoyG83frY4\" });\nconsole.log(results[0]?.timezone, results[0]?.weekly_hours?.monday); // [{ open: \"09:00\", close: \"17:00\" }]\n\n// Reviews, paged (the first 10 of a place)\nlet page = await sk.reviews({ place_id: \"ChIJN1t_tDeuEmsRUsoyG83frY4\", num: 5 });\nwhile (page.next_page_token) {\n  page = await sk.reviews({ place_id: \"ChIJN1t_tDeuEmsRUsoyG83frY4\", page_token: page.next_page_token });\n}\n\n// Any URL as Markdown\nconst doc = await sk.webpage({ url: \"https://example.com/blog/post\" });\nconsole.log(doc.metadata.title, doc.markdown);\n\n// Where does a domain rank?\nconst r = await sk.rank({ q: \"espresso machine\", domain: \"example.com\" });\nconsole.log(r.position ?? \"not in top 100\");\n\n// Account balance\nconst { balance, month } = await sk.account();\n\n// Cached result up to one hour old (half price on a hit)\nawait sk.search({ q: \"espresso\", max_age: 3600 });\n```\n\n`format: \"markdown\"` resolves to a `string` for every vertical that supports it; `format:\n\"compact\"` resolves to a `CompactResponse`. The return type follows the literal you pass. With\n`fields` the response contains only the requested keys, so treat the typed fields as optional.\n\n## Search controls\n\nDomain filters and date ranges work on search, news, images and videos; `boost_domains` on search\nand news; `highlights` on search with `include_content`. None of them costs extra credits.\n\n```ts\nconst res = await sk.search({\n  q: \"connection pooling\",\n  include_domains: [\"postgresql.org\", \"github.com/pgbouncer\", \".edu\"], // host, path prefix or TLD (≤ 20)\n  exclude_domains: [\"pinterest.com\"],\n  boost_domains: [\"postgresql.org\"], // to the top, keeping the rest\n  start_date: \"2026-01-01\", // YYYY-MM-DD, end_date too\n  include_content: 3,\n  highlights: true, // 3 query-ranked passages per page instead of the whole page\n});\nfor (const r of res.results) console.log(r.position, r.published_at, r.highlights?.[0]?.text);\n```\n\n## Search engines & fallback\n\nBy default every request is answered by Google only (`engine: \"google\"`); SerpKite already\nretries Google internally. Opt in to other providers with `engine`:\n\n```ts\n// Fall back to other enabled providers when Google is blocked or times out\nconst res = await sk.search({ q: \"best espresso machine\", engine: \"auto\" });\nconsole.log(res.meta.engine); // \"google\", or e.g. \"brave\" if Google was unavailable\nconsole.log(res.meta.route); // [{ provider: \"google\", outcome: \"blocked\", ms: 812 }, { provider: \"brave\", outcome: \"ok\", ms: 431 }]\n\n// Only these providers, in this order\nawait sk.news({ q: \"espresso\", engine: [\"google\", \"brave\"] });\n```\n\n- `engine` is `\"google\"` (default), `\"auto\"`, `\"consensus\"`, one `Provider` (`\"brave\"`, `\"bing\"`,\n  `\"yahoo\"`, `\"duckduckgo\"`, `\"mojeek\"`, `\"wikipedia\"`, `\"yandex\"`) or a `Provider[]` list. `\"auto\"` and `\"consensus\"` can't\n  be combined with other names; unknown names, or a provider that doesn't serve the endpoint, return\n  `400 invalid_request`.\n- `engine: \"consensus\"` (`search` only) asks several independent indexes in parallel, merges the\n  results by URL and ranks them by agreement: each result has `sources` (e.g.\n  `[\"google\", \"brave\"]`), `meta.engine` is `\"consensus\"`, and it costs the sum of one page per\n  provider that returned results.\n- `meta.engine` names the provider that answered; `meta.route` (`RouteStep[]`) lists each attempt\n  and its `outcome` (absent on cache hits). `request.engine` echoes what you asked for.\n- Credits (`meta.credits_used`, `X-Credits-Used`) follow the answering provider's price.\n\n## AI answers\n\n```ts\n// A cited answer grounded on live Google results (\"fast\" answers from the result page;\n// \"standard\", the default, also reads the top num_sources pages)\nconst res = await sk.answer({ q: \"what is retrieval-augmented generation\", depth: \"fast\" });\nconsole.log(res.answer); // Markdown with [1] markers\nfor (const c of res.citations) console.log(c.index, c.title, c.link);\nconsole.log(res.meta.credits, res.meta.llm); // { search, answer }, { provider, model, … }\n\n// Stream it: results first, then text deltas, then done (final answer, citations, meta)\nfor await (const ev of sk.answerStream({ q: \"what is retrieval-augmented generation\" })) {\n  if (ev.event === \"delta\") process.stdout.write(ev.data.text);\n  if (ev.event === \"done\") console.log(\"\\n\", ev.data.citations);\n}\n\n// Structured output: the answer as JSON matching your schema (not with streaming)\nconst facts = await sk.answer({\n  q: \"tallest building in the world\",\n  output_schema: { type: \"object\", properties: { name: { type: \"string\" }, height_m: { type: \"number\" } } },\n});\nconsole.log(facts.output);\n\n// A cited answer on top of a normal search or news response\nconst news = await sk.news({ q: \"ECB rate decision\", time: \"day\", include_answer: true });\nconsole.log(news.answer?.text, news.meta.warnings); // no answer + a warning (refunded) if the model failed\n```\n\n- A stream's `error` event (and a model failure on `answer`) is thrown as `SerpKiteError` with code\n  `ai_unavailable` (503); the model part is not charged. Breaking out of the `for await` loop\n  closes the connection and the model part is not charged either.\n- `extract` takes `summary: true` (an AI summary per page) and `output_schema` (+ optional\n  `prompt`; each page's data as JSON in `output`), each at an extra per-page price. A page whose\n  model step failed carries `summary_error` / `output_error` instead and isn't charged for it. Its\n  default `timeout` becomes 75 seconds with either.\n- AI prices (answers, `include_answer`, summaries, schema extraction, research) are listed at\n  [serpkite.com/pricing](https://serpkite.com/pricing); `meta.credits` on an answer splits the\n  search and the model part.\n\n## AI assistants\n\nAsk ChatGPT, Gemini, Copilot (Bing Copilot Search), Google AI Mode or Brave's AI answer a `prompt` as a\nlogged-out user and get the answer with the sources it cited, the searches it ran and the products\nand places it showed. `track` lists brands and domains to look for: each comes back in `mentions`.\n\n```ts\nconst res = await sk.chatgpt({\n  prompt: \"What are the best CRMs for a 10-person startup?\",\n  country: \"us\", // ask from an exit in this country (prices and shops follow it)\n  track: [\"hubspot.com\", \"Pipedrive\"],\n});\nconsole.log(res.model, res.markdown); // citations as [n](link), matching sources[].position\nfor (const s of res.sources) console.log(s.position, s.cited ? \"cited\" : \"listed\", s.domain);\nconsole.log(res.search_queries, res.products.map((p) => `${p.title} ${p.price}`));\nfor (const m of res.mentions ?? []) {\n  // mentioned: the text names it; cited: a cited source matches it; text_position 0-1 (-1: not named)\n  console.log(m.term, m.mentioned, m.cited, m.sources, m.text_position);\n}\n\nconst md = await sk.aiMode({ prompt: \"how to remove a red wine stain from wool\", format: \"markdown\" }); // string\nawait sk.gemini({ prompt: \"Wie funktionieren Wärmepumpen?\", country: \"de\", language: \"de\" });\n\n// Google's AI Overview on a normal search, when the page shows one\nconst serp = await sk.search({ q: \"how do heat pumps work\" });\nconsole.log(serp.ai_overview?.text, serp.ai_overview?.sources);\n```\n\n- Prices per answer: ChatGPT 4, Gemini 3, Copilot 3, AI Mode 2, Brave AI 2 credits (the same in\n  batches; `max_age` cache hits half). Failed, refused and empty answers are free.\n- Answers take 10-90 s: these methods wait at least `ASSISTANT_TIMEOUT_MS` (120 s) per attempt\n  unless you pass `timeoutMs`, and are retried only on `429` (a lost response is still billed).\n- `web_search` (default `true`) is ChatGPT only; `language` isn't taken by ChatGPT.\n- Run many prompts through `batches.create({ endpoint: \"chatgpt\", requests: [{ prompt }, …] })`, or\n  track an answer over time with a monitor (`endpoint: \"gemini\"`, `prompt`, `track`; see Monitors).\n\n## Research\n\n```ts\nconst task = await sk.research({\n  input: \"Compare managed Postgres vector search options in 2026\",\n  effort: \"standard\", // lite | standard (default) | deep\n});\nconst done = await sk.waitResearch(task); // polls until completed/failed/canceled (15 min default)\nif (done.status === \"completed\") {\n  console.log(done.result?.report); // Markdown report with [n] citations\n  for (const s of done.result?.sources ?? []) console.log(s.index, s.link, s.query);\n}\n```\n\n- Each `effort` has a flat price ([serpkite.com/pricing](https://serpkite.com/pricing)), reserved\n  up front and charged only when the report is written; failed research is refunded. `getResearch(id)` shows `progress` (`round`, `queries`, `sources`, `step`) while it\n  runs. `cancelResearch(id)` refunds a queued task; a running one stops at its next round and is\n  charged for the searches already run.\n- `output_schema` also returns the report as JSON in `result.output`; `include_domains` /\n  `exclude_domains`, `country` and `language` steer the searches.\n- Pass `webhook_url` to get a signed `research.completed` delivery (same envelope as\n  `crawl.completed`) instead of polling.\n\n## Map and extract\n\n```ts\n// The URLs of a site (1 credit): sitemaps + start page, canonicalised and deduplicated\nconst site = await sk.map({ url: \"https://docs.example.com/\", search: \"install\", include_paths: [\"^/guides/\"] });\nfor (const u of site.results) console.log(u.url);\n\n// Up to 20 URLs (HTML or PDF) as Markdown in one call: 1 credit per URL that came back\nconst pages = await sk.extract({ urls: site.results.slice(0, 5).map((u) => u.url), query: \"install\", highlights: 3 });\nfor (const f of pages.failed) console.log(\"failed\", f.url, f.error.code); // not charged\n```\n\n## Crawl\n\n```ts\nconst task = await sk.crawl({\n  url: \"https://docs.example.com/\",\n  limit: 200, // up to 1000 pages; max_depth up to 10\n  include_paths: [\"^/guides/\"],\n  sitemap: \"include\", // include (default) | only | skip\n  query: \"authentication\", // read the most relevant pages first\n});\nconst done = await sk.waitForCrawl(task); // polls until completed/failed/canceled\nfor (const p of done.result?.pages ?? []) console.log(p.url, p.markdown?.length);\nconsole.log(done.result?.stats.stopped); // done | limit | time_limit | size_limit | too_many_failures | canceled\n```\n\n- `crawl` reserves `limit` credits and charges 1 per page read (0.5 from cache); the rest is\n  refunded. A crawl that reads nothing fails (`no_pages`) and costs nothing.\n- It returns `202` with a task; `waitForCrawl` takes `{ timeoutMs, pollIntervalMs, maxPollIntervalMs,\n  signal }` like `batches.wait` (default timeout 35 minutes: a crawl runs for up to 30) and\n  returns failed or canceled tasks instead of throwing.\n- `cancelCrawl(id)` refunds a queued crawl; a running one stops at its next checkpoint\n  (`status: \"canceling\"`) and is charged for the pages read.\n- Robots.txt (per host) and Crawl-delay are honoured; `result.stats` reports `discovered`, `queued`,\n  `duplicates`, `sitemap_urls`, `robots`, `robots_blocked` and why it `stopped`.\n- Pass `webhook_url` to get a signed `crawl.completed` delivery instead of polling. A result over\n  4 MB arrives as `result: null` with `result_omitted: true`; fetch it from `poll_url`.\n\n## Monitors\n\n```ts\nconst mon = await sk.monitors.create({\n  q: \"ai agents\",\n  endpoint: \"news\",\n  interval: \"hourly\", // hourly | daily | weekly, or interval_seconds (3600-2592000)\n  webhook_url: \"https://example.com/hooks/serpkite\",\n});\nawait sk.monitors.run(mon.id); // due within ~30 s\nawait sk.monitors.update(mon.id, { active: false });\nawait sk.monitors.update(mon.id, { q: \"ai agents frameworks\", num: 20 }); // change the saved search\nconst { results } = await sk.monitors.list();\n\n// Run history, newest first (new results kept 24 h): one page, or every run\nconst page = await sk.monitors.runs(mon.id, { limit: 20 }); // page.next_before → { before }\nfor await (const run of sk.monitors.iterRuns(mon.id)) console.log(run.status, run.new_results);\nawait sk.monitors.delete(mon.id);\n```\n\nA `webpage` monitor watches one page instead of a search: it checks `url` each interval (1 credit\nper check) and reports it as a `MonitorPageChange` (`url`, `title`, `change: \"new\" | \"changed\"`,\n`content_hash`, `markdown`) when its content changes. `metadata` (your own JSON object, ≤ 2 KB) is\nstored on any monitor and echoed in its `monitor.results` webhooks; on `update`, an object replaces it\nand `null` clears it.\n\nAn AI assistant monitor (`endpoint`: `chatgpt`, `gemini`, `copilot`, `ai_mode` or `brave_ai`) asks\n`prompt` every run and reports every answer as one `MonitorAnswer` (`text`, `markdown`, `model`,\n`sources`, `new_sources` (links not seen in earlier runs), `search_queries`, `products` and, with\n`track`, `mentions`); its `monitor.results` webhook carries `prompt` instead of `q`. Each run costs\nthe endpoint's price.\n\n```ts\nawait sk.monitors.create({\n  endpoint: \"chatgpt\",\n  prompt: \"What are the best CRMs for a 10-person startup?\",\n  track: [\"hubspot.com\", \"Pipedrive\"],\n  interval: \"daily\",\n});\n```\n\n```ts\nconst watch = await sk.monitors.create({\n  endpoint: \"webpage\",\n  url: \"https://example.com/pricing\",\n  interval: \"daily\",\n  metadata: { customer: \"acme\" },\n});\nawait sk.monitors.update(watch.id, { metadata: null });\n```\n\nEach search run costs what its search costs (1 credit per 10 results, `num` 100 is 7; empty and failed runs are free) and POSTs only results it\nhasn't seen before (among the top `num`) as a `monitor.results` webhook. `webhook_url` is optional:\nwithout one, read new results from `monitors.runs`. `active: false` creates a monitor paused; after 10\nfailed runs in a row it pauses itself (`last_status: \"paused\"`) and `update(id, { active: true })`\nresumes it. `webhook_url: \"\"` removes the webhook; a changed search reports every result as new once.\n\n## Webhooks\n\nEvery delivery (`batch.completed`, `crawl.completed`, `research.completed`, `monitor.results`) is signed with\n`X-SerpKite-Signature`. `parseWebhook` verifies it and returns the event typed by\n`X-SerpKite-Event`, with `deliveryId` from `X-SerpKite-Delivery` (for `monitor.results`, the\n`run_id`) to deduplicate retries:\n\n```ts\nimport { parseWebhook } from \"serpkite\";\n\nconst ev = await parseWebhook(process.env.SERPKITE_WEBHOOK_SECRET!, rawBody, req.headers); // throws invalid_signature\nif (ev.type === \"monitor.results\") console.log(ev.data.metadata, ev.data.url, ev.data.new_results.length);\nif (ev.type === \"crawl.completed\") console.log(ev.data.status, ev.data.poll_url);\n```\n\n`verifyWebhook(secret, rawBody, headers)` only checks the signature and returns a boolean.\n\n## Batches\n\nBatch jobs cost half price. Submit 1-100 requests for one endpoint; each request becomes a job.\n\n```ts\nimport { isBatchError, SerpKite } from \"serpkite\";\n\nconst sk = new SerpKite();\nconst { batches } = await sk.batches.create({\n  endpoint: \"search\", // or images, news, maps, reviews, webpage, chatgpt, gemini, …\n  requests: [{ q: \"a\" }, { q: \"b\" }],\n  webhook_url: \"https://example.com/hooks/serpkite\", // optional\n});\n\nconst done = await sk.batches.wait(batches[0].id); // polls until done/failed\nconsole.log(done.status, done.result);\n\n// Wait for all queued jobs; skip entries that were rejected at submit time\nconst jobs = await Promise.all(batches.filter((b) => !isBatchError(b)).map((b) => sk.batches.wait(b)));\n```\n\n- `create` returns one entry per request, in order: a queued `Batch` or an error object\n  (`{ error: { code, message, request_id } }`). Use `isBatchError(entry)` to tell them apart.\n  Passing a rejected entry to `wait` throws its error.\n- `wait(idOrEntry, { timeoutMs = 600000, pollIntervalMs = 1000, maxPollIntervalMs = 10000, signal })`\n  polls with a growing interval. It returns failed jobs (check `status` and `error`) and throws a\n  `SerpKiteError` with code `timeout` when the deadline passes.\n- Pass `{ idempotencyKey }` as the second argument to `create` (e.g. a UUID you store with the batch)\n  to make it safe to retry: the server replays the first response for the same key and body for\n  24 hours, and the SDK then also retries 5xx and network errors.\n- Results are kept for 24 hours. Webhooks are always signed with `X-SerpKite-Signature` (HMAC-SHA256\n  of `<X-SerpKite-Timestamp>.<body>` with your webhook secret). Check a delivery with\n  `await verifyWebhook(secret, rawBody, req.headers)`.\n\n## Errors\n\nEvery failure is a `SerpKiteError`:\n\n```ts\nimport { SerpKite, SerpKiteError } from \"serpkite\";\n\ntry {\n  await sk.search({ q: \"espresso\" });\n} catch (err) {\n  if (err instanceof SerpKiteError) {\n    console.log(err.status, err.code, err.message, err.requestId);\n  }\n}\n```\n\n| `code` | `status` | Meaning |\n| --- | --- | --- |\n| `invalid_request` | 400 | Bad or unknown parameter |\n| `unauthorized` | 401 | Missing or invalid API key |\n| `insufficient_credits` | 402 | Balance too low |\n| `spend_cap_reached`, `key_limit_reached` | 403 | Account spend cap or per-key monthly limit hit |\n| `forbidden` | 403 | Not allowed |\n| `not_found` | 404 | Unknown batch id |\n| `rate_limited` | 429 | Too many requests (retried automatically) |\n| `daily_limit_reached` | 429 | The free daily limit is used up until 00:00 UTC; buying any pack removes it (never retried) |\n| `upstream_error`, `upstream_blocked` | 503 | Google could not be fetched (not billed, retried) |\n| `upstream_timeout` | 503 | The search took too long (not billed, retried) |\n| `ai_unavailable` | 503 | The AI model failed or AI is off (model part refunded; honours `Retry-After`) |\n| `unavailable` | 503 | Temporarily unavailable (retried) |\n| `internal` | 500 | Server error (retried) |\n| `connection_error`, `timeout` | 0 | No response received |\n| `missing_api_key` | 0 | No key passed and `SERPKITE_API_KEY` unset |\n\nFailed, empty and blocked searches are refunded, so they never cost credits.\n\n## Retries\n\nRequests are retried up to `maxRetries` times (default 2) on `429` (except\n`daily_limit_reached`), `5xx`, network errors and timeouts, with exponential backoff (`retryDelayMs · 2^attempt`, capped at 8 s) and jitter. A\n`Retry-After` header (seconds or HTTP date, capped at 60 s) takes precedence. Other `4xx` errors\nare never retried. `batches.create`, `crawl`, `research`, `extract`, `answer`, the AI assistant\nmethods, `monitors.create` and `monitors.run` retry only on `429`, so a lost response can never queue (and bill) the same\nwork twice. `answerStream` retries only until the stream starts. `answer` and `answerStream` wait\nat least 100 s for the response headers (the search runs first) unless you pass `timeoutMs`.\n\n## Types\n\nTypes are generated from the OpenAPI contract (`backend/api/serp-api.yaml`) with\n`openapi-typescript`. Friendly aliases are exported: `SearchParams`, `SearchResponse`,\n`OrganicResult`, `AnswerBox`, `NewsResponse`, `NewsResult`, `ImagesResponse`, `PlacesResponse`,\n`PlaceParams`, `PlaceResult`, `WeeklyHours`, `HoursInterval`, `PlacePhoto`, `ReviewsResponse`,\n`ShoppingResponse`, `ScholarResponse`, `PatentsResponse`, `AutocompleteResponse`, `WebpageResponse`,\n`RankResponse`, `ResolveResponse`, `ResolvedLink`,\n`Account`, `Batch`, `BatchCreateParams`, `Meta`, `Engine`, `Provider`, `RouteStep`,\n`CompactResponse`, `MapResponse`, `ExtractResponse`, `CrawlParams`, `CrawlTask`, `CrawlResult`,\n`TaskCreated`, `AnswerParams`, `AnswerResponse`, `AnswerStreamEvent`, `Citation`, `SearchAnswer`,\n`LLMUsage`, `AssistantParams`, `ChatGPTParams`, `AssistantResponse`, `AISource`, `AIProduct`,\n`Mention`, `AIOverview`, `MonitorAnswer`, `ResearchParams`, `ResearchTask`, `ResearchResult`, `ResearchSource`,\n`Monitor`, `MonitorRun`, `MonitorPageChange`, `TaskCompletedEvent`,\n`MonitorResultsEvent`, `WebhookEvent` and more. The raw\n`paths`, `components` and `operations` types are exported as well.\n\n## Development\n\n```bash\nbun install          # from the repo root\nbun run gen          # regenerate src/generated/openapi.ts from backend/api/serp-api.yaml\nbun run typecheck\nbun test\nbun run build        # dist/: ESM, CJS and .d.ts\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}