{"uid":"cap_H1gLFuzQeU4PQ1a0ojSSb","slug":"x402serps-image-search-f8efb5dd","name":"x402serps Image Search","description":"x402serps: Image results (title, page url, imageUrl, thumbnail, size) for one query, up to 20","url":"https://x402serps.com/api/v1/images?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"q":{"type":"string","description":"Query (alias: query)"},"gl":{"type":"string","description":"Country code, e.g. us, gb"},"num":{"type":"number","description":"Results 1-20, default 10"}}},"responseSchema":{"type":"json","example":{"query":"golden gate bridge","results":[{"url":"https://example.com/ggb","title":"Golden Gate Bridge","width":1600,"height":900,"source":"example.com","imageUrl":"https://example.com/ggb.jpg","position":1,"thumbnailUrl":"https://example.com/ggb_t.jpg"}],"provider":"primary"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_beBTExlEu9es3lFlZEDmV","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns image search results (title, page URL, image URL, thumbnail, dimensions) for a single query, up to 20 results, paid per call in USDC via x402.","exampleAgentPrompt":"Search for images of 'golden retriever puppies' and give me up to 15 results from the US, including the image URLs, thumbnail URLs, and page sources.","exampleUseCases":[{"title":"Product visual research for e-commerce","prompt":"Find me 20 images of 'minimalist wooden desk setup' — I need the image URLs, thumbnail URLs, and the websites they come from so I can research what styles are trending."},{"title":"Brand logo discovery and audit","prompt":"Search for images of 'Nike logo' limited to US results and return up to 10, including the image dimensions and source pages so I can see how the brand is represented online."},{"title":"Content illustration sourcing","prompt":"I'm writing a blog post about 'climate change protest' — can you pull 10 image search results with their URLs and thumbnails so I can find visuals to reference or license?"}],"resultDescription":"A JSON object containing the original query string, the provider name, and an array of up to 20 image result objects each with: position index, page URL, page title, image URL, thumbnail URL, image width, image height, and source domain.","failureModes":["Missing or empty query returns an error","num parameter out of 1-20 range may be rejected or clamped","Invalid country code gl may return default results or an error","Payment failure via x402 prevents the call from completing","Query returns fewer results than requested if insufficient images exist","Network timeout on upstream image search provider"],"whenToPreferThis":"Choose this endpoint when you need structured image search results with metadata (URL, thumbnail, dimensions, source) for a single query, especially in an AI agent pipeline that pays per call in USDC. Prefer over web scraping or general search endpoints when you specifically need image URLs and thumbnails rather than text snippets. Best for single-query, low-latency image discovery where cost-per-call billing is acceptable.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-16T18:33:26.720Z","isFirstParty":false,"canonicalSlug":"x402serps-image-search-f8efb5dd"}