Everything you need to know about PriceFetch. Can't find your answer? Contact us.
Getting Started
What is PriceFetch?
PriceFetch is a REST API that returns real-time product prices from major retailers. Send a product URL, get back clean JSON with the current price, currency, stock status, and timestamp. One endpoint, one purpose — the simpler, faster, cheaper alternative to Rainforest API and PriceAPI.
How do I get started?
Sign up for a free account — no credit card required. You get an API key and 500 free credits immediately. Paste a product URL into the playground to test it, or make your first API call with cURL or any language. See our documentation for full setup instructions.
What retailers are supported?
Currently: Amazon (16 country domains), Walmart (US), iHerb (global), and Newegg (US & CA). Target, eBay, and Best Buy are coming soon. Check our retailers page for the latest list.
Which Amazon domains are supported?
We support 16 Amazon country domains including amazon.com, amazon.co.uk, amazon.ca, amazon.com.au, amazon.de, amazon.fr, amazon.co.jp, amazon.it, amazon.es, amazon.in, and more. Every domain is scraped with country-specific selectors for maximum accuracy.
Do I need to install anything?
No. PriceFetch is a REST API. Make HTTP requests from any language or tool — Python, JavaScript, cURL, Go, Ruby, PHP, whatever you prefer. No SDK required, no dependencies to manage.
Pricing & Billing
How does credit-based pricing work?
1 credit = 1 successful price fetch. You start with 500 free credits. When you need more, buy a credit pack (one-time) or subscribe to a monthly plan. Visit our pricing page for full details.
Do credits expire?
Credit pack credits never expire — buy them and use them whenever you want. Monthly subscription credits reset each billing cycle and unused credits from the previous month do not roll over.
What happens when I run out of credits?
API requests return a 402 Payment Required status code with a clear error message. Your integrations won't break — they get a predictable error response. Buy more credits or enable auto top-up in your dashboard to avoid interruptions.
Do failed requests cost credits?
No. If a request fails because of a PriceFetch error (server issue, scraper failure, timeout) or invalid input (bad URL, unsupported retailer), you are not charged. You only pay for successful price fetches that return valid data.
Is there a free tier?
Yes. Every new account gets 500 free credits. No credit card required. No time limit — use them whenever you want.
What is your refund policy?
Credit packs are refundable within 7 days if unused. Monthly plans can be cancelled anytime, effective at the end of your current billing period. No partial month refunds. Contact support for refund requests.
API & Technical
How do I authenticate?
Include your API key in the X-API-Key header on every request. Example: curl -H "X-API-Key: pf_live_abc123" "https://api.pricefetch.dev/v1/price?url=...". Your API key is available in your dashboard under API Keys.
What does the API response look like?
A successful response returns JSON like: { "success": true, "data": { "url": "...", "retailer": "amazon", "price": 29.99, "currency": "USD", "in_stock": true, "timestamp": "2026-03-22T12:00:00Z" }, "credits_remaining": 487 }. See the documentation for the full schema.
How fast is the API?
Average response time is 2–4 seconds. We scrape pages in real-time (no cached database), so speed depends on the retailer’s page load time. P95 is typically under 5 seconds.
What are the rate limits?
5 requests per second per API key and 10,000 requests per month. These limits apply across all plans. Rate limit headers (X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset) are included in every response.
What error codes does the API return?
200 success, 400 bad request (invalid URL), 401 unauthorized (bad or missing API key), 402 payment required (out of credits), 422 unsupported retailer or scrape failed, 429 rate limited, 500 server error. Full details in our documentation.
Can I make concurrent requests?
Yes, within your rate limits. You can run multiple requests in parallel up to 5 per second per API key. This is useful for bulk price checks across many products.
Data & Accuracy
How accurate are the prices?
We fetch the live page and extract the current displayed price. Accuracy is 99%+ for supported retailers. We return the default public price visible to a non-logged-in user, so membership prices (Prime, Walmart+) may differ.
Do you return historical prices?
Not currently. PriceFetch returns the current price at the moment of the request. Price history tracking is on the roadmap.
What currency are prices returned in?
The currency of the retailer’s page. Amazon.com returns USD, Amazon.co.uk returns GBP, Amazon.de returns EUR, and so on. The currency field in the response tells you exactly which currency it is.
Account & Security
How is my API key stored?
API keys are encrypted at rest using AES-256-GCM and authenticated via SHA-256 hashes. You can view your full key anytime from the dashboard. If you suspect your key has been compromised, regenerate it immediately.
How do I delete my account?
Go to Dashboard > Settings > Delete Account. This permanently deletes your account, API key, and all associated data. This action is irreversible.
Is my usage data shared with anyone?
No. We do not sell, share, or provide your usage data, request logs, or account information to third parties. We use Umami for privacy-friendly website analytics with no cross-site tracking.
Still have questions? Get in touch and we'll get back to you within 24 hours.