# Pricefy API > Welcome developers, partners, and innovators! We are thrilled to introduce you to the Pricefy API — the backbone of our industry-leading Software as a Service (SaaS) solution. Whether you're looking to integrate Pricefy with your existing platforms, extract insightful data, or simply customize Pricefy to better fit your organization's needs, this documentation is your comprehensive guide. Base URL: `https://api.pricefy.io`. Authentication: - REST endpoints: send the `X-Api-Key` header on every request. - MCP endpoint (`POST /mcp`): accepts either `X-Api-Key` (Claude Desktop, Cursor, Codex, …) or OAuth Bearer (ChatGPT custom connectors). See `/docs` for the connection guide. ## OpenAPI - [OpenAPI specification (YAML)](https://api.pricefy.io/openapi.yaml) - [Interactive API reference](https://api.pricefy.io/docs) - [Full content as plain text](https://api.pricefy.io/llms-full.txt) ## Welcome Health check. - [Health check](https://api.pricefy.io/docs?tag=Welcome&op=welcome): `GET /v1` ## Account Merchant account, subscription and plan limits. - [Get account](https://api.pricefy.io/docs?tag=Account&op=getMerchantAccount): `GET /v1/merchant/account` ## Store Store information and last import. - [Get store](https://api.pricefy.io/docs?tag=Store&op=getMerchantStore): `GET /v1/merchant/store` ## Products Merchant product catalog. Cursor-based pagination. - [List products](https://api.pricefy.io/docs?tag=Products&op=listProducts): `GET /v1/merchant/products` - [Upsert products (bulk)](https://api.pricefy.io/docs?tag=Products&op=bulkUpsertProducts): `PUT /v1/merchant/products` - [Get product](https://api.pricefy.io/docs?tag=Products&op=getProduct): `GET /v1/merchant/products/{sku}` - [Upsert product](https://api.pricefy.io/docs?tag=Products&op=upsertProduct): `PUT /v1/merchant/products/{sku}` - [Delete product](https://api.pricefy.io/docs?tag=Products&op=deleteProduct): `DELETE /v1/merchant/products/{sku}` ## Competitors Competitor domains with price analysis. - [List competitors](https://api.pricefy.io/docs?tag=Competitors&op=listCompetitors): `GET /v1/competitors` - [Add competitor](https://api.pricefy.io/docs?tag=Competitors&op=addCompetitor): `POST /v1/competitors` - [Update competitor status](https://api.pricefy.io/docs?tag=Competitors&op=updateCompetitorStatus): `PUT /v1/competitors` - [Get competitor](https://api.pricefy.io/docs?tag=Competitors&op=getCompetitor): `GET /v1/competitors/{domain}` ## Monitored URLs URLs being monitored on each competitor, with stock and price diff. - [List monitored URLs](https://api.pricefy.io/docs?tag=Monitored%20URLs&op=listMonitoredUrls): `GET /v1/competitors/urls` - [Upsert monitored URLs](https://api.pricefy.io/docs?tag=Monitored%20URLs&op=upsertMonitoredUrls): `PUT /v1/competitors/urls` - [Delete monitored URLs](https://api.pricefy.io/docs?tag=Monitored%20URLs&op=deleteMonitoredUrls): `DELETE /v1/competitors/urls` - [Monitored URL price-history detail](https://api.pricefy.io/docs?tag=Monitored%20URLs&op=getMonitoredUrlDetail): `GET /v1/competitors/urls/detail` ## MAP Infringements Minimum Advertised Price rules and the resellers that breach them. - [List MAP infringements](https://api.pricefy.io/docs?tag=MAP%20Infringements&op=listMapInfringements): `GET /v1/map-infringements` - [List MAP infringement rules](https://api.pricefy.io/docs?tag=MAP%20Infringements&op=listMapInfringementRules): `GET /v1/map-infringement-rules` ## Repricing Dynamic pricing rules and repricing previews. - [List repricing rules](https://api.pricefy.io/docs?tag=Repricing&op=listRepricingRules): `GET /v1/dynamic-pricing/list` - [Repricing preview](https://api.pricefy.io/docs?tag=Repricing&op=getRepricingPreview): `GET /v1/dynamic-pricing/preview` - [Apply suggested prices](https://api.pricefy.io/docs?tag=Repricing&op=applyRepricing): `POST /v1/dynamic-pricing/apply/{rule_id}` ## Reports Scheduled reports configuration. - [List reports](https://api.pricefy.io/docs?tag=Reports&op=listReports): `GET /v1/reports` - [Get report](https://api.pricefy.io/docs?tag=Reports&op=getReport): `GET /v1/reports/{id}` ## Alerts Alert rules and triggered alerts (price/stock variations). - [List alert rules](https://api.pricefy.io/docs?tag=Alerts&op=listAlertRules): `GET /v1/alert-rules` - [Get alert rule](https://api.pricefy.io/docs?tag=Alerts&op=getAlertRule): `GET /v1/alert-rules/{id}` - [Get alert rule alerts](https://api.pricefy.io/docs?tag=Alerts&op=getAlertRuleAlerts): `GET /v1/alert-rules/{id}/alerts` - [List alert variations](https://api.pricefy.io/docs?tag=Alerts&op=listAlerts): `GET /v1/alerts` ## Postman Postman The **complete Pricefy API collection** lives in the [public Pricefy Postman workspace](https://www.postman.com/pricefy/workspace/pricefy-api) — every endpoint, request body, query parameter and response example, pre-wired and ready to send. Use it to explore the API in Postman desktop / web, fork it into your own workspace, or run it as part of an automated test suite via Newman. [![Run in Postman](https://run.pstmn.io/button.svg)](https://www.postman.com/pricefy/workspace/pricefy-api) Alternatives: - [Browse the workspace](https://www.postman.com/pricefy/workspace/pricefy-api) directly on postman.com - [Download the collection JSON](/postman/collection.json) and import manually into Postman or Newman - [Download the Postman collection](https://api.pricefy.io/docs?tag=Postman&op=downloadPostmanCollection): `GET /postman/collection.json` ## MCP **Model Context Protocol** — same Pricefy API, exposed as MCP tools so Claude Desktop, Cursor, ChatGPT, Codex and the Claude CLI can call it natively. Streamable HTTP transport, JSON-RPC 2.0, dual auth (`X-Api-Key` **or** OAuth 2.1 Bearer), same per-merchant permissions as REST. 25 tools (18 read-only + 5 write + 2 destructive). See `POST /mcp` for the full catalog and the landing page for connection guides. - [MCP server (Streamable HTTP JSON-RPC)](https://api.pricefy.io/docs?tag=MCP&op=mcpServer): `POST /mcp`