NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Zenserp connects to a Nagent workspace with an API key. Once it is connected, agents can call 12 Zenserp actions, such as "Get Shopping Product Details", "Get API Status" and "List Batches". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Zenserp, with input parameters and output schema.
ZENSERP_BING_SEARCHTool to obtain Bing search results. Use when you need real-time scraping of Bing SERPs from bing.com.
Input parameters
Search query; supports Bing operators
Two-letter country code (ISO 3166), e.g. 'US'
Latitude for geolocation override, e.g. '40.7128'
Longitude for geolocation override, e.g. '-74.0060'
Market code for the request (per Bing market codes)
Number of results to return (1-50)
Zero-based offset for pagination (skip this many results)
Canonical geolocation, e.g. 'New York,New York,United States'
Must be 'bing.com' to target Bing search
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ZENSERP_GET_SHOPPING_PRODUCTTool to retrieve detailed Google Shopping product page information by product_id. Use when you need comprehensive product details including pricing, reviews, specifications, and seller information for a specific product.
Input parameters
Country code for search results (e.g., 'us', 'fr').
Web interface language code (e.g., 'en' for English, 'fr' for French).
Geolocation used in the query. Use Google's canonical names for accurate results.
The PID (product id) from Google Shopping Search. Use this to fetch detailed product page information.
URL of the search engine to query. Override the default search engine domain.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ZENSERP_GET_STATUSTool to check the remaining API requests for your API key. Use when you need to verify your Zenserp API quota.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ZENSERP_GOOGLE_REVERSE_IMAGE_SEARCHTool to perform a reverse image search on Google. Use after obtaining a public image URL to find where the image appears online.
Input parameters
Number of results to return (1-100).
Zero-based offset for pagination.
Public URL of the image to reverse search.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ZENSERP_GOOGLE_SEARCHTool to perform a standard Google search via Zenserp. Use when you need structured SERP data for a given query.
Input parameters
Search query; supports full Google search operators.
Country code for geolocation (e.g., 'us', 'fr').
Google interface language code, e.g., 'en'.
Language filter prefixed with 'lang_', e.g., 'lang_fr'.
Latitude for geolocation query.
Longitude for geolocation query.
Number of search results to return (1-100).
Type of search: 'isch' for images, 'nws' for news, 'shop' for shopping, 'lcl' for maps, 'vid' for video.
Zero-based offset for pagination (use with num for pages).
Device to emulate: 'desktop' or 'mobile'.
Raw export format: 'html' or 'csv'.
Geolocation for the query (use canonical Google names or uule tokens).
Restrict results by timeframe: e.g., 'now 1-H', 'today 12-m'.
Override search engine URL (e.g., 'google.com' for Google, 'youtube.com' for YouTube search).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ZENSERP_GOOGLE_TRENDSTool to retrieve Google Trends data. Use when comparing keyword popularity over time.
Input parameters
Interface language code (optional), e.g., 'en'.
Category filter code (optional). Use numeric codes defined by Google Trends.
Geographic location code (optional), e.g., 'US'.
Property to compare (optional).
Keywords to compare in Google Trends. Provide as array 'keyword\[\]'.
Timeframe for trends data (optional).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ZENSERP_LIST_BATCHESTool to list all submitted batches for your Zenserp API key. Use when you need to retrieve batch processing status or history.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ZENSERP_LIST_COUNTRIESTool to get the list of supported Google country (gl) parameters. Use when you need to know valid country codes for geolocation.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ZENSERP_LIST_LANGUAGESTool to get a list of supported Google interface language (hl) parameters. Use when you need to find valid language codes for Google search queries.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ZENSERP_LIST_LOCATIONSTool to get a list of supported geo locations for search targeting. Use when you need to know which location parameters are available for geolocation queries.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ZENSERP_LIST_SEARCH_ENGINESTool to get the list of supported search engines that can be queried via Zenserp. Use when you need to determine which search engine domains are available for searches.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ZENSERP_YANDEX_SEARCHTool to obtain Yandex search results via Zenserp API. Use when you need programmatic access to Yandex search data after constructing a query.
Input parameters
Search query string
Geographic location code (ISO 3166-1 alpha-2), e.g., 'us', 'ru'
Language code for results, e.g., 'en', 'ru'
Number of results to return (1-100)
Type of search: 'isch' for images-only search
Device type to emulate: 'desktop' or 'mobile'
Search location, e.g., 'New York, USA'
Must be 'yandex.com' to target Yandex search
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 12 Zenserp actions on Nagent, including "Get Shopping Product Details", "Get API Status" and "List Batches". Get Shopping Product Details: Retrieve detailed Google Shopping product page information by product_id. Each action is listed on this page with its input parameters and its output.
Zenserp connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
Get Shopping Product Details takes 1 required input: product_id. It also takes 4 optional inputs: gl, hl, location and search_engine. It returns data, error and successful.