# Pooyamachine — 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 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-pooyamachine-com-api-83d044da/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-pooyamachine-com-api-83d044da/get_post \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-pooyamachine-com-api-83d044da/get_product \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-pooyamachine-com-api-83d044da/list_posts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-pooyamachine-com-api-83d044da/list_product_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-pooyamachine-com-api-83d044da/list_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-pooyamachine-com-api-83d044da/list_projects \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","per_page":"<integer>"}'
```