# Pooyamachine — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 industrial machinery products, categories, and technical specifications from Pooya Machine Alborz, an Iranian equipment manufacturer, while exploring their blog articles and portfolio projects. Access detailed product information, read industry insights, and discover completed manufacturing solutions all in one integration.

**Category:** Business Directories | **Website:** [pooyamachine.com/](https://pooyamachine.com/) | **Docs:** [parse.bot/marketplace/83d044da-3ded-495f-a06d-160489ca8e0e/pooyamachine-com-api](https://parse.bot/marketplace/83d044da-3ded-495f-a06d-160489ca8e0e/pooyamachine-com-api)

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

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/pooyamachine/`
**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 post

Get the full content of a single blog post or article by its numeric ID. Returns complete article text in addition to metadata.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `post_id` | string | Yes | Numeric post ID. Obtain from list_posts endpoint. |

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

### Get product

Get detailed information about a single product by its numeric ID. Returns full content (technical specifications) in addition to the summary fields.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | Yes | Numeric product ID. Obtain from list_products endpoint. |

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

### List posts

List blog posts and technical articles with optional search and category filter. Returns posts sorted by newest first with pagination metadata.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Post category ID to filter by (e.g. 2085 for technical articles, 1777 for general articles). |
| `page` | integer | No | Page number for pagination. |
| `per_page` | integer | No | Number of posts per page (1-100). |
| `search` | string | No | Free-text search query to filter posts by content relevance. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/pooyamachine/list-posts \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","page":"<integer>","per_page":"<integer>","search":"<string>"}'
```

### List product categories

List all product categories including their hierarchy (parent-child relationships) and product counts. Useful for filtering products by category.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `per_page` | integer | No | Maximum categories to return (1-100). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/pooyamachine/list-product-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"per_page":"<integer>"}'
```

### List products

List industrial machinery products with optional category filter and pagination. Returns products sorted by newest first. Each product includes title, excerpt, category IDs, and permalink.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Product category ID to filter by. Obtain IDs from list_product_categories endpoint. |
| `page` | integer | No | Page number for pagination. |
| `per_page` | integer | No | Number of products per page (1-100). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/pooyamachine/list-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","page":"<integer>","per_page":"<integer>"}'
```

### List projects

List portfolio projects (completed industrial machinery installations and production line setups) with pagination.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `per_page` | integer | No | Number of projects per page (1-100). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/pooyamachine/list-projects \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","per_page":"<integer>"}'
```

## Next steps

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