- searches for listings that match your products (product matching);
- scrapes the offers of the listings you matched, by hand or on a schedule;
- verifies a suggested listing’s GTIN against your product.
Before you start
- You need the Settings permission under Pricing Intelligence > Data Source Schedule. Without it the Data provider section is not shown. An API key can never hold this permission.
- You need a DataForSEO account with API access: its login and password. If Omnilinker has set the provider up for your organization, the fields already show its values and you do not need your own account.
Set up the provider
1
Open the Data provider section
Open Administration > Settings, and under Pricing intelligence choose Data provider. The provider is in the Google Data Source Configuration card.
2
Switch the provider on
Tick Enable Google Data Source. It is off by default.
3
Enter the API endpoint and the provider type
In API Endpoint, enter DataForSEO’s address,
https://api.dataforseo.com. In Provider Type, enter
GoogleDataForSeoProvider; it is the only provider Omnilinker supports. Both fields are required while
Enable Google Data Source is ticked.4
Enter the credentials
Enter the DataForSEO account’s login in Username and its API password in Password. A username needs a
password.
5
Choose how many sellers to fetch
Set Sellers result depth (Google Shopping): how many seller offers each scrape of a listing fetches. See
What it costs.
6
Save
Click Save. Omnilinker confirms “Settings saved successfully”.
The Data provider section
Google Data Source Configuration
Discovery match quality
These settings filter the listings product matching suggests. See Product matching.GTIN verification
After a search, Omnilinker can check a suggestion’s GTIN against your product’s GTIN. It reads the GTIN from the listing’s specification and, when that has none, from the pages of the shops that sell it.Not on this page
A few provider limits are not in the section. Omnilinker sets them; contact Omnilinker to change them.What it costs
DataForSEO charges the account for each request. On this page:- Sellers result depth (Google Shopping): DataForSEO bills each block of up to 10 seller results, so a depth above 10 costs more per scrape. The default of 20 is two blocks.
- Verify GTIN after discovery: each verified suggestion is a paid request.
- Max candidates verified per product and Max seller pages fetched per candidate cap how much one search may verify.
Troubleshooting
Every scrape and every match search fails
Every scrape and every match search fails
Check that Enable Google Data Source is ticked, that Provider Type is
GoogleDataForSeoProvider, and that
Username and Password are filled in. If any of them is missing, every request fails.Save stays disabled and the field says “API Endpoint is required when Google is enabled” or “Provider Type is required when Google is enabled”
Save stays disabled and the field says “API Endpoint is required when Google is enabled” or “Provider Type is required when Google is enabled”
While Enable Google Data Source is ticked, both fields must be filled in. Enter
https://api.dataforseo.com in
API Endpoint and GoogleDataForSeoProvider in Provider Type, and save again.Save stays disabled and the field says “Password is required when Username is provided”
Save stays disabled and the field says “Password is required when Username is provided”
Enter the DataForSEO account’s API password in Password, or clear Username.
Save stays disabled and the field says “Please enter a valid URL for the API endpoint”
Save stays disabled and the field says “Please enter a valid URL for the API endpoint”
API Endpoint must be a full web address. Omnilinker does not use the value to connect, so enter DataForSEO’s
address,
https://api.dataforseo.com, and save again.Save stays disabled and the field says “Provider type can only contain letters, numbers, hyphens, and underscores”
Save stays disabled and the field says “Provider type can only contain letters, numbers, hyphens, and underscores”
The provider type has a space or another character it cannot hold. Enter
GoogleDataForSeoProvider exactly.GTIN checks stop with “requires payment or has insufficient credits”
GTIN checks stop with “requires payment or has insufficient credits”
The full message is “Enrichment provider ’…’ requires payment or has insufficient credits. Please top up your
account to continue enriching product data.” The DataForSEO account has run out of credit. Top it up in
DataForSEO; scrapes and searches need the same credit.
The fields show values you did not enter
The fields show values you did not enter
The values come from Omnilinker, which set the provider up for every organization. They apply until you change a
field and save it, which makes that value your organization’s own.
Markets and data sources
Decide where Omnilinker looks for offers.
Product matching
Match your products with the listings the provider finds.
Settings reference
Data source schedules and the other Pricing Intelligence settings.
Quickstart for retailers
From an empty catalog to your first offers.