# Fastweb — 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.

> Search and browse thousands of scholarships from Fastweb by category, state, or major, while accessing detailed scholarship information, financial aid articles, and student discounts to help fund your education. Find featured opportunities and compare aid options all in one place.

**Category:** Education | **Website:** [fastweb.com/](https://fastweb.com/) | **Docs:** [parse.bot/marketplace/064fe597-9d53-4406-986d-07162f314768/fastweb-com-api](https://parse.bot/marketplace/064fe597-9d53-4406-986d-07162f314768/fastweb-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/fastweb/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get featured scholarships

Returns currently featured and promoted scholarship opportunities from Fastweb's homepage. These are frequently updated sponsored listings. No input parameters required.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/fastweb/get-featured-scholarships \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get financial aid articles

Returns recent financial aid articles from Fastweb covering topics like FAFSA, student loans, financial aid strategies, and loan forgiveness programs. No input parameters required.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/fastweb/get-financial-aid-articles \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get scholarship detail

Returns comprehensive details for a specific scholarship including full description, award amount, deadline, awards available, and provider. The id_slug is the final path segment from a scholarship's detail_url (e.g. '77822-women-s-league-scholarship-uiuc').

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id_slug` | string | Yes | Scholarship ID and slug from a scholarship's detail_url field (e.g. '77822-women-s-league-scholarship-uiuc'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/fastweb/get-scholarship-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"id_slug":"<string>"}'
```

### Get scholarship directory categories

Returns all browseable scholarship categories from the Fastweb directory page. Each category includes a name, slug, and URL. Use the slug with get_scholarships_by_category to retrieve scholarships in that category.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/fastweb/get-scholarship-directory-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get scholarships by category

Returns scholarships for a specific category from the Fastweb directory. Accepts a category slug (obtainable from get_scholarship_directory_categories). Each scholarship includes title, provider, award amount, deadline, and a detail_url for use with get_scholarship_detail.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Category slug from the directory. Obtain from get_scholarship_directory_categories or construct directly (e.g. 'scholarships-for-women', 'scholarships-for-adopted-students'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/fastweb/get-scholarships-by-category \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### Get scholarships by major

Returns scholarships for a specific academic major or field of study. Constructs the directory slug from the major name (e.g. 'Engineering' becomes 'scholarships-for-engineering-majors'). Each scholarship includes title, provider, award amount, deadline, and detail_url.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `major` | string | Yes | Major or field of study name (e.g. 'Engineering', 'Computer Science', 'Nursing'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/fastweb/get-scholarships-by-major \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"major":"<string>"}'
```

### Get scholarships by state

Returns scholarships specific to a U.S. state. Constructs the directory slug from the state name (e.g. 'California' becomes 'california-scholarships'). Each scholarship includes title, provider, award amount, deadline, and detail_url.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `state` | string | Yes | U.S. state name (e.g. 'California', 'New York', 'Texas'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/fastweb/get-scholarships-by-state \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"state":"<string>"}'
```

### Get student discounts

Returns available student discounts and deals from various merchants partnered with Fastweb. Each discount includes the merchant name and the offer description. No input parameters required.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/fastweb/get-student-discounts \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.