Official SDKs

TypeScript and Python packages for the ScienceToStartup API.

TypeScript

The official TypeScript SDK provides typed access to every endpoint on the developer surface. It handles authentication, request signing, and response parsing out of the box.

pnpm add @sciencetostartup/sdk

Basic usage

import { ScienceToStartupClient } from "@sciencetostartup/sdk";

const client = new ScienceToStartupClient({
  apiKey: process.env.SCIENCETOSTARTUP_API_KEY!,
});

const papers = await client.papers.search({
  q: "voice agents",
  limit: 3,
});

console.log(papers);

npm registry

The package is published as @sciencetostartup/sdk on npm. Compatible with Node 18+, Bun, and Deno.

Python

The Python SDK mirrors the TypeScript client with an idiomatic API. It supports both synchronous and async usage and ships with full type annotations.

pip install sciencetostartup-sdk

Basic usage

import os
from sciencetostartup_sdk import ScienceToStartupClient

client = ScienceToStartupClient(
    api_key=os.environ["SCIENCETOSTARTUP_API_KEY"],
)

papers = client.papers.search(
    q="voice agents",
    limit=3,
)

print(papers)

PyPI

Published as sciencetostartup-sdk on PyPI. Requires Python 3.9+.

Authentication

Both SDKs accept an API key at construction time. The key is sent as a Bearer token on every request. You can obtain a key from the Developer Keys page.

import { ScienceToStartupClient } from "@sciencetostartup/sdk";

// Recommended: load from environment variable
const client = new ScienceToStartupClient({
  apiKey: process.env.SCIENCETOSTARTUP_API_KEY!,
});

Keep your key secret

Never commit API keys to source control. Store them in environment variables or a secrets manager. Rotate keys immediately if exposed.

Quick Example

The canonical flow: search for papers, seed a workspace, then run a launch-pack action -- all from the same client instance.

Search for papers

Query the paper index to find research relevant to your domain.

const papers = await client.papers.search({
  q: "voice agents LLM",
  limit: 5,
});

const topPaper = papers[0];
console.log(topPaper.title, topPaper.id);

Seed a workspace

Create a workspace from the paper to begin structured analysis.

const workspace = await client.workspaces.createFromSeed({
  paperId: topPaper.id,
  name: "Voice Agent Research",
});

console.log(workspace.id);

Run a launch pack

Execute a launch-pack action to generate commercialization intelligence.

const result = await client.workspaces.runAction({
  workspaceId: workspace.id,
  action: "launch-pack",
});

console.log(result.status);

Verification

Before wiring the SDK into a production workflow, verify that your key is valid and your account is correctly provisioned by calling the whoami endpoint.

const me = await client.whoami();

console.log(me.userId);  // your account ID
console.log(me.tier);    // "sandbox" | "pro" | "agent"

Verify before building

Always confirm your key works with whoami before integrating the SDK into a larger workflow. This avoids debugging auth issues inside complex pipelines.

Official SDKs

TypeScript and Python packages for the ScienceToStartup API.

TypeScript

The official TypeScript SDK provides typed access to every endpoint on the developer surface. It handles authentication, request signing, and response parsing out of the box.

pnpm add @sciencetostartup/sdk

Basic usage

import { ScienceToStartupClient } from "@sciencetostartup/sdk";

const client = new ScienceToStartupClient({
  apiKey: process.env.SCIENCETOSTARTUP_API_KEY!,
});

const papers = await client.papers.search({
  q: "voice agents",
  limit: 3,
});

console.log(papers);

npm registry

The package is published as @sciencetostartup/sdk on npm. Compatible with Node 18+, Bun, and Deno.

Python

The Python SDK mirrors the TypeScript client with an idiomatic API. It supports both synchronous and async usage and ships with full type annotations.

pip install sciencetostartup-sdk

Basic usage

import os
from sciencetostartup_sdk import ScienceToStartupClient

client = ScienceToStartupClient(
    api_key=os.environ["SCIENCETOSTARTUP_API_KEY"],
)

papers = client.papers.search(
    q="voice agents",
    limit=3,
)

print(papers)

PyPI

Published as sciencetostartup-sdk on PyPI. Requires Python 3.9+.

Authentication

Both SDKs accept an API key at construction time. The key is sent as a Bearer token on every request. You can obtain a key from the Developer Keys page.

import { ScienceToStartupClient } from "@sciencetostartup/sdk";

// Recommended: load from environment variable
const client = new ScienceToStartupClient({
  apiKey: process.env.SCIENCETOSTARTUP_API_KEY!,
});

Keep your key secret

Never commit API keys to source control. Store them in environment variables or a secrets manager. Rotate keys immediately if exposed.

Quick Example

The canonical flow: search for papers, seed a workspace, then run a launch-pack action -- all from the same client instance.

Search for papers

Query the paper index to find research relevant to your domain.

const papers = await client.papers.search({
  q: "voice agents LLM",
  limit: 5,
});

const topPaper = papers[0];
console.log(topPaper.title, topPaper.id);

Seed a workspace

Create a workspace from the paper to begin structured analysis.

const workspace = await client.workspaces.createFromSeed({
  paperId: topPaper.id,
  name: "Voice Agent Research",
});

console.log(workspace.id);

Run a launch pack

Execute a launch-pack action to generate commercialization intelligence.

const result = await client.workspaces.runAction({
  workspaceId: workspace.id,
  action: "launch-pack",
});

console.log(result.status);

Verification

Before wiring the SDK into a production workflow, verify that your key is valid and your account is correctly provisioned by calling the whoami endpoint.

const me = await client.whoami();

console.log(me.userId);  // your account ID
console.log(me.tier);    // "sandbox" | "pro" | "agent"

Verify before building

Always confirm your key works with whoami before integrating the SDK into a larger workflow. This avoids debugging auth issues inside complex pipelines.