Documentation guides
DeepFetch documentation
Everything you need to scrape websites, build live data endpoints, and integrate DeepFetch into your apps — no server setup required.
Overview
DeepFetch is a web scraping platform with two ways to get data:
- Dashboard — point-and-click scraping. Pick a site template, enter a search query, and get structured results you can export or publish as a live URL.
- API — programmatic access for developers. Fetch any web page, extract structured data, take screenshots, or run AI-powered extraction from your own code.
Both methods share the same credit balance. You can see your remaining credits in the sidebar and on the API page.
Quick start
- Go to New Scrape, choose a site (e.g. Amazon UK or Bing Search), and enter what you want to find — like wireless headphones under £50.
- Run the scrape. When it finishes, open the job to view results as a table, JSON, or CSV.
- Copy a Live API Endpoint URL from the job page to use the data in spreadsheets, apps, or automations — without writing scraper code.
Credits & billing
DeepFetch uses credits instead of per-request cash billing. Each action consumes a number of credits based on complexity. Failed dashboard scrapes and blocked API requests are refunded — you only pay for successful, non-empty results.
Dashboard scrapes
Charged when you run a job from New Scrape or refresh an endpoint
Credits are reserved up-front for the maximum results you request. If fewer rows come back, or the job fails, unused credits are returned automatically.
Developer API
Charged per API call — see the API page for keys and examples
Dashboard scraping
The New Scrape form is the fastest way to collect structured data:
- Search query — what you want to find (products, articles, videos, etc.). For a single product page, paste the URL in the custom URL field instead.
- Site— a pre-built template tuned for that website's layout. Choose Any site (AI) when no template exists.
- Max results — how many items to return (1–50). More results use more credits.
- Output format — table view in the dashboard; export as JSON or CSV from the job page.
Before you run a scrape, the form shows an estimated credit costand your current balance. If you don't have enough credits, the scrape won't start.
Completed scrapes appear on the Endpoints page. Click any row to see full results, re-run the scrape, or copy live URLs.
Site templates
Templates use site-specific rules for speed and reliability. When a template doesn't return enough data, DeepFetch can fall back to AI extraction automatically.
Marketplaces
Heavy bot checks — residential proxy recommended
Retail
Bot protection common — proxy recommended
Bot protection common — proxy recommended
Groceries
Search
May block automated browsers — try Bing or DuckDuckGo if results fail
Lite HTML interface — may block datacenter IPs
Social
Often requires login — results may be limited
Jobs
May require sign-in for full results
Travel
Bot checks common — proxy recommended
Search by location name
Real Estate
Heavy bot protection — proxy recommended
Auto
Video
Knowledge
Tech
Any site (AI)
Paste any website URL and describe what to extract. AI reads the page and pulls out titles, prices, links, and other fields. Slower and uses more credits than templates, but works on sites we don't have a template for yet.
Live endpoints
Every completed scrape can be published as a live URL — a simple HTTP link that returns your data as JSON. Find these on any job detail page under Live API Endpoint.
- Cached data — returns the last successful scrape instantly. Ideal for dashboards and apps that poll periodically.
- Fresh data — triggers a new scrape on each request, then returns updated results. Rate limited to protect your credits.
Use the Refresh button on a job page to re-run a scrape manually without going through the API URL.
Developer API
The REST API gives full control over page fetching, JavaScript rendering, proxies, screenshots, CSS/XPath extraction, and AI-powered queries. Manage keys on the API page.
Authenticate every request with one of:
Authorization: Bearer YOUR_API_KEY?api_key=YOUR_API_KEY
Common use cases:
- Fetch a page with JavaScript rendered — SPAs, React sites, lazy-loaded content
- Extract fields with CSS rules — product names, prices, links from any HTML page
- Ask a natural-language question — ai_query=price of the product
- Search Google or Bing —
/api/v1/store/google?search=... - Take full-page or element screenshots
- Check credit usage —
GET /api/v1/usage
The API page includes copy-paste curl examples. Full parameter reference is available at /api/openapi for OpenAPI-compatible tools.
Webhooks
Get notified when a dashboard scrape finishes. Configure your webhook URL in Account settings. Works with Zapier Catch Hook, Make, and custom HTTPS endpoints.
- DeepFetch POSTs JSON when a job completes or fails. Payload includes
endpointDataUrl,endpointFreshUrl,dashboardUrl, and adataPreviewarray for no-code tools. - Events:
job.completed,job.failed, andjob.test(from Send test webhook in settings). - Optionally set a signing secret. Verify with
X-DeepFetch-Signature(SHA-256 HMAC) orX-Hook-Secretfor Zapier.
Zapier: Trigger → Webhooks by Zapier → Catch Hook → paste URL into settings → Send test webhook → Test trigger → add your actions (Sheets, Slack, Airtable, etc.).
Analytics
The Analytics page shows how your account is performing over the last two weeks:
- Daily scrape volume and credit usage
- Success vs failure rate
- Average scrape duration
- Recent errors — useful for spotting blocked sites or bad queries
Use analytics to decide when to switch from a template to AI mode, enable premium proxies via the API, or adjust scrape frequency on live endpoints.
Account
Manage your profile, webhook settings, and account deletion from Account settings.
- Update your display name
- View credit balance and plan tier
- Configure webhook URL and signing secret
- Permanently delete your account and all associated data
Sign in with Google. Your session stays active until you sign out from the sidebar.
Troubleshooting
Empty or failed results
Some sites block automated browsers (especially Google Search). Try Bing Search, a different template, or Any site (AI) with a direct product URL.
Failed dashboard jobs are fully refunded. Check the error message and failure screenshot on the job page for clues.
Insufficient credits
Reduce max results, use a cheaper site template instead of AI mode, or wait for your plan to renew. The scrape form shows the exact cost before you run.
API returns 403 or blocked
The target site detected the scraper. Retry with premium_proxy=true via the API. Response headers include Sf-block-type to help diagnose the issue.
Stale endpoint data
Cached endpoint URLs return the last scrape until you refresh. Use a Fresh URL or the Refresh button on the job page when you need up-to-date data.
FAQ
Do I need to install anything?
No. DeepFetch runs entirely in the cloud. Use the dashboard in your browser or call the API from any language.
Can I use DeepFetch without coding?
Yes. The dashboard, live endpoint URLs, and CSV export require zero code. The API is optional for developers.
What data format do I get?
Structured JSON with fields like title, price, rating, URL, and image — depending on the site. Export as CSV from any job page.
Is re-scraping the same query free?
No — each new scrape uses credits. However, rescrapes reuse cached extraction logic when possible, so repeat runs are often faster.
Where can I get more API details?
Visit the API page for keys, usage charts, and curl examples. OpenAPI spec at /api/openapi. Or read the public API reference.