Web Search
Run a search query with MrScraper Web Search and get ranked results with titles, URLs, descriptions, and sources, without scraping the results page yourself.
Overview
Web Search runs a search query and returns structured search results, without scraping the results page yourself. It works alongside the Scraper API: use Web Search to find pages, then the Scraper API to fetch them. Instead of a target URL, you enter a search query, and each result comes back with its rank, title, URL, description, and source.
To open it in the app, select Web Search in the left sidebar, or go to app.mrscraper.com/web-search.
Practical Applications
- AI Agent Research: Let AI agents find relevant pages for a question before fetching them with Scrape HTML or Scrape Markdown.
- URL Discovery: Build lists of target URLs for a topic, product, or competitor to feed into other scraping runs.
- SEO & Rank Tracking: Check where a domain ranks for a keyword and which sites appear alongside it.
- Brand Monitoring: Track reviews, comparisons, and mentions of a brand across the web.
- Market Research: Compare search results for the same query across different countries.
Search Settings
| Setting | Description | Default |
|---|---|---|
| Country | Country to run the search from. | United States |
| Results | How many results to return, from 10 to 100. The search may return fewer. | 10 |
Query Parameters
Send all inputs as URL-encoded query parameters in a GET request.
| Parameter | Required | Description |
|---|---|---|
action | Yes | Must be websearch. Selects the Web Search use case. |
query | Yes | The search query. |
country | No | Two-letter country code to run the search from. Defaults to us. |
numResults | No | How many results to return, from 10 to 100. Defaults to 10. |
Response Fields
| Field | Description |
|---|---|
success | Whether the search completed. |
message | Status message. |
data | Search results, ordered by rank. |
tokenUsage | Tokens consumed by the request. |
Each item in data contains:
| Field | Description |
|---|---|
rank | Position of the result in the search results, starting at 1. |
title | Title of the result page. |
url | URL of the result page. |
description | Snippet shown for the result. |
source | Name of the website that published the result. |
Example
Request
Search for mrscraper from the United States and return 10 results
curl --location 'https://api.mrscraper.com/?action=websearch&query=mrscraper&country=us&numResults=10' \
-H 'x-api-token: {MRSCRAPER_API_TOKEN}'Response
{
"success": true,
"message": "Search completed",
"data": [
{
"rank": 1,
"title": "MrScrapper Review 2026: Features, Pricing & Alternatives",
"url": "https://futuretoolai.com/tool/mrscrapper",
"description": "Oct 23, 2026 — MrScrapper is an advanced artificial intelligence application specifically engineered to excel in Web Scraping. Automate data entry, extract ...Read more",
"source": "futuretoolai.com"
},
{
"rank": 2,
"title": "MrScrapper — Pricing, Reviews & Alternatives",
"url": "https://www.neura.market/ai-tools-directory/data-analytics/mrscrapper",
"description": "MrScrapper is an advanced web scraping tool powered by Artificial Intelligence (AI) that provides data extraction solutions to businesses.Read more",
"source": "Neura Market"
},
{
"rank": 3,
"title": "MrScraper - Bewertungen & Alternativen",
"url": "https://www.lacreme.ai/de/outil/mrscraper",
"description": "MrScraper ist ein visuelles Web-Scraping-Tool, das entwickelt wurde, um Daten von Websites mühelos und ohne Blockierungen zu extrahieren.Read more",
"source": "Lacreme.ai"
},
{
"rank": 4,
"title": "MrScraper Review: AI-Powered Web Scraper",
"url": "https://ailistingtool.com/blog/mrscraper-ai-data-scraper-review",
"description": "Oct 8, 2026 — MrScraper is an AI web scraping platform that turns public web pages into structured JSON or CSV, with proxies, a headless browser and CAPTCHA ...",
"source": "AIListingTool"
},
{
"rank": 5,
"title": "How to Use Mrscraper ScrapeGPT with Pagination",
"url": "https://medium.com/@Mrscraper/how-to-use-mrscraper-scrapegpt-with-pagination-a-comparison-with-manual-scraping-fc93d4db0fcd",
"description": "Oct 8, 2024 — For those looking for a more accessible solution, Mrscraper ScrapeGPT offers an effortless way to scrape data across multiple pages with no ...Read more",
"source": "Medium"
},
{
"rank": 6,
"title": "MrScrapper - AI Marketplace",
"url": "https://ai.g2.com/marketplace/tools/mrscrapper",
"description": "MrScraper is an AI-powered web scraping platform offering tools to automate data extraction from any website at scale.",
"source": "G2"
},
{
"rank": 7,
"title": "mscraper",
"url": "https://apify.com/mscraper",
"description": "Scraper is a specialized web scraping tool designed to provide valuable real-time data on stock prices, market trends, and financial metrics from TipRanks.",
"source": "Apify"
},
{
"rank": 8,
"title": "MrScraper vs Apify: Visual AI Scraping Without Actors",
"url": "https://mrscraper.com/mrscraper-vs-apify",
"description": "MrScraper is a tool that helps you collect information from websites quickly and easily. Instead of fighting annoying captchas, MrScraper does the work for you.Read more",
"source": "MrScraper"
},
{
"rank": 9,
"title": "MrScrapper: Advanced web scraping tool powered by AI",
"url": "https://foundr.ai/mrscrapper",
"description": "MrScraper is an AI-powered web scraper that combines language models with traditional scraping techniques to extract data from web pages without the need ...Read more",
"source": "foundr.ai"
},
{
"rank": 10,
"title": "Data Scraper vs. MrScraper Comparison",
"url": "https://sourceforge.net/software/compare/DataScraper.cc-vs-MrScraper/",
"description": "Compare Data Scraper vs. MrScraper using this comparison chart. Compare price, features, and reviews of the software side-by-side to make the best choice ...",
"source": "SourceForge"
}
],
"tokenUsage": 10
}Quickstart
A step-by-step guide to making your first MrScraper API request, scraping a product page with the General AI Agent in just a few minutes.
Scraper API
Build, test, and validate scraping requests in MrScraper's Scraper API, preview results, and generate production-ready API code without coding.