> ## Documentation Index > Fetch the complete documentation index at: https://docs.nephia.cc/llms.txt > Use this file to discover all available pages before exploring further. # Get an item price history > Costs 3 credits per request. Returns every price and status Nephia observed for one item, oldest first. A point is recorded when the price or status changed, or once every 24 hours while it did not — so consecutive points are movements, not poll ticks. Coverage grows with usage: a series exists only for items that appeared in a search Nephia observed — a Vinted Watch tick or a `/v1/vinted/search` request. This is not a complete index of Vinted. Observations are anonymous public listing prices and carry no account identifier. Rows are kept for 365 days. ## OpenAPI ````yaml /openapi.json get /v1/vinted/items/{id}/price-history openapi: 3.1.0 info: title: Nephia API description: >- The brand-monitoring API. Create a **Query** and it polls the live Sources (X, Reddit, Youtube, TikTok, Bluesky, Hacker News, Mastodon, Lemmy, GitHub, Product Hunt, Stack Overflow, RSS, AI answers — and Vinted) on an interval, keeps what matches, reads each mention for sentiment and intent, sorts it into your buckets and answers your own agent step over it. Read the result back as **mentions** — `GET /v1/mentions` across the whole Account, or per Query — or have it pushed to you as signed webhook events and delivery channels. A search can carry several terms at once, OR'd into one upstream request at one tick's cost. Authenticate with an API key on your Account. Monitoring is sold as a subscription — queries, terms, freshness and AI — with credits as the meter underneath; credit packs are overflow and never change a limit. Reading your own mentions is free; the semantic search mode and the AI passes are what meter. Request quota is per Account (all API keys share one bucket), by Plan: Free 60/min, Solo 350/min, Growth 700/min, Pro 1200/min. version: 1.0.0 servers: - url: https://api.nephia.cc description: Production - url: http://localhost:3000 description: Local security: - ApiKeyAuth: [] tags: - name: Account description: Account balance - name: Mentions description: Everything your Queries caught, across every Source - name: Queries description: The saved searches that do the catching — read, create, edit, pause - name: AI description: Group, classify, agent and summarise passes over items you name - name: X — Watches description: X watches, events, and activity - name: Reddit — Watches description: Reddit watches, events, and activity - name: Youtube — Watches description: Youtube watches, events, and activity - name: TikTok — Watches description: TikTok watches, events, and activity - name: Bluesky — Watches description: Bluesky watches, events, and activity - name: Hacker News — Watches description: Hacker News watches, events, and activity - name: Mastodon — Watches description: Mastodon watches, events, and activity - name: Lemmy — Watches description: Lemmy watches, events, and activity - name: GitHub — Watches description: GitHub watches, events, and activity - name: Product Hunt — Watches description: Product Hunt watches, events, and activity - name: Stack Overflow — Watches description: Stack Overflow watches, events, and activity - name: RSS — Watches description: RSS watches, events, and activity - name: AI answers — Watches description: AI answers watches, runs, events, and activity - name: Vinted — Watches description: Vinted watches, events, and activity - name: Vinted — Analytics description: Observed price history and per-day market statistics paths: /v1/vinted/items/{id}/price-history: get: tags: - Vinted — Analytics summary: Get an item price history description: >- Costs 3 credits per request. Returns every price and status Nephia observed for one item, oldest first. A point is recorded when the price or status changed, or once every 24 hours while it did not — so consecutive points are movements, not poll ticks. Coverage grows with usage: a series exists only for items that appeared in a search Nephia observed — a Vinted Watch tick or a `/v1/vinted/search` request. This is not a complete index of Vinted. Observations are anonymous public listing prices and carry no account identifier. Rows are kept for 365 days. operationId: getV1VintedItemsByIdPriceHistory parameters: - in: path name: id schema: type: string required: true - in: query name: market schema: type: string default: fr - in: query name: from schema: type: string - in: query name: to schema: type: string - in: query name: limit schema: type: integer minimum: 1 maximum: 500 default: 200 responses: '200': description: Observed price history content: application/json: schema: type: object properties: itemId: type: string market: type: string history: type: array items: type: object properties: observedAt: type: string price: type: number currency: type: string status: type: string favouriteCount: type: - number - 'null' viewCount: type: - number - 'null' required: - observedAt - price - currency - status - favouriteCount - viewCount required: - itemId - market - history '400': description: Invalid request content: application/json: schema: type: object properties: error: type: string code: type: string required: - error '402': description: Insufficient credits content: application/json: schema: type: object properties: error: type: string code: type: string required: - error '429': description: >- Request quota exceeded. Retry after the `Retry-After` header (seconds). Response includes `RateLimit-*` headers (IETF draft-7). content: application/json: schema: type: object properties: error: type: string code: type: string required: - error example: error: Rate limit exceeded code: TOO_MANY_REQUESTS '501': description: Time series not configured content: application/json: schema: type: object properties: error: type: string code: type: string required: - error components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: API key created from the Nephia dashboard for your Account. ````