# Serper Google News - Core.Today AI API

> Google News results through Serper - headline, source, date, snippet and image for each article. 3 credits per search.

- **Provider**: Serper
- **Model ID**: serper/news
- **Category**: Web Search
- **Credits**: 3 per search (num > 10 reserved at 5, settled on Serper's charge)
- **Speed**: Fast
- **Quality**: High

## Features
- Google News articles with source and date
- Past hour/day/week filters for breaking news
- Country and language targeting

## Use Cases
- News monitoring and alerts
- Daily briefings for agents
- Brand and competitor mentions

## 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
- **q**: string - The search query.

### Optional
- **gl**: string - Country of the results as a lowercase ISO 3166-1 code (e.g. kr, us). Serper default us.
- **hl**: string - Language of the results (e.g. ko, en). Serper default en.
- **location**: string - Search as if from this place, e.g. Seoul, South Korea.
- **num**: integer (default: 10) - Number of results. Up to 10 is one Serper credit; 11-100 is reserved at two and settled on what Serper charged.
- **page**: integer (default: 1) - Results page (1 = first).
- **tbs**: string - Time filter - past hour, day, week, month or year. Omit for any time.
  Options: qdr:h, qdr:d, qdr:w, qdr:m, qdr:y
- **autocorrect**: boolean (default: true) - Let Google autocorrect the query.

## Examples

### Basic request
A typical request with the most common options.
```json
{
  "model": "serper/news",
  "input": {
    "q": "생성형 AI",
    "gl": "kr",
    "hl": "ko",
    "tbs": "qdr:d"
  }
}
```

## 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 (news)
- Links in the result point to the original pages - nothing is copied to your storage
- Billed on the credits Serper reports in the response (`credits`) - the reservation is refunded down to it

## Documentation
https://serper.dev