// Developer portal
Use the same Kosovo PC catalog that powers the site through stable JSON, OpenAPI, MCP, Markdown, and CLI interfaces. Start with the free read-only sandbox, then request higher limits when your integration is ready.
> Sandbox
GET /agent-api/v1/search_
The anonymous search endpoint is the production-safe sandbox: it never changes catalog data, builds, or retailer accounts. It returns structured errors and RateLimit headers so an integration can exercise retry behavior before requesting credentials.
// Credentials
The public agent API and sandbox support anonymous read-only calls. For higher limits, request an operator-issued bearer key or an OAuth 2.0 client-credentials pair through the contact page. Credentials are never returned in a URL or page.
Request credentials// Quickstart
Search with a natural-language query, sort by price when needed, and use the returned canonical URL for citations. Prices and stock are snapshots; verify the retailer before purchase.
curl "https://pjespjes.com/agent-api/v1/search?q=ryzen%205%207600%20in%20Kosovo&sort=price_asc"// OAuth 2.0
The authorization server supports the client-credentials grant for the catalog.read scope. Discover the metadata first, then exchange a provisioned client id and secret for a short-lived Bearer token.
OAuth authorization-server metadatacurl -u "$OAUTH_CLIENT_ID:$OAUTH_CLIENT_SECRET" \
-X POST "https://pjespjes.com/oauth/token" \
-H "Content-Type: application/x-www-form-urlencoded" \
--data "grant_type=client_credentials&scope=catalog.read"// Sandbox
The anonymous search endpoint is the production-safe sandbox: it never changes catalog data, builds, or retailer accounts. It returns structured errors and RateLimit headers so an integration can exercise retry behavior before requesting credentials.
Run the sandbox search// Install the CLI
npm install -g @pjespjes/cliThe public API is read-only. It does not place orders, process payments, or guarantee retailer stock.
// Machine-readable resources