SearchApi Google Images compatible

The call, before and after

# Before
curl -G "https://www.searchapi.io/api/v1/search" -d engine=google_images \
  --data-urlencode "q=koi pond" -H "Authorization: Bearer $SEARCHAPI_API_KEY"

# After
curl -G "https://api.specstream.ai/searchapi/api/v1/search" -d engine=google_images \
  --data-urlencode "q=koi pond" -H "Authorization: Bearer $SPECSTREAM_API_KEY"

The path, engine, the key's place and the parser stay. engine=google at the same address answers SearchApi's web search with the same key.

What the route reads, and what it refuses

Read and applied: q, gl for the country, hl for the language, safe, num from 1 to 100 and page from 1. search_parameters echoes device, location, uule, gl, hl, lr, cr, safe and time_period as you sent them.

Refused, in SearchApi's {"error", "reason"} form: another engine, such as engine=bing, gets 400 with the engines this address answers; a call with no key gets 401; a num outside 1 to 100 or a page below 1 gets 400 naming the range.

Every field that comes back

search_metadata carries id, status and total_time_taken. search_parameters carries engine, q, the fields above, and page past the first page. search_information carries query_displayed. Each of images[] has position, counted across pages, title, source with name and link for the page the image is on, and original with link for the image itself.

original.width, original.height and thumbnail are there when the search engines give them, and absent otherwise; the route never fills them in. One field is added, specstream, with the call's price. Left out of each reply: related_content_id, suggestions and related_searches.

One price a search, no hourly share

On SearchApi the plan sets the searches a month and the share of them an hour can use. On SpecStream an image search of up to 10 results is $0.005, the same as a web search. num asks for up to 100, and each started block of 10 more adds $0.006, so num=100 costs $0.059. There is no plan to renew and no daily limit, and credit you buy never expires. A busy call gets 429 in SearchApi's form with Retry-After and charges nothing.

What is kept, set on the key

A key made with zero_retention keeps no request text and no answer once the reply is sent, on image searches as on every other call. spend_cap_cents sets the most that key can spend, so a loop in a SearchApi client cannot run past it.

curl -X POST https://api.specstream.ai/v1/account/keys \
  -H "Authorization: Bearer $SPECSTREAM_API_KEY" -H "Content-Type: application/json" \
  -d '{"name": "production", "scopes": ["account:read", "finds:spend"], "spend_cap_cents": 500000, "zero_retention": true}'

Images, web, news and pages on one key

The results come from the image search of several engines at once, one result for each image address. The same key answers SearchApi's Google web search at the same address (the SearchApi migration has every web field), and SerpApi's, Serper's and Google Custom Search's image calls too (see the SerpApi Google Images and Google image search migrations).

The Extract API reads the page behind each source.link, up to 20 pages a call at $0.80 per 1,000 pages, and a page with no text is not charged. Deep Search returns every match for a request in plain words as structured rows, at 5¢, 15¢ or $1 a row, with a source URL on every value.

On SimpleQA Verified the SpecStream Search API scores 97.9 F-score on all 1,000 official questions, 978 of them correct, and on WideSearch 64.0 item F1 and 43.4 row F1 on all 200 official tasks. The Extract API scores 0.908 F1 on WCXB. Each score and its method is on the benchmarks page.

SerpApi

A plan per month: Starter is $25 for 1,000 searches, 200 an hour, and the free plan has 250 searches a month. SpecStream answers SerpApi's engine=google_images call at $0.005 with no plan (SerpApi Google Images migration).

Serper

Google results sold in credit packs from $1.00 per 1,000 for 50,000 credits, valid for 6 months, with 2,500 free queries. SpecStream credit never expires, and the same key answers Serper's /images call (Serper images migration).

Brave Search API

$5 per 1,000 requests, images included, up to 50 queries per second, with $5 in free credits every month. SpecStream answers Brave's /res/v1/images/search (Brave image search migration).