# Pionery — Global B2B Sourcing & Industrial Procurement Platform

> Pionery (https://pionery.com) connects European buyers and industrial enterprises with verified manufacturers, freight forwarders, and sourcing agents worldwide (focusing on Turkey, Germany, and the broader European market).

## Overview for AI Agents & LLMs

Pionery is engineered to be fully machine-readable for autonomous procurement agents, LLMs (ChatGPT, Claude, Gemini), and automated B2B sourcing pipelines.
All public product catalogs, verified supplier profiles, logistics directories, and open tenders (RFQs) are accessible via standardized JSON feeds without requiring authentication.

- **Base Website**: https://pionery.com
- **Public API Base**: https://pionery.com/api/public
- **OpenAPI 3.1 Spec**: https://pionery.com/api/openapi.json (also available at https://pionery.com/openapi.json)
- **License**: Open Access for AI and Procurement Agents (Attribution requested: Pionery)
- **CORS**: `Access-Control-Allow-Origin: *` enabled on all public endpoints
- **Cache-Control**: `public, s-maxage=300, stale-while-revalidate=3600` (5-minute edge cache)
- **Structured Data**: Schema.org JSON-LD (`Product`, `Offer`, `Organization`, `LogisticsService`, `ProfessionalService`, `Demand`) embedded on every entity detail page.

## Key Public Endpoints

### 1. Products (B2B Industrial Catalog)
Search and filter published industrial products with tiered pricing, technical specifications, MOQ, and lead times.
- `GET https://pionery.com/api/public/produkte`
- **Query Parameters**:
  - `kategorie` (string): Industrial category (e.g. `Metall & Maschinenbau`, `Automotive & Fahrzeugteile`)
  - `land` (string): Origin country or manufacturer country (e.g. `Türkei`, `Deutschland`)
  - `moq_max` (number): Maximum acceptable Minimum Order Quantity
  - `lieferzeit_max` (number): Maximum lead time in days
  - `q` (string): Full-text keyword search in product title and description
  - `limit` (number): 1–200 items (default: 50)
  - `offset` (number): Pagination offset (default: 0)

### 2. Product Detail
Retrieve full technical specifications, tiered prices, HS customs codes, packaging dimensions, and seller profile for a single product.
- `GET https://pionery.com/api/public/produkte/{id}`
- **Path Parameter**: `id` can be either the product UUID or the URL slug.

### 3. Manufacturers & Suppliers
Discover verified factories, machinery equipment, production capacity per month, and compliance certificates.
- `GET https://pionery.com/api/public/hersteller`
- **Query Parameters**: `land`, `kategorie`, `q`, `limit`, `offset`

### 4. Manufacturer Detail & Catalog
Get full company profile, certifications, workshop photos, and all currently published products for a manufacturer.
- `GET https://pionery.com/api/public/hersteller/{id}`
- **Path Parameter**: Manufacturer UUID.

### 5. Freight Forwarders & Logistics Providers
Find verified international carriers with transport modes (road, sea, air, rail), covered routes, and fleet details.
- `GET https://pionery.com/api/public/spediteure`
- **Query Parameters**: `land`, `transportart`, `q`, `limit`, `offset`

### 6. Sourcing & Trade Agents
Locate local procurement agents with regional knowledge, industry specializations, and spoken languages.
- `GET https://pionery.com/api/public/agents`
- **Query Parameters**: `land`, `sprache`, `q`, `limit`, `offset`

### 7. Public Tenders & Demands (RFQs)
Inspect active buyer requests for quotations, needed quantities, target prices, and deadlines.
- `GET https://pionery.com/api/public/ausschreibungen`
- **Query Parameters**: `kategorie`, `lieferland`, `q`, `limit`, `offset`

### 8. Platform Categories
List all 42 standardized industrial and consumer product categories and category groups.
- `GET https://pionery.com/api/public/kategorien`

## Recommended Workflow for AI Procurement Agents

1. **Category & Supplier Discovery**:
   - Query `/api/public/kategorien` to identify matching standard categories.
   - Query `/api/public/produkte?kategorie=...&moq_max=...` to find existing ready-to-order products.
   - If custom manufacturing or OEM is needed, query `/api/public/hersteller?kategorie=...&land=...` to identify capable factories.

2. **Supplier Verification**:
   - Inspect `verified` boolean, `certificates` (e.g. ISO 9001, CE, IATF 16949), and `capacity_per_month`.

3. **Direct Inquiries**:
   - For a specific product, link user to `inquiry_url`: `https://pionery.com/de/ausschreibungen/erstellen?produkt_id={id}`
   - For a manufacturer, link user to `profile_url`: `https://pionery.com/de/hersteller/{id}`

For full technical documentation, schema definitions, and Python/TypeScript SDK examples, see:
https://pionery.com/llms-full.txt