MrScraperMrScraper
Dashboard
DocumentationAPI ReferenceResidential ProxyChangelog
ScraperAI Scraper

Rerun an AI Scraper

Rerun an existing AI Scraper by scraperId and url with the MrScraper v3 API, reusing cached results to cut token usage and execution time.

This endpoint reruns an existing AI scraper using the specified scraperId and url. Reruns leverage previously cached results, which can reduce token consumption and improve execution time.

Note

  • Use the V3 Platform API Server (https://api.app.mrscraper.com) host when calling this endpoint.
  • Each AI Scraper agent returns a unique response format. For details, see here.
  • The parameters below can be modified only for the AI Map Agent Scraper:
    • maxDepth
    • maxPages
    • limit
    • includePatterns
    • excludePatterns
POST
/api/v1/scrapers-ai-rerun

Authorization

apiKey
x-api-token<token>

In: header

Header Parameters

accept*string
Value in"application/json"

Request Body

application/json

scraperId*string

Unique identifier of the scraper to rerun

Formatuuid
url*string

URL to scrape

Formaturi
maxDepth?number

Maximum depth for crawling links

Default2
maxPages?number

Maximum number of pages to scrape

Default50
limit?number

Limit the number of results

Default1000
includePatterns?string

Regex pattern to include specific URLs

excludePatterns?string

Regex pattern to exclude specific URLs

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://api.app.mrscraper.com/api/v1/scrapers-ai-rerun" \  -H "accept: application/json" \  -H "Content-Type: application/json" \  -d '{    "scraperId": "4f6a04d6-7dc9-4676-bddf-edd19497b1dd",    "url": "https://shopee.co.id/"  }'
{
  "message": "Successful operation!",
  "data": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "createdAt": "2019-08-24T14:15:22Z",
    "userId": "2c4a230c-5085-4924-a3e1-25fb4fc5965b",
    "scraperId": "6695bf87-aaa6-46b0-b1ee-88586b222b0b",
    "type": "Rerun-AI",
    "url": "http://example.com",
    "status": "Finished",
    "error": "string",
    "tokenUsage": 0,
    "runtime": 0,
    "data": {},
    "htmlPath": "string",
    "recordingPath": "string",
    "screenshotPath": "string",
    "dataPath": "string",
    "htmlContent": "string"
  }
}
{
  "message": "Unauthorized access",
  "error": "Unauthorized"
}
{
  "message": "You do not have permission to access this resource",
  "error": "Forbidden",
  "statusCode": 403
}
{
  "message": "Resource not found",
  "error": "Not Found",
  "statusCode": 404
}
{
  "message": "Validation failed",
  "error": "Unprocessable Entity",
  "statusCode": 422
}
{
  "message": "Too many requests. Please try again later."
}

Create and Run AI Scraper POST

Create and run a new AI Scraper from natural language instructions using the MrScraper v3 API, then save the scraperId to rerun it later.

Bulk Rerun AI Scraper POST

Run an AI Scraper across multiple URLs at once with the MrScraper v3 API, then poll the bulkResultId for merged data and per-URL status.