Skip to main content
Core.Today
|
SerperFastHigh

Serper Google Images

Google Images results through Serper - image URL, thumbnail, size, source page and title. 3 credits per search.

3 credits
per search (num > 10 reserved at 5, settled on Serper's charge)
Original image URLs with size and thumbnail
Source page link and domain for each image
Image links are returned as-is, not copied to storage

Run it right now

Test this model instantly in the Console Playground โ€” no code required

Sign in to try

Use with AI Assistant

Copy usage instructions for Claude, ChatGPT, or other AI

Quick Start

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "serper/images",
  "input": {
    "q": "seoul skyline night",
    "num": 10
  }
}'

Parameters

ParameterTypeRequiredDefaultDescription
qstringYes-The search query.
glstringNo-Country of the results as a lowercase ISO 3166-1 code (e.g. kr, us). Serper default us.
hlstringNo-Language of the results (e.g. ko, en). Serper default en.
locationstringNo-Search as if from this place, e.g. Seoul, South Korea.
numintegerNo10Number of results. Up to 10 is one Serper credit; 11-100 is reserved at two and settled on what Serper charged.
pageintegerNo1Results page (1 = first).
tbsstringNo-Time filter - past hour, day, week, month or year. Omit for any time.
qdr:hqdr:dqdr:wqdr:mqdr:y
autocorrectbooleanNotrueLet Google autocorrect the query.

Common Parameters

Common parameters used when calling POST /v1/predictions.

ParameterTypeRequiredDefaultDescription
modelstringYes-Model identifier
inputobjectYes-Object containing the model-specific parameters from the table above
output_folderstringNo-Folder path for output files (max 256 chars, '..' not allowed)
webhook_urlstringNo-Webhook URL to call on completion
is_publicbooleanNofalseIf true, output files are also available via permanent public URLs

Examples

Basic request

A typical request with the most common options.

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "serper/images",
  "input": {
    "q": "seoul skyline night",
    "num": 10
  }
}'

Tips & Best Practices

1The result is the provider's JSON as-is (images)
2Links in the result point to the original pages - nothing is copied to your storage
3Billed on the credits Serper reports in the response (`credits`) - the reservation is refunded down to it

Use Cases

Reference image discovery for generation prompts
Visual research and mood boards
Checking where an image is used