Google Images
Google Images ranks pictures from across the web for each search and shows each one with a title, the site it comes from and a link to the page it appears on, with the file's alt text behind it. Reading those rankings shows whether a brand's product photos appear for shopping terms, which sites own the visual results in a category and where an image is being reused, and it is also a quick way to gather visual references for a topic.
Google Images API Features
- The image file and its previewimage_url links to the full-size file and thumbnail_url to the preview Google displays, so you can download originals or render a light grid.
- The page behind every imageurl gives the page the image appears on, with source naming the site and domain giving its domain.
- Title and alt texttitle is the caption Google shows and text is the image's alt text, useful for checking how images are described.
- Ranked results in any marketrank keeps Google's order, and the country, language and results_limit from 1 to 700 set how far down the results you read.
Google Images API Parameters
| Parameters | Required | Description |
|---|---|---|
query | Required | Image search, such as a product, style or subject. |
location_code | Optional | Location code of the search market. Defaults to 2840 (United States). |
location_name | Optional | Market name as an alternative to location_code. When filled, it is used instead of location_code. |
language_code | Optional | Language code of the search. Defaults to en. |
language | Optional | Language name as an alternative to language_code. When filled, it is used instead of language_code. |
results_limit | Optional | Maximum number of images, from 1 to 700. Defaults to 100. |
How to Use the Google Images API
Send a search query to the Google Images API and read one row per image.
- POST {"query": "modern living room", "results_limit": 100} to /v1/seo/google-images.
- Poll GET /v1/tasks/{task_id} until status is succeeded.
- Read images from results.items in rank order, and request the next page with results.next_cursor while has_more is true.
curl -X POST "https://api.socq.ai/v1/seo/google-images" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"modern living room","results_limit":100}'Google Images API Use Cases
- Check product photo rankings: Run your shopping keywords and look for your domain in the results to see where your product images rank and which competitors appear above them.
- Find sites reusing your images: Search your product or brand names with the Google Images API and review the url and domain of each result to spot pages that publish your pictures.
- Collect visual references: Pull a few hundred results for a style or subject and lay out thumbnail_url in a grid for a mood board or creative brief.
- Audit alt text in a category: Compare the text of top-ranking images with your own to see how winning images in your category are described.
Google Images API Pro Tips
- If you only need to know whether you rank in the first rows, keep results_limit low, since the Google Images API charges 0.03 credits per image.
- When you display results in a page or report, load thumbnail_url and link to url, keeping image_url for the images you actually need in full size.
- If you track the same keyword in several countries, keep query identical and change only the location fields so the rankings compare cleanly.
Related APIs
Beyond the Google Images API, use these APIs when you need a different type of public SEO data.
- Google Organic SERP API — Retrieve one live Google result page by query and market with normalized destinations, ranks, element types, and full result details.
- Keyword Difficulty API — Compare organic ranking difficulty for a submitted keyword batch, returning each available keyword with its normalized score.
- Keyword Overview API — Enrich a submitted keyword batch with available demand, paid competition, difficulty, monthly-search, and intent context.
- Keyword Search Volume API — Measure known keywords with available search volume, CPC, paid competition, and monthly search history.
- Keywords for Site API — Generate keywords relevant to one website with available demand measurements, monthly history, market context, and complete source rows.
- Google Autocomplete API — Collect the search completions Google suggests for the start of a query, in Google's order, for any country and language.
- Keyword Suggestions API
- Ranked Keywords API
- Related Keywords API
- Relevant Pages API
- Search Intent API
- Backlinks Summary API
- Backlinks API
- Referring Domains API
- Backlink Competitors API
- Domain Overview API
- Competitor Domains API
- Traffic Estimate API
- Domain Technologies API
- Whois Lookup API
- Google News API
- Bing Search API
- YouTube Rank Tracker API