{"uid":"cap_JeOsWCih1yA1y0MfpKw85","slug":"agents-openwebninja-com-search-images-openweb-ninja-bfdb3bf3","name":"Search Images (OpenWeb Ninja)","description":"Get real-time image search results from across the web. Supports all Google Images search filters.","url":"https://agents.openwebninja.com/realtime-image-search/search?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["query"],"properties":{"size":{"enum":["any","large","medium","icon","400x300_and_more","640x480_and_more","800x600_and_more","1024x768_and_more","2mp_and_more","4mp_and_more","6mp_and_more","8mp_and_more","10mp_and_more","12mp_and_more","15mp_and_more","20mp_and_more","40mp_and_more","70mp_and_more"],"type":"string","default":"any","description":"Find images of a specific size."},"time":{"enum":["any","day","week","month","year"],"type":"string","default":"any","description":"Find images last updated in a specific time range."},"type":{"enum":["any","face","photo","clipart","lineart","animated"],"type":"string","default":"any","description":"Find images of a specific type."},"color":{"enum":["any","red","orange","yellow","green","teal","blue","purple","pink","white","gray","black","brown","full","transparent","grayscale"],"type":"string","default":"any","description":"Find images with a specific dominant color."},"limit":{"type":"integer","default":10,"maximum":100,"minimum":1,"description":"Maximum number of results to return."},"query":{"type":"string","example":"beach","description":"Search query / keyword"},"fields":{"type":"string","description":"A comma separated list of image fields to include in the response (field projection). By default all fields are returned."},"region":{"type":"string","default":"us","description":"The country / region from which to make the query. Allowed values: 2-letter country code, see ISO 3166-1 alpha-2."},"country":{"type":"string","description":"Find images published in a specific country / region. Allowed values: 2-letter country code, see ISO 3166-1 alpha-2."},"file_type":{"enum":["any","jpg","jpeg","png","gif","svg","webp","ico","raw"],"type":"string","default":"any","description":"Find images of a specific format / file type."},"safe_search":{"enum":["off","blur","on"],"type":"string","default":"blur","description":"How to show explicit content in your search results, like sexual activity and graphic violence."},"aspect_ratio":{"enum":["any","tall","square","wide","panoramic"],"type":"string","default":"any","description":"Find images with a specific aspect ratio."},"usage_rights":{"enum":["any","creative_commons","commercial"],"type":"string","default":"any","description":"Find images with specific usage rights / license / copyright."}}},"responseSchema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"The unique identifier of the image."},"url":{"type":"string","description":"The direct URL of the image."},"rank":{"type":"integer","description":"The rank score of the image in relevance."},"size":{"type":"string","description":"The file size of the image."},"title":{"type":"string","description":"The title or alt text of the image."},"width":{"type":"integer","description":"The width of the image in pixels."},"height":{"type":"integer","description":"The height of the image in pixels."},"source":{"type":"string","description":"The name of the source site."},"position":{"type":"integer","description":"The position of the image in the search results."},"source_url":{"type":"string","description":"The URL of the source site."},"source_domain":{"type":"string","description":"The domain of the source website."},"thumbnail_url":{"type":"string","description":"The URL of the thumbnail image."},"thumbnail_width":{"type":"integer","description":"The width of the thumbnail in pixels."},"background_color":{"type":"string","description":"The background color of the image."},"thumbnail_height":{"type":"integer","description":"The height of the thumbnail in pixels."}}}},"status":{"type":"string","description":"The status of the API response."},"parameters":{"type":"object","properties":{"size":{"type":"string","description":"The image size filter used in the search."},"time":{"type":"string","description":"The time filter applied to the search."},"type":{"type":"string","description":"The image type filter applied."},"color":{"type":"string","description":"The color filter used in the search."},"query":{"type":"string","description":"The search query used for the image search."},"region":{"type":"string","description":"The region in which the search was performed."},"file_type":{"type":"string","description":"The file type filter applied to the images."},"safe_search":{"type":"string","description":"Indicates whether safe search was enabled."},"aspect_ratio":{"type":"string","description":"The aspect ratio filter used in the search."},"usage_rights":{"type":"string","description":"The usage rights filter applied to the search."}}},"request_id":{"type":"string","description":"Unique identifier for the API request."}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"unknown","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"unprobed","priceSource":"registry","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":"unknown","summary":"price unknown","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_53AriP9r-eYCm2Ri1AZtn","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.openwebninja.com","brandSlug":"agents-openwebninja-com-x402","brandBaseUrl":"https://agents.openwebninja.com","brandDocsUrl":null,"whatItDoes":"Returns real-time Google Images search results with rich metadata, supporting filters for size, color, type, file format, region, time range, and usage rights.","exampleAgentPrompt":"Search the web for up to 20 large JPG photos of 'cherry blossom festival' from the past month, safe search on, in the US region.","exampleUseCases":[{"title":"Finding transparent logos for a presentation","prompt":"Find me up to 15 transparent PNG images of the Apple logo — I need clean cutouts, no background."},{"title":"Sourcing recent news event photos","prompt":"Search for real photos of the 2024 Paris Olympics opening ceremony from the past month, give me the top 10 large images."},{"title":"Gathering color-matched visuals for a mood board","prompt":"I'm making a mood board — can you find 20 web images dominated by the color teal, preferably photos rather than clipart?"}],"resultDescription":"Returns an array of image results each containing the direct image URL, thumbnail URL, image title, pixel dimensions, file size, source website name and domain, source page URL, background color, and rank/position score — plus an echo of the search parameters used and the API status.","failureModes":["Missing required 'query' parameter returns a validation error","Invalid region or country code returns an error or empty results","Overly restrictive filter combinations (e.g. specific color + file type + size) may return zero results","Rate limit or quota exceeded returns a 402 or 429 error","Very niche queries may return fewer results than the requested limit"],"whenToPreferThis":"Use this endpoint when you need real-time web image search results with Google Images-level coverage and rich filtering (size, color, type, file format, aspect ratio, usage rights, region, recency). Prefer it over static image databases when freshness and breadth matter, and over general web search endpoints when you specifically need image metadata like dimensions, thumbnails, and source domains.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:35:32.126Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-search-images-openweb-ninja-bfdb3bf3"}