Integration spotlight: Google Search - Top Sites

Integration spotlight: Google Search - Top Sites

Overview

Our Google Search - Top Sites integration allows you to search within LinkedIn and XING by default, as well as within specified domains by using your Custom Search Engine. With our integration you can find:

  • company profiles on LinkedIn and XING
  • person profiles on LinkedIn and XING
  • open job position on LinkedIn
  • custom results by using your Google Custom Search engine

Integration pricing and limitations

Each executed function costs 0.05 EUR and returns up to 100 responses.

Functions

Our Google Search - Top Sites integration consists of the following functions:

Function Description
CUSTOM_SEARCH_RESTRICTED_GOOGLE Get search results using your Google Custom Search Engine.
SEARCH_LINKEDIN_COMPANY_GOOGLE Get company profiles from LinkedIn.
SEARCH_LINKEDIN_JOB_GOOGLE Get open job positions from LinkedIn.
SEARCH_LINKEDIN_PERSON_GOOGLE Get person profiles from LinkedIn.
SEARCH_XING_COMPANY_GOOGLE Get company profiles from XING.
SEARCH_XING_PERSON_GOOGLE Get person profiles from XING.

Note on Google Search Operators

All the functions in our Google Search - Top Sites integration support Google Search Operators (GSOs). They allow you to narrow down your search so that you find exactly what you’re looking for.

The most commonly used search operators are:

Operator Use Case Example
OR You want to get one item or the other. "('gold' OR 'silver' OR 'bronze')" returns results that contain gold, silver, or bronze.
AND You want to get items that have both elements. "('gold' AND 'silver' AND 'bronze')" returns results that contain all three together.
- You don’t want to get this item. "gold -silver -bronze"

:memo: Note: To make your life a bit easier, our functions include the type and country parameters (replacing the need to use GSOs to specify the search type or localizing the site domain). Use the type parameter to indicate if you want exact or approximate results to your search query. Use country to specify the country domains you want to restrict your search to.

Check out the Syntax and Examples sections of each function for practical use cases of these operators.

CUSTOM_SEARCH_RESTRICTED_GOOGLE

Get results restricted to the sites defined in your Google Custom Search Engine. To use this function, you’ll need the ID of your Google Custom Search engine.

To create a custom engine, just go to your Google Custom Search Engine dashboard and create one.

To get the Search engine ID, just go the Setup section of the custom engine you want to use.

Syntax

CUSTOM_SEARCH_RESTRICTED_GOOGLE(query, engineID, [type], [restrict_date])

Parameter Mandatory Description
query Yes The search terms. For example: "Huawei P20" or "('Engineering Manager' OR 'Engineering Director') New Zealand".
engineID Yes ID of your Google Custom Search engine. For example: "1568313218324:llnasdfi7q".
type No The GSO search type. Use one of the following:
- "type-open": (default) Search the page title for any combination of your query.
- "title-strict": Search the page title a direct match of your query.
-"open": Search the entire page for any combination of your query.
-"strict": Search the entire page for a direct match of your query.
dateRestrict No Get results newer than:
- "dN": N days. For example: "d2" returns results from the last two days.
- "wN": N weeks. For example: "w1" returns results from the last week.
- "mN": N months. For example: "m3" returns results from the last three months.
- "yN": N years. For example: "y4" returns results from the last four years.

Examples

:memo: Note: For the examples below, our Custom Search Engine was restricted to apple.com, microsoft.com, twitter.com, and theverge.com.

To get results that have Microsoft Teams in their title from the last five weeks:

=CUSTOM_SEARCH_RESTRICTED_GOOGLE("Microsoft Teams","custom_search:engine_id","title-open","w7")

To get results that have Microsoft CEO exactly in their title from the last seven days:

=CUSTOM_SEARCH_RESTRICTED_GOOGLE("Microsoft CEO","custom_search:engine_id","title-strict","d7")

To get results that have Slack or Microsoft Teams anywhere on the page from the last three months:

=CUSTOM_SEARCH_RESTRICTED_GOOGLE("Slack OR Microsoft Teams","custom_search:engine_id","open","m3")

SEARCH_LINKEDIN_COMPANY_GOOGLE

Get the company profile from LinkedIn, including the LinkedIn URL and company snippet.

Syntax

Parameter Mandatory Description
query Yes The company or companies you want. For example: "Apple" or "Microsoft OR Google".
type No The GSO search type. Use one of the following:
- "type-open": (default) Search the page title for any combination of your query.
- "title-strict": Search the page title for a direct match of your query.
-"open": Search the entire page for any combination of your query.
-"strict": Search the entire page for a direct match of your query.
country No Localization of your search. For example: "de" returns responses from German-language LinkedIn site.

Examples

To get results for Apple:

=SEARCH_LINKEDIN_COMPANY_GOOGLE("Apple")

To get results for several companies at once (Apple, Microsoft, and Google) use the OR operator:

=SEARCH_LINKEDIN_COMPANY_GOOGLE("Apple OR Microsoft OR Google")

To get results that have either Apple, Microsoft, or Google on their company page, but not Amazon:

=SEARCH_LINKEDIN_COMPANY_GOOGLE("(Apple OR Microsoft OR Google) -Amazon", "open")

To get results that have either Apple or Microsoft in their company page title, but not Amazon, and from the German domain of LinkedIn:

=SEARCH_LINKEDIN_COMPANY_GOOGLE("Apple OR Microsoft", "title-strict", "de")

