# Hardverapro — 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 tech products on Hungary's largest hardware marketplace, with specialized tools for finding GPUs and viewing detailed product information and seller profiles. Get access to listings across multiple categories, filter by specific hardware types, and discover seller details to make informed purchasing decisions.

**Category:** Marketplaces | **Website:** [hardverapro.hu/](https://hardverapro.hu/) | **Docs:** [parse.bot/marketplace/8f5c9d03-6f60-46f4-954b-3b91d99eca69/hardverapro-hu-api](https://parse.bot/marketplace/8f5c9d03-6f60-46f4-954b-3b91d99eca69/hardverapro-hu-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-hardverapro-hu-api-8f5c9d03/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_listing_detail

Fetch full details of a single listing by its URL. Returns structured product data including title, price (integer HUF when parseable), description, seller info, ratings, images, category path, and metadata fields. The URL can be a full hardverapro.hu URL or a slug (e.g. 'rjnu_2').

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full listing URL (e.g. https://hardverapro.hu/apro/rjnu_2/friss.html) or listing slug (e.g. rjnu_2) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hardverapro-hu-api-8f5c9d03/get_listing_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### get_user_listings

Get all active listings posted by a specific user. Returns the same listing shape as search_listings. Automatically paginates through results up to the specified limit.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of listings to return |
| `offset` | integer | No | Pagination offset (number of listings to skip) |
| `username` | string | Yes | Username of the seller whose listings to retrieve |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hardverapro-hu-api-8f5c9d03/get_user_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","offset":"<integer>","username":"<string>"}'
```

### get_user_profile

Fetch public profile information for a user by username. Returns registration date, number of active listings, rating summary, rank, last login time, and comment counts.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `username` | string | Yes | Username to look up (case-sensitive as displayed on the site) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hardverapro-hu-api-8f5c9d03/get_user_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"<string>"}'
```

### list_category_listings

List all listings within a specific category and optional subcategory. Equivalent to browsing a category page on the site. Returns the same listing shape as search_listings. Paginates via integer offset.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | Category slug: hardver, notebook, pc_szerver, mobil, szoftver_jatek, hazimozi_hifi, foto_video, egyeb |
| `limit` | integer | No | Maximum number of listings to return |
| `offset` | integer | No | Pagination offset (number of listings to skip) |
| `subcategory` | string | No | Subcategory slug within the chosen category (e.g. videokartya, processzor, memoria, alaplap, ssd_hdd, monitor) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hardverapro-hu-api-8f5c9d03/list_category_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","limit":"<integer>","offset":"<integer>","subcategory":"<string>"}'
```

### list_gpu_listings

List GPU (videókártya) listings from the hardver/videokartya category. A convenience shortcut equivalent to list_category_listings with category=hardver and subcategory=videokartya. Automatically paginates through results up to the specified limit.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of listings to return |
| `offset` | integer | No | Pagination offset (number of listings to skip) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hardverapro-hu-api-8f5c9d03/list_gpu_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","offset":"<integer>"}'
```

### search_listings

Full-text search over HardverApró marketplace listings. Matches title text via the `query` parameter. Optionally scope to a category/subcategory and filter by price range. Returns up to `limit` listings starting at `offset`. Each listing carries title, URL, price, seller username, location, posting time, and detail tags. Paginates via integer offset (increments of up to `limit`).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category slug: hardver, notebook, pc_szerver, mobil, szoftver_jatek, hazimozi_hifi, foto_video, egyeb |
| `limit` | integer | No | Maximum number of listings to return |
| `max_price` | integer | No | Maximum price filter in HUF |
| `min_price` | integer | No | Minimum price filter in HUF |
| `offset` | integer | No | Pagination offset (number of listings to skip) |
| `query` | string | No | Search keyword to match against listing titles |
| `subcategory` | string | No | Subcategory slug within the chosen category (e.g. videokartya, processzor, memoria, alaplap, ssd_hdd, monitor) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hardverapro-hu-api-8f5c9d03/search_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","limit":"<integer>","max_price":"<integer>","min_price":"<integer>","offset":"<integer>","query":"<string>","subcategory":"<string>"}'
```