Endpoints & Pricing
Three Image Engines, One API Key
Choose DuckDuckGo for the best value, Yahoo for broad country coverage, or Google for the largest image index. Pay only for what you use.
DDG Images
- Up to 100 images per request
- Thumbnails & full-size URLs
- Image dimensions included
- 112 country targeting
- SafeSearch filtering
- Structured JSON fields
Yahoo/Bing Images
- 20-30 images per page
- Thumbnails & source URLs
- 112 country targeting
- Pagination support
- Structured accuracy
- Structured JSON fields
Google Images
- Up to 100 images per request
- Largest image index
- Full-size URLs & thumbnails
- Dimensions & file format
- Color & size filters
- Alt text / title included
Quick Start
Search Images in Seconds
A single API call returns structured image data with thumbnails and source URLs. Use size filters to find exactly what you need.
# Search images with large size filter curl "https://apiserpent.com/api/images?q=mountain+landscape&engine=ddg&size=large&num=20" \ -H "X-API-Key: YOUR_API_KEY"
{
"searchParameters": {
"q": "mountain landscape",
"engine": "ddg",
"type": "images",
"size": "large"
},
"images": [
{
"title": "Beautiful Mountain Landscape at Sunset",
"imageUrl": "https://example.com/mountain-full.jpg",
"thumbnailUrl": "https://example.com/mountain-thumb.jpg",
"sourceUrl": "https://example.com/gallery/mountains",
"width": 3840,
"height": 2160
}
],
"totalResults": 20,
"credits": { "used": 1, "remaining": 99 }
}
Data Fields
Complete Image Data from Every Engine
Each image endpoint returns structured JSON with all the metadata you need for visual search tools, content platforms, and design applications.
Image Fields
- images[].imageUrl
- images[].thumbnailUrl
- images[].title
- images[].sourceUrl
- images[].width
- images[].height
- images[].format
- totalResults
Request Parameters
- q (search query)
- engine (google, yahoo, bing, ddg, brave)
- num (results count)
- size (small, medium, large)
- type (photo, clipart, animated)
- color (filter by color)
- aspect (square, wide, tall)
- license (cc, public, modify…)
- safe (SafeSearch strict/moderate/off)
- country (localization)
- language (e.g., en, es, de)
Engine Comparison
- DDG: from $0.42/1K (Scale), 112 countries
- Yahoo: from $0.42/1K (Scale), 112 countries
- Google: from $0.42/1K (Scale), 112 countries, largest index
- All return thumbnails + full URLs
- All return dimensions
Use Cases
- Visual content research
- Stock photo alternatives
- Design inspiration tools
- Content curation platforms
- Brand image monitoring
FAQ
Image Search API Questions
num parameter.
Start using the Image Search API
Image Search requires paid credits from call 1. Add credits when you are ready to run live image queries.
View Pricing

