Google Search
Authentication Type: API Key
Description: Google Custom Search API for performing web searches using a configured search engine.
Web Search
Perform web searches using Google Custom Search API with customizable parameters.
Search Web
Search the web using Google Custom Search. Requires a Custom Search Engine ID (cx) and supports various filtering options like language, country, date restrictions, and content types. Returns up to 10 results per request with title, snippet, URL, and metadata.
Operation Type: Query (Read)
Parameters:
- q
string
(required): Search query - the terms to search for - cx
string
(required): Custom Search Engine ID - identifies which search engine to use. Defaults to "230935ee073314dc5" - num
number
(nullable): Number of search results to return (1-10, default 10) - start
number
(nullable): Index of the first result to return (1-based, max 91 for 10 results per page) - lr
string
(nullable): Language restrict - restricts search to documents in a particular language - safe
string
(nullable): Safe search setting - filters explicit content when active. Options: "active", "off" - cr
string
(nullable): Country restrict - restricts search to documents from a particular country - dateRestrict
string
(nullable): Date restrict - restricts results to a particular time period (e.g., "d1" for past day) - exactTerms
string
(nullable): Exact terms that must appear in the search results - excludeTerms
string
(nullable): Terms to exclude from search results - fileType
string
(nullable): File type to restrict results to (e.g., "pdf", "doc") - filter
string
(nullable): Filter duplicate content - "1" to filter, "0" to include duplicates - gl
string
(nullable): Geolocation of end user - helps return region-appropriate results - hl
string
(nullable): Interface language - language for the search interface - orTerms
string
(nullable): Additional search terms with OR logic - relatedSite
string
(nullable): Site to find related pages for - rights
string
(nullable): Licensing filter - filters results by usage rights - searchType
string
(nullable): Search type - set to null for web search, set to "image" for image search - siteSearch
string
(nullable): Site to search within - restricts results to a specific site - siteSearchFilter
string
(nullable): Include ("i") or exclude ("e") the siteSearch parameter - sort
string
(nullable): Sort expression for ordering results
Returns:
- kind
string
: The type of search performed - url
object
(nullable): URL template information- type
string
: URL type - template
string
: URL template
- type
- queries
object
(nullable): Information about the current and related queries- request
array of objects
(nullable): Current query information - nextPage
array of objects
(nullable): Next page query information - previousPage
array of objects
(nullable): Previous page query information
- request
- context
object
(nullable): Context information about the search engine- title
string
: Search engine title - facets
array
(nullable): Search facets
- title
- searchInformation
object
(nullable): Information about the search- searchTime
number
: Time taken to perform the search in seconds - formattedSearchTime
string
: Formatted search time for display - totalResults
string
: Total number of search results - formattedTotalResults
string
: Formatted total results for display
- searchTime
- items
array of objects
(nullable): Array of search results- kind
string
: Result type - title
string
: The title of the search result - htmlTitle
string
: The title with HTML formatting - link
string
: The URL of the search result - displayLink
string
: The display URL - snippet
string
: A snippet of text from the page - htmlSnippet
string
: The snippet with HTML formatting - formattedUrl
string
: The formatted URL for display - htmlFormattedUrl
string
: The formatted URL with HTML - pagemap
object
(nullable): Structured data from the page - image
object
(nullable): Image information if this is an image search result
- kind
- spelling
object
(nullable): Spelling correction suggestions- correctedQuery
string
: Corrected query - htmlCorrectedQuery
string
: Corrected query with HTML formatting
- correctedQuery
- promotions
array
(nullable): Promoted search results
Example Usage:
{
"q": "artificial intelligence machine learning trends 2024",
"cx": "230935ee073314dc5",
"num": 10,
"start": 1,
"lr": "lang_en",
"safe": "active",
"cr": "countryUS",
"dateRestrict": "m1",
"exactTerms": null,
"excludeTerms": "cryptocurrency bitcoin",
"fileType": null,
"filter": "1",
"gl": "us",
"hl": "en",
"orTerms": "deep learning neural networks",
"relatedSite": null,
"rights": null,
"searchType": null,
"siteSearch": null,
"siteSearchFilter": null,
"sort": null
}
Common Use Cases
Research and Information Gathering:
- Search for academic papers and technical documentation using file type filters
- Find recent news and articles with date restrictions for timely research
- Exclude irrelevant terms to refine search results for specific topics
Content Discovery:
- Search within specific websites using siteSearch parameter for targeted content
- Use language and country restrictions to find region-specific information
- Find related pages and similar content using relatedSite parameter
Competitive Analysis:
- Monitor competitor mentions and industry trends with targeted queries
- Search for specific licensing and usage rights for content research
- Use exact terms to find specific mentions of brands or products
Development and Integration:
- Integrate search functionality into applications using Custom Search Engine
- Implement pagination with start parameter for large result sets
- Use safe search and content filtering for family-friendly applications