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

> Browse and compare credit cards from multiple banks, filtering by category or specific issuers to find cards matching your rewards preferences and eligibility. Get detailed information on fees, rewards programs, and requirements to make informed decisions about which card suits your financial needs.

**Category:** Finance & Markets | **Website:** [paisabazaar.com/](https://paisabazaar.com/) | **Docs:** [parse.bot/marketplace/882151e4-0214-4017-b9e5-aa9540148b97/paisabazaar-com-api](https://parse.bot/marketplace/882151e4-0214-4017-b9e5-aa9540148b97/paisabazaar-com-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-paisabazaar-com-api-882151e4/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_credit_card_details

Get full details of a specific credit card including fees and charges, features, eligibility criteria, and FAQs. The bank_slug and card_slug are extracted from card links returned by listing endpoints (e.g. link '/hdfc-bank/hdfc-regalia-gold-credit-card/' yields bank_slug='hdfc-bank' and card_slug='hdfc-regalia-gold-credit-card').

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `bank_slug` | string | Yes | Slug of the bank (first path segment in card links from listing endpoints). |
| `card_slug` | string | Yes | Slug of the card (last path segment in card links from listing endpoints). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-paisabazaar-com-api-882151e4/get_credit_card_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bank_slug":"<string>","card_slug":"<string>"}'
```

### list_banks

List all supported bank slugs that can be used with list_credit_cards_by_bank and get_credit_card_details endpoints.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-paisabazaar-com-api-882151e4/list_banks \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_categories

List all supported category slugs that can be used with list_credit_cards_by_category endpoint.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-paisabazaar-com-api-882151e4/list_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_credit_cards

List the top 10 credit cards from the Paisabazaar top-10 page. Returns cards with fees, highlights, and category tags. Single-page response with no pagination.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-paisabazaar-com-api-882151e4/list_credit_cards \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_credit_cards_by_bank

List credit cards offered by a specific bank. Returns all cards listed on the bank's credit card page with fees, highlights, and categories.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `bank_slug` | string | Yes | Slug of the bank as returned by list_banks endpoint. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-paisabazaar-com-api-882151e4/list_credit_cards_by_bank \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bank_slug":"<string>"}'
```

### list_credit_cards_by_category

List credit cards in a specific category. Returns all cards on the category page with fees, highlights, and tags.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_slug` | string | Yes | Slug of the category as returned by list_categories endpoint. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-paisabazaar-com-api-882151e4/list_credit_cards_by_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_slug":"<string>"}'
```

### search_credit_cards

Search for credit cards by keyword. Matches against card names, categories, highlights, and bank names from the main credit card listing and top-10 pages. Each search term is matched independently (OR logic). Returns cards from the main listing page that match any query term.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword or phrase. Multi-word queries match if any word appears in card name, categories, highlights, or bank name. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-paisabazaar-com-api-882151e4/search_credit_cards \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```