*Updated* 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_PROFILES Get person profiles from LinkedIn.
SEARCH_XING_COMPANY_GOOGLE Get company profiles from XING.
SEARCH_XING_PERSON_GOOGLE Get person profiles from XING.

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"

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.

:memo: Note: Sometimes when you search for a company, such as Audi, you might get results for Audible as well due to the nature of Google’s algorithm. In cases such as this, add a space after your term to make sure that you get the results you want. For example: "Audi " instead of "Audi" will filter out results like Audible, Audict, and Audination.

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

=SEARCH_LINKEDIN_COMPANY_GOOGLE(query, [type], [country])

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

SEARCH_LINKEDIN_JOB_GOOGLE(query, [type], [country])

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')

New SEARCH_LINKEDIN_PROFILE

Provide one or more job roles along with a company and get details from LinkedIn about people that match your query.

Syntax

SEARCH_PROFILES_LINKEDIN(role, company, [country], [exact_match])

Parameter Mandatory Description
role Yes The person or people you want. To add more than one role, use a semicolon (;) as a separator. For example: "CEO" or "product manager;engineering manager".
company Yes The company that the role needs to be in. For example: "Microsoft".
country No Localization of your search. For example: "de" returns responses from German-language LinkedIn site, "www" returns responses from the base site. If you leave it blank, it’ll return responses from all domains.
exact_match No Defines if you want to search exactly for the role you want or any combination of the words in the role to be in the LinkedIn profile title. Choose between:
-true (default) to get profiles that have exactly the role you’ve entered.
- false to get profiles that can have additional keywords within the role you’ve entered.

:memo: Note: If you choose true for exact_match, and you’re looking for Product Managers, you can get results for Senior Product Manager, Office of the Product Manager, and so on. However, if you set it to false, you’ll get results such as Product Office Manager, Product Engineering Manager, and so on.

Examples

To search for people who are Product Managers at Feedzai:

=SEARCH_PROFILES_LINKEDIN("Product Manager","Feedzai")

To search for Product Managers or Engineering Managers at Microsoft from the Australian LinkedIn site:

=SEARCH_PROFILES_LINKEDIN("Engineering Manager;Product Manager","Microsoft","au")

To search for people that have some version of Product Managers or Engineering Managers in their LinkedIn title that work at Microsoft:

=SEARCH_PROFILES_LINKEDIN("Product Manager;Engineering Manager","Microsoft",,false)

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