# TopStartups — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access startup profiles, funding data, job listings, and salary benchmarks from TopStartups.io. Filter by industry, location, funding stage, company size, and more to explore the startup landscape at scale.

**Category:** Business Directories | **Website:** [topstartups.io/](https://topstartups.io/) | **Docs:** [parse.bot/marketplace/41e581e0-3aa6-4896-87dc-f760b86ce317/topstartups-io-api](https://parse.bot/marketplace/41e581e0-3aa6-4896-87dc-f760b86ce317/topstartups-io-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-topstartups-io-api-41e581e0/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_jobs

Retrieve a paginated list of startup jobs with optional filters for role, location, experience, startup name, market, and company size. Returns up to ~20 jobs per page with company details embedded in each job record.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `job_location` | string | No | Filter by job location (e.g. 'Remote'). |
| `page` | integer | No | Page number for pagination. |
| `role` | string | No | Filter by job role/title keyword. |
| `startup__company_size` | string | No | Filter by startup size (e.g. '101-200 employees'). |
| `startup__markets` | string | No | Filter by startup industry/market (e.g. 'Artificial Intelligence'). |
| `startup__name` | string | No | Filter by startup name. |
| `yoe` | string | No | Filter by years of experience (e.g. '5+ years'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-topstartups-io-api-41e581e0/get_jobs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"job_location":"<string>","page":"<integer>","role":"<string>","startup__company_size":"<string>","startup__markets":"<string>","startup__name":"<string>","yoe":"<string>"}'
```

### get_salary_data

Retrieve salary and equity data for startup roles from the TopStartups salary database. Returns all matching records (up to ~2500). Filters are applied server-side via query parameters. Each record includes title, salary, equity_percent, equity_dollars, location, total_yoe, years_at_startup, stage, size, valuation, and date.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `company_size` | string | No | Filter by company size. |
| `stage` | string | No | Filter by startup stage (e.g. 'Series A'). |
| `team` | string | No | Filter by team (e.g. 'Engineering', 'Product'). |
| `title` | string | No | Filter by job title keyword. |
| `work_location` | string | No | Filter by work location. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-topstartups-io-api-41e581e0/get_salary_data \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company_size":"<string>","stage":"<string>","team":"<string>","title":"<string>","work_location":"<string>"}'
```

### get_startup_details

Get full details for a specific startup by name. Searches the jobs page for the startup and falls back to the main startups listing. Returns input_not_found if the startup cannot be located.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `name` | string | Yes | Name of the startup to look up. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-topstartups-io-api-41e581e0/get_startup_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"<string>"}'
```

### get_startups

Retrieve a paginated list of startups with optional filters for industry, location, size, founding year, funding stage, and investors. Returns up to ~20 startups per page. Pagination via page number; has_more indicates additional pages exist.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `company_size` | string | No | Filter by company size (e.g. '11-50 employees'). |
| `founded_year` | string | No | Filter by founded year (e.g. '2020'). |
| `funding_round` | string | No | Filter by funding stage (e.g. 'Series A'). |
| `hq_location` | string | No | Filter by HQ location (e.g. 'New York'). |
| `industries` | string | No | Filter by industry (e.g. 'SaaS', 'Artificial Intelligence'). |
| `investors` | string | No | Filter by investor name (e.g. 'Sequoia'). |
| `page` | integer | No | Page number for pagination. |
| `sort` | string | No | Sort order. Accepted values: 'funding', 'valuation'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-topstartups-io-api-41e581e0/get_startups \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company_size":"<string>","founded_year":"<string>","funding_round":"<string>","hq_location":"<string>","industries":"<string>","investors":"<string>","page":"<integer>","sort":"<string>"}'
```