Enterprise API v1

S2S API Documentation

Programmatic access to research paper insights, viability scores, and trend analysis for your internal tools and workflows.

Authentication

All API requests require an API key in the Authorization header:

Authorization: Bearer s2s_YOUR_API_KEY

Get your API key from the Enterprise Dashboard → API Keys

Rate Limits

Daily Limit

Default: 1,000 requests/day. Check /api/v1/me for your remaining quota.

Response Headers

X-RateLimit-Remaining: Requests left today
X-RateLimit-Reset: Reset timestamp (UTC)

Quick Start

import requests

API_KEY = "s2s_YOUR_API_KEY"
BASE_URL = "https://sciencetostartup.com/api/v1"

response = requests.get(
    f"{BASE_URL}/top-papers",
    params={"topic": "battery-technology", "limit": 10, "min_score": 70},
    headers={"Authorization": f"Bearer {API_KEY}"}
)

papers = response.json()["data"]
for paper in papers:
    print(f"{paper['title']} - Score: {paper['viability_score']}")

Endpoints

GET/api/v1/top-papersrequires: read

Fetch top papers sorted by viability score

Parameters:

topic(string)Filter by topic/cluster (e.g., "quantum-computing")

since(date)Papers published after this date (YYYY-MM-DD)

limit(number)Max results (1-100, default: 50)

offset(number)Pagination offset

min_score(number)Minimum viability score (0-100)

sort_by(string)"score" or "date" (default: score)

GET/api/v1/papersrequires: read

General paper search with extended filters

Parameters:

q(string)Full-text search in title/abstract

topic(string)Filter by topic/cluster

since(date)Published after (YYYY-MM-DD)

until(date)Published before (YYYY-MM-DD)

min_score(number)Min viability score

max_score(number)Max viability score

include_analysis(boolean)Include full deep_dive_analysis

limit(number)Max results (1-100)

offset(number)Pagination offset

GET/api/v1/topicsrequires: read

List all topics/clusters with paper counts

GET/api/v1/paper/{arxivId}requires: read

Get single paper with full analysis

Parameters:

arxivId(path)ArXiv paper ID (e.g., "2501.00001")

GET/api/v1/exportrequires: export

Bulk export papers as CSV or JSON

Parameters:

format(string)"csv" or "json" (default: json)

topic(string)Filter by topic

since(date)Published after

limit(number)Max results (up to 5000)

GET/api/v1/merequires: read

Check your API key info and remaining quota

Error Codes

Code	Meaning
400	Bad Request - Invalid parameters
401	Unauthorized - Missing or invalid API key
403	Forbidden - Missing required permission scope
404	Not Found - Resource doesn't exist
429	Rate Limit Exceeded - Daily quota exhausted
500	Internal Error - Please retry or contact support