Search
Search the web from code, and get each result page back as markdown in the same call.
Endpoints
- POST
/v1/searchRanked web results for a query, with optional page markdown and a cited answer.
Try it
Example outputtankless water heater cost
- Completeness
- not scored
- Fetched by
- web search
- Read by
- result pages to markdown
- Cost
- 2 credits per 10 results
Example values. This call returns no completeness score.
Shows example output until you press Run. Demo runs are free, up to 10 every 5 minutes.
What it returns
POST /v1/search
| Field | What it is | Present |
|---|---|---|
| results[] | Each result has url, title, snippet and position. | Always |
| results[].markdown | The result page as markdown. | When scrapeResults is true |
| source | Which search backend answered, or null. | Always |
| attempts[] | Every backend tried, with ok, latency_ms and error_class. | Always |
| zero_results | True when the search ran and nothing matched. A failed search returns 503 search_unavailable instead. | Always |
| unsupported[] | Sources you asked for that have no backend today (news, images). | When you ask for one |
| answer | A short answer that cites result positions, or null with answer_reason. | When include_answer is true |
| search | The operators that were applied to your query. | Always |
Search responses carry no completeness score. Results are ranked links.
One request
Send your key as a Bearer token. Every parameter in these samples is one the endpoint reads today. The Example tab shows a trimmed response for a fictional business.
Every parameter in the docscurl -X POST https://api.superscraper.dev/v1/search \
-H "Authorization: Bearer $SUPERSCRAPER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "open-source vector databases",
"limit": 5,
"scrapeResults": true
}'Pricing
Compare the plans- Search
- 2credits per 10 results
- Counted on the results returned. A search with no results costs 0 credits.
Results per search
- free
- 20
- hobby
- 50
- pro
- 100
- scale
- 100
Per request, by plan.
Questions
Can I search inside one site?
Yes. Pass includeDomains (or excludeDomains) with bare hostnames, or type site: in the query.
Can I filter by date or type?
tbs takes a time filter such as qdr:w for the past week. categories takes github, research or pdf.
Does it search news or images?
Web results only today. A request for news or images is listed in unsupported[], with no results for that source.
Coming soon
- AnswersComing soon
- Research jobsComing soon
Not callable yet. Beta items open as beta first.