# Arukereso — 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 compare motherboards, batteries, and UPS systems on Arukereso.hu with real-time pricing, technical specifications, and customer reviews. Get detailed product information to make informed purchasing decisions across multiple categories.

**Category:** E-commerce | **Website:** [arukereso.hu/](https://arukereso.hu/) | **Docs:** [parse.bot/marketplace/694d4f2f-ba44-4e28-90b0-3d2a26d41386/arukereso-hu-api](https://parse.bot/marketplace/694d4f2f-ba44-4e28-90b0-3d2a26d41386/arukereso-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-arukereso-hu-api-694d4f2f/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_lead_acid_batteries

Get a paginated list of lead acid batteries from the motor battery category. Returns products with extracted voltage, capacity, and calculated price_value_ratio ((V * Ah) / price). Returns 25 products per page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number, starting from 1. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-arukereso-hu-api-694d4f2f/get_lead_acid_batteries \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### get_motherboards

Get a paginated list of motherboards from the motherboard category on arukereso.hu. Returns 25 products per page with name, price, offer count, and specs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number, starting from 1. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-arukereso-hu-api-694d4f2f/get_motherboards \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### get_product_details

Get full details for a product on arukereso.hu including specifications and shop offers with pricing. Requires the full product URL. Returns all available shop offers sorted by price with shipping and availability info.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full product URL on arukereso.hu (from search or category listing results). |

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

### get_product_reviews

Get user reviews for a specific product on arukereso.hu. Requires the full product URL containing a product ID (e.g. -p572974758/). Returns all available reviews with reviewer name, date, rating, and review text.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full product URL on arukereso.hu containing a product ID (from search or category listing results). |

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

### get_ups_batteries

Get a paginated list of UPS (szünetmentes tápegység) batteries. Returns products with extracted voltage, capacity, and calculated price_value_ratio ((V * Ah) / price). Returns 25 products per page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number, starting from 1. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-arukereso-hu-api-694d4f2f/get_ups_batteries \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### search_products

Search for products across arukereso.hu by keyword. Works best with product names and brand names. Returns first page of matching products with name, price, offer count, and key specifications.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword. Works best with product names or brand names. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-arukereso-hu-api-694d4f2f/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```