SEARCH_LINKEDIN_JOB_GOOGLE

Get open job positions posted on LinkedIn, including the job description’s title, LinkedIn URL, and snippet.

Syntax

Parameter Mandatory Description
query Yes The job position or positions you want. For example: "Engineering Manager" or "('HR Director' OR 'Head of HR') Chicago".
type No The GSO search type. Use one of the following:
- "type-open": (default) Search the page title for any combination of your query.
- "title-strict": Search the page title for a direct match of your query.
-"open": Search the entire page for any combination of your query.
-"strict": Search the entire page for a direct match of your query.
country No Localization of your search. For example: "de" returns responses from German-language LinkedIn site.

Examples

To get open Engineering Manager positions:

=SEARCH_LINKEDIN_JOB_GOOGLE("Engineering Manager")

To get open Engineering Manager positions in the US but not at Microsoft:

=SEARCH_LINKEDIN_JOB_GOOGLE("Engineering Manager US -Microsoft")

To get results for open Engineering Manager, Head of Development, and Engineering Lead positions:

=SEARCH_LINKEDIN_JOB_GOOGLE("Engineering Manager OR Head of Development OR Engineering Lead")

To search for open Engineering Manager or Head of Development positions at Microsoft:

=SEARCH_LINKEDIN_JOB_GOOGLE("(Engineering Manager OR Head of Development) Microsoft")

To search for open Software Engineer or Software Developer positions, located in the US but not in Chicago:

=SEARCH_LINKEDIN_JOB_GOOGLE("(Software Engineer OR Software Developer) US -Chicago")

SEARCH_LINKEDIN_PERSON_GOOGLE

Provide one or more job functions or roles and get details from LinkedIn, including people profiles, URL links, and job titles. You can also specify the company and location by using GSOs (see the Examples section).

Syntax

Parameter Mandatory Description
query Yes The person or people you want. For example: "Apple CEO", "John Smith" or "(Engineering Manager OR Engineering Director) Chicago".
type No The GSO search type. Use one of the following:
- "type-open": (default) Search the page title for any combination of your query.
- "title-strict": Search the page title a direct match of your query.
-"open": Search the entire page for any combination of your query.
-"strict": Search the entire page for a direct match of your query.
country No Localization of your search. For example: "de" returns responses from German-language LinkedIn site.

Examples

To search for people who are investors:

=SEARCH_LINKEDIN_PERSON_GOOGLE("Investor")

To search for Engineering Managers located in Australia:

=SSEARCH_LINKEDIN_PERSON_GOOGLE("Engineering Manager Australia")

To search for people that have either Technical Writer, Content Writer, or UX Writer roles located in San Francisco:

=SEARCH_LINKEDIN_PERSON_GOOGLE("(Technical Writer OR Content Writer OR UX Writer) San Francisco")

To search for people that are an Engineering Manager or Head of Development anywhere in the world but Australia:

=SEARCH_LINKEDIN_PERSON_GOOGLE("(Engineering Manager OR Head of Development) -Australia")

SEARCH_XING_COMPANY_GOOGLE

Get the company profile from XING, including the title, XING URL, and snippet.

:memo: Note: Although XING caters to people and businesses from many countries, all results are retrieved from their single global domain (xing.com). As such, you cannot specify the country domain as with the LinkedIn functions.

Syntax

SEARCH_XING_COMPANY_GOOGLE(query, [type])

Parameter Mandatory Description
query Yes The company or companies you want. For example: "Apple" or "SAP OR Bosch".
type No The GSO search type. Use one of the following:
- "type-open": (default) Search the page title for any combination of your query.
- "title-strict": Search the page title a direct match of your query.
-"open": Search the entire page for any combination of your query.
-"strict": Search the entire page for a direct match of your query.

Examples

To find the XING company profile for SAP:

=SEARCH_XING_COMPANY_GOOGLE("SAP")

To find the XING company profiles for SAP or Bosch:

=SEARCH_XING_COMPANY_GOOGLE("SAP OR Bosch")

SEARCH_XING_PERSON_GOOGLE

SEARCH_XING_PERSON_GOOGLE(query, [type])

Get the person profile from XING, including their job title, XING URL, and snippet.

:memo: Note: Although XING caters to people and businesses from many countries, all results are retrieved from their single global domain (xing.com). As such, you cannot specify the country domain as with the LinkedIn functions.

Syntax

Parameter Mandatory Description
query Yes The person or people you want. For example: "HR Manager", "Max Mustermann" or "(HR Manager OR Leiter der Personalabteilung) Berlin".
type No The GSO search type. Use one of the following:
- "type-open": (default) Search the page title for any combination of your query.
- "title-strict": Search the page title a direct match of your query.
-"open": Search the entire page for any combination of your query.
-"strict": Search the entire page for a direct match of your query.

Examples

To find HR Managers:

=SEARCH_XING_PERSON_GOOGLE("HR Manager")

To find Engineering Managers in Berlin:

=SEARCH_XING_PERSON_GOOGLE("Engineering Manager Berlin")

To find Engineering Directorss or Technischer Leiters not located in Hamburg:

=SEARCH_XING_PERSON_GOOGLE("Technischer Leiter OR Engineering Director -Hamburg")

Go ahead and search away!

With these functions in hand, combined with the GSOs, it’ll be easy for you to find use your custom search engine, or the LinkedIn and XING functions, to find exactly what you’re looking fore.

So what are you waiting for - get building :rocket:!

1 Like