# Serper Google Shopping - Core.Today AI API

> Google Shopping results through Serper - product title, price, seller, rating and image. 5 credits per search.

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

## Features
- Prices and sellers across stores
- Ratings and review counts
- Country targeting for local prices

## Use Cases
- Price comparison and tracking
- Shopping assistants
- Market research

## 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 products (1-40).
- **page**: integer (default: 1) - Results page (1 = first).

## Examples

### Basic request
A typical request with the most common options.
```json
{
  "model": "serper/shopping",
  "input": {
    "q": "wireless earbuds",
    "gl": "kr",
    "hl": "ko",
    "num": 20
  }
}
```

## 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 (shopping)
- 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