# Serper Scrape

> Fetch one web page through Serper - clean text (optionally markdown), page metadata and JSON-LD. 5 credits per page.

- **Provider**: serper-scrape
- **Model ID**: serper/scrape
- **Category**: web_search
- **Credits**: from 5 for the default configuration — varies by input, see Pricing
- **Pricing Type**: formula

## API Endpoint

Base URL: https://api.core.today/v1

### Create Prediction
POST /predictions

### Get Status
GET /predictions/{job_id}

### Cancel
DELETE /predictions/{job_id}

## Authentication

Header: `X-API-Key: YOUR_API_KEY`

## Input Parameters

- `url` (string, **required**): Web page URL to fetch.
- `includeMarkdown` (boolean, optional): Also return the page as markdown. (Default: `false`)

## Example Request

```json
{
  "model": "serper/scrape",
  "input": {
    "url": "https://docs.tavily.com/documentation/api-credits",
    "includeMarkdown": true
  }
}
```

## Response Format

```json
{
  "job_id": "abc123",
  "status": "pending",
  "provider": "serper-scrape",
  "model": "serper/scrape",
  "created_at": "2026-01-01T00:00:00Z",
  "result": null,
  "error": null,
  "credits_used": null
}
```

Status values: `pending`, `processing`, `completed`, `failed`, `cancelled`

When the job is `completed`, `result` holds the output URL(s) or data and `credits_used` the net credits charged. When it is `failed`, `error` and `error_code` say why and the charge is refunded.

## Usage Flow

1. POST /predictions with model and input → receive job_id
2. Poll GET /predictions/{job_id} until status is `completed` or `failed`
3. Result contains output URL(s) or data

## Pricing

- Formula: `2.325 * max(1, min(2, billed))` credits
  - `billed`: 99

Default configuration: 5 credits.

These are list prices. The amount charged is rounded, and large charges are discounted progressively. `POST /predictions/estimate` with the same `model` and `input` returns the charge for that input without creating a job (an estimate when the price depends on the output).

## Output Type

json

## Tags

serper, scrape, extract, web-scraping

## Documentation

https://serper.dev