Change your location here to find out how suggestions reflect it.

Let's get started:

It's pretty straight forward: We will need to whitelist your Domain(s) and set up your PartnerID for your participation in sales and leads generated by thinksuggest.

Request your PartnerID

Pick your way of integration:

B) API based [for native integration]

If you'd like to customize the frontend view yourself in order to create a deep integration of thinksuggest inside your existing services, pick this way.

Read the API introduction

A) JavaScript based [quick & customizable]

Quick and easy: Copy the following code snippet into your existing HTML-Markup and you're done:

<html>
  <head>
Copy markup for html-HEAD section
  </head><body>
     ...
  </body>
  </html>

Feel free to tweak the JS-variables for the settings, especially "attachToID". You'll find it in the commented JS snipped you can copy with the button above. You may host the file to maintain control over what it does.


How to work with api.thinksuggest.org:

General info and parameters:

Simply query our API with a users search terms terms and we will respond with corresponding paid suggestions. User-clicks upon such results need to be handled by thinksuggest.
parameter meaning possible values explanation
m method s, c whether you want to
pid PartnerID your partner id within our system, e.g. "demopartner" To be provided by your contact at ThinkLABs.
q query urlencoded string Any user input. Used for delivering "s"uggestions and to optimize your individual user group based on your users' "c"licks.

Query the API for a suggestion (method "s"):

Please use the general parameters "m", "pid" and "q" as described above, along with the following:
parameter meaning possible values explanation
ul user language ISO-3166-1: Alpha-2 Codes The user's language, e.g. EN for English, DE for German. You might want to detect this via JS.
uc user's country ISO-3166-1: Alpha-2 Codes The user's country, e.g. GB for United Kingdom, US for USA, DE for Germany, AT for Austria.
mo maximum organic Numeric value from 0 to 9999. Suggested: 30 The maximum allowed SEO-rank of non-affiliate domains within the selected "uc" that may be shown.
We recommend to set it to at least "30", so that e.g. facebook.com, youtube.com and Co will usually show up once user types a single "f" or "y", so that your customers get used to/familiar with clicking this placement.
ps personal suggestions string Please eighter
  • transfer your existing text-only suggestions with this parameter (line-separated and urlencoded, e.g. fetched client-side from Bing)
  • or put "auto" if you want us to query Microsoft Azure (extra costs, only available for Germany atm)
We suggest to retrieve the standard-suggestions client side = free, and then place them in the ps-parameter.
jc (optional) JsonCallback JS Function Name If you prefer to get the API-response wrapped in a JS callback function state your function name in this parameter.
cap (optional) Capping (maximum number of results) numeric 0-10 If you want to limit the number of thinksuggest-results, you can set this value to anything between 1 and 10. Leaving the parameter away or setting it to 0 will make it use the default maximum of 10.

Example response:

Here's a method "s" example response from this query:
{
  "suggestions": {
    "": null,
    "~": [
      {
        "d": "adidas.com",
        "h": "7f63bc650fe1c379a176c7c99fc936ab",
        "u": "https://www.adidas.com/us/i-5923-shoes/B..",
        "l": "~ - adidas.com",
        "t": "d",
        "a": 1
      },
      {
        "d": "finishline.com",
        "h": "352d93d0169216596fb747f173c7c15d",
        "u": "https://www.finishline.com/ad..",
        "l": "~ - finishline.com",
        "t": "d",
        "a": 1
      },
      {
        "d": "stockx.com",
        "h": "fcbf4807e8e0bd6796724777931eb8e1",
        "u": "https://stockx.com/ad..",
        "l": "~ - stockx.com",
        "t": "d",
        "a": 1
      },
      {
        "d": "urbanoutfitters.com",
        "h": "4ca2d3cd1ff3c7949cec9d81a2acb536",
        "u": "https://www.urbanoutfitters.com/shop/adidas-ini..",
        "l": "~ - urbanoutfitters.com",
        "t": "d",
        "a": 1
      }
    ],
    "~ runner": [
      {
        "d": "adidas.com",
        "h": "f1106ce072f139d442a6961975e5a5ff",
        "u": "https://www.adidas.com/us/i-5923-shoes/B..",
        "l": "~ runner - adidas.com",
        "t": "d",
        "a": 1
      },
      {
        "d": "finishline.com",
        "h": "020a85138ae871814cb5e75a8f2857af",
        "u": "https://www.finishline.com/ad..",
        "l": "~ runner - finishline.com",
        "t": "d",
        "a": 1
      }
    ],
    "~ shoes": null,
    "~ red": null,
    "~ sale": null,
    "~ mens": null,
    "~ blue": null,
    "~ green": null,
    "~ pink": null,
    "~ boost": [
      {
        "d": "adidas.com",
        "h": "debcca09b5e7eac032e2e935e2494cd4",
        "u": "https://www.adidas.com/us/i_..",
        "l": "~ boost - adidas.com",
        "t": "d",
        "a": 1
      },
      {
        "d": "finishline.com",
        "h": "3f84fdb49de2999fa3cfcb13951cb45f",
        "u": "https://www.finishline.com/ad..",
        "l": "~ boost - finishline.com",
        "t": "d",
        "a": 1
      }
    ]
  }
}
        
