Getting started — API key + engine ID
You need two things from Google: an API key and a Search Engine ID. Both are free to create with any Google account.
1. Create the API key
- Go to console.cloud.google.com and create a project (any name, for example "My store images").
- Open APIs & Services → Library, search for Custom Search API, and click Enable.
- Open APIs & Services → Credentials → Create credentials → API key. Copy the key.
- Recommended: click the key, and under API restrictions allow only Custom Search API.
If Google does not let your project enable the Custom Search API, this module cannot work for your store.
2. Create the Search Engine ID
- Go to programmablesearchengine.google.com and click Add.
- Choose Search the entire web and switch Image search on.
- Create it, open it, and copy the Search engine ID.
3. Connect them to your store
- Open Settings → Modules, find Google Product Images, and switch it on.
- Click Configure. Paste the Google API Key and the Search Engine ID (cx).
- Save. The key is stored encrypted.
4. Try it
Open any product in Products → Products, scroll to Images, and click Search Google. Pictures should appear in a few seconds.
Free allowance: Google gives about 100 free searches a day per project, then charges per 1,000 searches. See FAQ for how searches are counted.
