Actions5
- Crawler Actions
- Deep SerpApi Actions
- Universal Scraping API Actions
Overview
The node "Scrapeless Official" provides access to multiple scraping-related APIs, including a Deep SerpApi for Google search data extraction. Specifically, the Google Search operation under the Deep SerpApi resource allows users to perform automated Google searches and retrieve structured search results programmatically.
This node is beneficial when you want to:
- Automate Google search queries and extract search result data without manual browsing.
- Integrate Google search data into workflows for SEO analysis, market research, or competitive intelligence.
- Retrieve localized or language-specific search results by customizing parameters like country, language, and domain.
- Paginate through search results or filter them based on advanced Google search parameters.
Practical examples:
- Automatically fetch the top 10 Google search results for a keyword in English from the US domain.
- Perform image or news searches by specifying the search type parameter.
- Limit search results to specific countries or languages for targeted marketing campaigns.
- Extract Google My Business or Knowledge Graph information using place or graph IDs.
Properties
| Name | Meaning |
|---|---|
| Search Query (q) | The search query string, supporting regular Google search syntax and advanced operators (e.g., inurl:, site:, intitle:). |
| Language (hl) | Two-letter language code to specify the language of the search (default: "en"). Examples: "en" for English, "es" for Spanish. |
| Country (gl) | Two-letter country code to specify the country context of the search (default: "us"). Examples: "us" for United States, "uk" for United Kingdom. |
| Domain (google_domain) | Google domain to use for the search (default: "google.com"). Options include many country-specific Google domains like "google.co.uk", "google.fr", etc. |
| Location (location) | Text specifying the geographic location from which the search should originate. Should be at city level for best simulation. Cannot be used with the uule parameter. |
| Result Offset (start) | Number of results to skip, used for pagination. Default is 0 (first page). For example, 10 skips first page, showing second page results. |
| Number of Results (num) | Maximum number of results to return. Defaults to 10; can be increased up to 100. |
| Google Place ID (ludocid) | Google My Business listing ID to scrape specific business information. |
| Google Knowledge Graph ID (kgmid) | Google Knowledge Graph entity ID to scrape knowledge graph data. Overrides most other parameters except pagination. |
| Google Element Rendering (ibp) | Controls rendering and expansion of certain elements in the results, e.g., expanded knowledge graph layouts. |
| Set Multiple Countries (cr) | Limits search to one or more countries using country codes separated by ` |
| Set Multiple Languages (lr) | Limits search to one or more languages using language codes separated by ` |
| Advanced Search Parameters (tbs) | Additional advanced search filters not possible in the main query, such as filtering by patents, dates, news, videos, images, apps, or text content. |
| Safe Search Filtering (safe) | Level of adult content filtering: "active" (default, filters explicit content) or "off" (no filtering). |
| Exclude Auto-corrected Results (nfpr) | Whether to exclude results from auto-corrected queries when the original query was misspelled. "1" excludes, "0" includes (default). May not always prevent auto-corrected results if no others exist. |
| Results Filtering (filter) | Enables or disables filters for "Similar Results" and "Omitted Results". "1" enables filters (default), "0" disables. |
| Search Type (tbm) | Defines the type of Google search: regular (empty), images (isch), local (lcl), news (nws), shopping (shop), videos (vid), patents (pts), or other Google services. |
Output
The node outputs JSON data containing the structured results of the Google search query. The exact structure depends on the search type and parameters but generally includes:
- Search results with titles, URLs, snippets, and metadata.
- Optional sections like knowledge graph data, local business info, images, videos, or news items depending on the search type.
- Pagination information reflecting the offset and total results.
- If applicable, expanded elements controlled by parameters like
ibp.
Binary data output is not indicated for this operation.
Dependencies
- Requires an API key credential for the Scrapeless service that provides access to the Deep SerpApi.
- Network connectivity to the Scrapeless API endpoint.
- Proper configuration of the API key credential within n8n.
Troubleshooting
Common issues:
- Invalid or missing API key credential will cause authentication errors.
- Incorrect or unsupported parameter values may lead to empty or error responses.
- Using mutually exclusive parameters together (e.g.,
locationanduule) may cause request failures. - Exceeding rate limits or quota on the Scrapeless API can result in throttling or errors.
Error messages:
- Authentication errors: Verify that the API key credential is correctly set and active.
- Parameter validation errors: Check that all required parameters are provided and valid.
- Empty results: Confirm the query and filters are correct; try broadening search parameters.
- Network or timeout errors: Ensure stable internet connection and Scrapeless API availability.