As you can see

Let's look at one shop and it's information:
        "d": "adidas.com",
        "h": "7f63bc650fe1c379a176c7c99fc936ab",
        "u": "https://www.adidas.com/us/i-5923-shoes/B..",
        "l": "~ - adidas.com",
        "t": "d",
        "a": 1
key meaning possible values explanation
d domain adidas.com The shop domain of the result.
h hash string You'll need to pass this on to the "c"lick method in order to let your user click to that shop.
u URL string A Display-URL which you can utilize for higher click rates
l legible title string Contains a human-understandable title for the suggested result.
t type 1-char, see method click This parameter will tell us where the user should get redirected to:
  • h=homepage of the shop
  • d=deeplink to a specific site of the shop
  • s=search result page of the shop
a affiliate-status 0,1 This will tell you whether you'll earn a commission on this click. You might use it to label your affiliate-links with "Ad" for legal reasons.
s search-string string This parameter is only provided for result type=s (search). It tells you that the partner shop page will be opened with the stated suggested search-query. You should append this parameter to your method="c"lick calls.

Side note: More information can be made available in the response upon request as we've crawled all pages pretty thoroughly. We didn't consider them super-useful so far:

Method "c"lick:

To perform a clickout to a URL, please use the general parameters "m", "pid" and "q" as described above, along with the following:
parameter meaning possible values explanation
t type of click "h", "d" or "s" (homepage, deeplink, search) - You'll receive this info in the suggestion JSON Please pass it on upon clickout. This allows us to properly forward the click to the desired destination.
h hash string - You'll receive this info in the suggestion JSON Please pass it on upon clickout. This allows us to properly forward the click to the desired destination.
k keyword string - You'll receive this info in the suggestion JSON Please pass it on upon clickout. It will help our system learn which keyword generated the click and afterwards we will evaluate how well the suggestion has performed in terms of revenue for your user group.
s search terms string - You'll receive this info in the suggestion JSON Should be specified, if the clickout type is "s" (search). Contains optimized search terms which the clickout shop should be opened with.




Inspiration

Example Queries for Germany:

Query Possible Answer logic
a amazon.de as "a" can complete to the shop-name and amazon has a super high relevance ranking
"amazon hdmi Kabel" or "hdmi Kabel ama" Search "hdmi cable" on amazon.de as shop-name ("amazon" or "ama" is part of query)
hdmi Kabel numerous pages that sell HDMI Cables. Ordered by potential CPC and relevance.
"medi" Mediamarkt.de (homepage) as "medi" can complete to shop name)
"plays" Showing results for "Playstation 4", e.g. from Mediamarkt.de as mediamarkt ranks ~2 on Google for this Keyword
Playstation 4 Medi Search "Playstation 4" on Mediamarkt.de as "medi" can complete to the shop-name


So far we don't disclose more info online - so just get in touch :)