# Serper Scrape - Core.Today AI API

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

- **Provider**: Serper
- **Model ID**: serper/scrape
- **Category**: Web Search
- **Credits**: 5 per page (2 Serper credits)
- **Speed**: Fast
- **Quality**: High

## Features
- Clean page text, optionally markdown
- Meta tags and Open Graph
- JSON-LD structured data

## Use Cases
- Reading a search result in full
- Extracting product or article metadata
- Feeding pages into RAG pipelines

## API Endpoint

Base URL: https://api.core.today/v1
Create Prediction: POST /predictions
Get Status: GET /predictions/{job_id}

## Authentication
Header: X-API-Key: YOUR_API_KEY

## Input Parameters

### Required
- **url**: string - Web page URL to fetch.

### Optional
- **includeMarkdown**: boolean (default: false) - Also return the page as markdown.

## Examples

### Basic request
A typical request with the most common options.
```json
{
  "model": "serper/scrape",
  "input": {
    "url": "https://docs.tavily.com/documentation/api-credits",
    "includeMarkdown": true
  }
}
```

## Response Format
```json
{
  "job_id": "abc123",
  "status": "pending | processing | completed | failed",
  "result": "URL or data (when completed)"
}
```

## Usage Flow
1. POST /predictions with model and input -> receive job_id
2. GET /predictions/{job_id} -> poll until status is completed or failed
3. Result contains output URL(s)

## Tips
- The result is the provider's JSON as-is (text, markdown, metadata, jsonld)
- Links in the result point to the original pages - nothing is copied to your storage

## Documentation
https://serper.dev