SearchApi through One
SearchApi is a search engine results API platform that provides structured data from Google, Bing, YouTube, Amazon, and other search engines, allowing developers to collect SERP, shopping, maps, and related search data for automation, analytics, and monitoring use cases.
One exposes SearchApi through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.
How to run an action
- Find the action in the table below, or call
search_one_platform_actions with platform search-api if it is not listed.
- Call
get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
- Call
execute_one_action with parameters copied from that knowledge.
Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.
Before you start
Call list_one_integrations once and confirm SearchApi is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.
Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.
Before a write
Creates, updates, deletes and sends land on a real SearchApi account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.
Actions
Search
| Action |
Method |
Path |
Action id |
| BestBuy Search |
GET |
/api/v1/search |
conn_mod_def::GMZz2907CjM::rR0YWxgxTeGAxzytG8em6g |
| Bing Copilot Search |
GET |
/api/v1/search |
conn_mod_def::GMZz282n_I8::RR6q54-zTGiloVkHx_eB4Q |
| Bing Shopping Search |
GET |
/api/v1/search |
conn_mod_def::GMZz3KN7Dxc::xh6s5CCZTQmAdRBla00SrA |
| Get YouTube Video Details |
GET |
/api/v1/search |
conn_mod_def::GMZz8P7SEws::tNE7qbolQvakShg67JByZw |
| Google AI Mode Search |
GET |
/api/v1/search |
conn_mod_def::GMZz4CH9OMc::FBhDAiTiTTSjIXFgfdYD0w |
| Google Events Search |
GET |
/api/v1/search |
conn_mod_def::GMZz4dLuW2E::Bp-SwNlLTrWQrRU-NrxSQA |
| Google Light Search |
GET |
/api/v1/search |
conn_mod_def::GMZz5MvvBo0::kjpKEvHqRWq7m3_MP4kF6A |
| Google Maps Directions Search |
GET |
/api/v1/search |
conn_mod_def::GMZz5NiCqBQ::QrbijvXPTyS01v8c_cbVeQ |
| Google Play Product Search |
GET |
/api/v1/search |
conn_mod_def::GMZz518gGOc::U0phBkmlSDewIoDvjdzxEQ |
| Google Rank Tracking Search |
GET |
/api/v1/search |
conn_mod_def::GMZz6LCdL1w::-bJos1NpTI-61PetRlCMqA |
| Google Scholar Cite Search |
GET |
/api/v1/search |
conn_mod_def::GMZz6SWeqY4::bG5cWYQeR62XMY-OE7BPAQ |
| Google Shopping Filters Search |
GET |
/api/v1/search |
conn_mod_def::GMZz6SyVo4E::oAaQm3g0T4qcRrKQc1fDdg |
28 more Search actions are available through search.
Account
| Action |
Method |
Path |
Action id |
| Get the Signed-in User Profile |
GET |
/api/v1/me |
conn_mod_def::GMZz18D0HmQ::bjwVS4_9TemifNB9MuHQ-A |
AirbnbExperienceDetails
| Action |
Method |
Path |
Action id |
| Get Airbnb Experience Details |
GET |
/api/v1/search |
conn_mod_def::GMZz18Xwp10::RlEDjeGPRmO6QcmP02_rRw |
AirbnbPropertyDetails
| Action |
Method |
Path |
Action id |
| Get Airbnb Property Details |
GET |
/api/v1/search |
conn_mod_def::GMZz192Ili8::nrcSQxUkStuFv8gcazhrWQ |
AirbnbExperiences
| Action |
Method |
Path |
Action id |
| Search Airbnb Experiences |
GET |
/api/v1/search |
conn_mod_def::GMZz1_SsXA0::LgG4gI57TDWu11L9ZqKJiw |
AmazonCategories
| Action |
Method |
Path |
Action id |
| Search Amazon Categories |
GET |
/api/v1/search |
conn_mod_def::GMZz2GspC18::EHn2LvtfR62XiCIYLwtuvw |
AirbnbPropertyReviews
| Action |
Method |
Path |
Action id |
| Search Airbnb Property Reviews |
GET |
/api/v1/search |
conn_mod_def::GMZz2HuT4gU::QKwuJAkoScKsnW3TCET5HQ |
AmazonOffers
| Action |
Method |
Path |
Action id |
| Search Amazon Offers |
GET |
/api/v1/search |
conn_mod_def::GMZz2H1x7Rc::_6xv9swmS0S9YtgaqoHjeg |
AmazonBestsellers
| Action |
Method |
Path |
Action id |
| Search Amazon Bestsellers |
GET |
/api/v1/search |
conn_mod_def::GMZz2Jnqrs4::Vgw7sIXcSN-UibYv8Brerw |
AirbnbProperties
| Action |
Method |
Path |
Action id |
| Search Airbnb Properties |
GET |
/api/v1/search |
conn_mod_def::GMZz2KE0ftI::Jyi6wTKBQ0KkvqQG-n7Giw |
AmazonProduct
| Action |
Method |
Path |
Action id |
| Search Amazon Product |
GET |
/api/v1/search |
conn_mod_def::GMZz2aCgZms::xp3DjI-oQ52FTemDyDDLRA |
AppleAppStoreTopCharts
| Action |
Method |
Path |
Action id |
| Search Apple App Store Top Charts |
GET |
/api/v1/search |
conn_mod_def::GMZz2ax_lnQ::C4CbdiLuQy2pO-oSSzhVlA |
AppleAppStoreSearch
| Action |
Method |
Path |
Action id |
| Search the Apple App Store |
GET |
/api/v1/search |
conn_mod_def::GMZz2bTSGd0::TzE0WCfsSU20vN0dz2HGbQ |
AmazonSearch
| Action |
Method |
Path |
Action id |
| Search Amazon |
GET |
/api/v1/search |
conn_mod_def::GMZz2bbhd9I::1Uem4pF_SVik32Qd0Ea0rQ |
AppleMapsGuides
| Action |
Method |
Path |
Action id |
| Get Apple Maps Guides |
GET |
/api/v1/search |
conn_mod_def::GMZz2bkg400::Bhi3u2gkRdOzzDegV71eng |
AppleProductReviews
| Action |
Method |
Path |
Action id |
| Search Apple Product Reviews |
GET |
/api/v1/search |
conn_mod_def::GMZz2qq2qtw::cFJPEG6zS3u7n_fRaRsDCg |
AppleMapsPlaces
| Action |
Method |
Path |
Action id |
| Search Apple Maps Places |
GET |
/api/v1/search |
conn_mod_def::GMZz2rBGR2c::ITE2FXc_TXibpzwTo6gblw |
AppleProductSearch
| Action |
Method |
Path |
Action id |
| Apple Product Search |
GET |
/api/v1/search |
conn_mod_def::GMZz2sHIm1M::1oVLoSoXTxKqEUoX-kVReg |
AppleMapsSearch
| Action |
Method |
Path |
Action id |
| Search Apple Maps |
GET |
/api/v1/search |
conn_mod_def::GMZz2s0oA-o::TDd4S4Q2TR2nEcmlS2yzNA |
BestBuyProductSearch
| Action |
Method |
Path |
Action id |
| BestBuy Product Search |
GET |
/api/v1/search |
conn_mod_def::GMZz28LnSpc::Og59W-oESwKCk5NmCXP2xw |
DuckDuckGoImages
| Action |
Method |
Path |
Action id |
| Search DuckDuckGo Images |
GET |
/api/v1/search |
conn_mod_def::GMZz3Kki-pE::11Yk5B9RRnSz1pzpPql7dA |
SearchBingVideos
| Action |
Method |
Path |
Action id |
| Search Bing Videos |
GET |
/api/v1/search |
conn_mod_def::GMZz3LOp10c::NXwxqS01Q86GfL12B7eyhw |
BingProductPage
| Action |
Method |
Path |
Action id |
| Get a Bing Product Page |
GET |
/api/v1/search |
conn_mod_def::GMZz3MVMZMs::WCSOU_MDS-2r2D9MxT7Elw |
DuckDuckGoVideos
| Action |
Method |
Path |
Action id |
| Search DuckDuckGo Videos |
GET |
/api/v1/search |
conn_mod_def::GMZz3bP8JRs::80PjstYKSvKymW7kJ3Wg2Q |
SearchEbayProductDetails
| Action |
Method |
Path |
Action id |
| Search eBay Product Details |
GET |
/api/v1/search |
conn_mod_def::GMZz3cISMuo::iUR42t16RR6LjRUGnDPkHg |
FacebookBusinessPageAboutSection
| Action |
Method |
Path |
Action id |
| Get a Facebook Business Page About Section |
GET |
/api/v1/search |
conn_mod_def::GMZz3rzzYR4::8z2GgRxKSFOKPj5W3pLLrg |
AboutThisDomainData
| Action |
Method |
Path |
Action id |
| Get About This Domain Data |
GET |
/api/v1/search |
conn_mod_def::GMZz3t4a-yA::idSlE458TGu1dPPQ23bdUg |
AboutThisStoreData
| Action |
Method |
Path |
Action id |
| Get About This Store Data |
GET |
/api/v1/search |
conn_mod_def::GMZz3ut_c3I::BkEVs_hgSvyw6CakIfyuhw |
FacebookBusinessPageReviews
| Action |
Method |
Path |
Action id |
| Get Facebook Business Page Reviews |
GET |
/api/v1/search |
conn_mod_def::GMZz34GwErA::R5nGL-4GSUeWhJJDxErh5w |
GoogleAdsTransparencyCenterAdDetails
| Action |
Method |
Path |
Action id |
| Search Google Ads Transparency Center Ad Details |
GET |
/api/v1/search |
conn_mod_def::GMZz4BQiXHs::hXNGn5CwSD68J0mQS7n8gA |
GoogleAdsTransparencyCenterAdvertisers
| Action |
Method |
Path |
Action id |
| Search Google Ads Transparency Center Advertisers |
GET |
/api/v1/search |
conn_mod_def::GMZz4Dgh-xU::iuWRoSidRg2YQ6J3OoT5DQ |
GoogleAdsTransparencyCenterSearch
| Action |
Method |
Path |
Action id |
| Search Google Ads Transparency Center |
GET |
/api/v1/search |
conn_mod_def::GMZz4EPWJ_w::ehGwDapmShaEYyuMkU7GRw |
GoogleBooks
| Action |
Method |
Path |
Action id |
| Search Google Books |
GET |
/api/v1/search |
conn_mod_def::GMZz4cFA5j0::LjcQ0cwJQj20TGh23lUjOw |
GoogleFinance
| Action |
Method |
Path |
Action id |
| Search Google Finance |
GET |
/api/v1/search |
conn_mod_def::GMZz4dLFay0::A45rd8RfSLiQ_ZThnl-iuA |
GoogleFlightsCalendar
| Action |
Method |
Path |
Action id |
| Search Google Flights Calendar |
GET |
/api/v1/search |
conn_mod_def::GMZz4hjNuKU::9CYjKK-GQrKkhcdwnGi4Rw |
GoogleFlightsSearch
| Action |
Method |
Path |
Action id |
| Google Flights Search |
GET |
/api/v1/search |
conn_mod_def::GMZz4qRghjI::Vjct0LPDSwSlUfBrodbCqQ |
GoogleForumsSearch
| Action |
Method |
Path |
Action id |
| Search Google Forums |
GET |
/api/v1/search |
conn_mod_def::GMZz4ryY_J0::KuSoagkvQ3aw9DdP6n846g |
GoogleHotelsPropertyDetails
| Action |
Method |
Path |
Action id |
| Get Google Hotels Property Details |
GET |
/api/v1/search |
conn_mod_def::GMZz4tUOw1U::PbNFrgFuTPGFYuvF7ZA7GQ |
GoogleFlightsLocations
| Action |
Method |
Path |
Action id |
| Search Google Flights Locations |
GET |
/api/v1/search |
conn_mod_def::GMZz4zUz1_8::2-aV3d2ZSCWJsc_RjIj7ig |
SearchResults
| Action |
Method |
Path |
Action id |
| Search Google Images |
GET |
/api/v1/search |
conn_mod_def::GMZz49MEyvw::2xNNiUSzTvGyKvA-xZW12g |
GoogleJobs
| Action |
Method |
Path |
Action id |
| Search Google Jobs |
GET |
/api/v1/search |
conn_mod_def::GMZz4-cWQtU::YzQrvTagR1ylw0gEThIVpw |
GoogleHotels
| Action |
Method |
Path |
Action id |
| Search Google Hotels |
GET |
/api/v1/search |
conn_mod_def::GMZz5C15t4A::0D0XuD_xQuyoVMBENOaBLA |
GoogleMapsPhotos
| Action |
Method |
Path |
Action id |
| Google Maps Photos Search |
GET |
/api/v1/search |
conn_mod_def::GMZz5LIovKA::4UmkN2yaQKSCd5HXf6Mpag |
GoogleLocalResults
| Action |
Method |
Path |
Action id |
| Search Google Local Results |
GET |
/api/v1/search |
conn_mod_def::GMZz5MzlZjY::CE-Q0xTJSI-AqbxJOngd5w |
SearchGoogleMaps
| Action |
Method |
Path |
Action id |
| Search Google Maps |
GET |
/api/v1/search |
conn_mod_def::GMZz5XV_7Cc::D2FbpaVdQYuq6YNoBPtkbw |
SearchGoogleNewsLight
| Action |
Method |
Path |
Action id |
| Search Google News Light |
GET |
/api/v1/search |
conn_mod_def::GMZz5YNqfJI::cInwMHoGT4WAbq4iTPYh0w |
GoogleNewsPortal
| Action |
Method |
Path |
Action id |
| Search Google News Portal |
GET |
/api/v1/search |
conn_mod_def::GMZz5Yb6H8U::xDQFcKaVR1mjIHgEL4Puiw |
GoogleMapsReviews
| Action |
Method |
Path |
Action id |
| Search Google Maps Reviews |
GET |
/api/v1/search |
conn_mod_def::GMZz5b8lb2w::sRwtc7b5TkqpkY1OUFreQQ |
GoogleMapsPlaceDetails
| Action |
Method |
Path |
Action id |
| Get Google Maps Place Details |
GET |
/api/v1/search |
conn_mod_def::GMZz5qXIzqI::LYf8SmrfQ_eZ6_K916jMSw |
GoogleNewsSearch
| Action |
Method |
Path |
Action id |
| Search Google News |
GET |
/api/v1/search |
conn_mod_def::GMZz5zWxf7w::kUcSRXYjR-ucVrkPyPBLGw |
GooglePatentsDetails
| Action |
Method |
Path |
Action id |
| Get Google Patents Details |
GET |
/api/v1/search |
conn_mod_def::GMZz50Q8nd4::k_UaZi3XSkiNq-jeozgCnA |
GooglePatents
| Action |
Method |
Path |
Action id |
| Search Google Patents |
GET |
/api/v1/search |
conn_mod_def::GMZz50nkt04::XQwmgXYJQjCuiD7um1x21w |
GooglePlace
| Action |
Method |
Path |
Action id |
| Search Google Place |
GET |
/api/v1/search |
conn_mod_def::GMZz51O1l-4::g7RvFwhvSiyj_kimevHGkQ |
GooglePlayStoreSearch
| Action |
Method |
Path |
Action id |
| Search Google Play Store |
GET |
/api/v1/search |
conn_mod_def::GMZz5-Atp8o::T92uswTtS46y7tcYxqavGQ |
GoogleProductSearchResults
| Action |
Method |
Path |
Action id |
| Get Google Product Search Results |
GET |
/api/v1/search |
conn_mod_def::GMZz5-nRY3s::yPP_r0mSQ56e6S-uymbhLA |
GoogleProductReviews
| Action |
Method |
Path |
Action id |
| Search Google Product Reviews |
GET |
/api/v1/search |
conn_mod_def::GMZz5-zPghs::3noIzABSSZmYoSryUmL72g |
ProductOffers
| Action |
Method |
Path |
Action id |
| Google Product Offers Search |
GET |
/api/v1/search |
conn_mod_def::GMZz5_pZf50::_8TUkQmERD6ZHHPCScQHqw |
GoogleProductPage
| Action |
Method |
Path |
Action id |
| Retrieve Google Product Page Data |
GET |
/api/v1/search |
conn_mod_def::GMZz6BQlkPo::4VnE1FtBRsqdCWo5Nasm0w |
GoogleScholarAuthors
| Action |
Method |
Path |
Action id |
| Search Google Scholar Authors |
GET |
/api/v1/search |
conn_mod_def::GMZz6JXRBzc::K1EL-099RPKKTTkL8L-w5w |
GoogleProductSpecifications
| Action |
Method |
Path |
Action id |
| Get Google Product Specifications |
GET |
/api/v1/search |
conn_mod_def::GMZz6JvNzGY::H9DgFPYhTwe4iBJ0BrN0Qg |
RelatedQuestions
| Action |
Method |
Path |
Action id |
| Search Google Related Questions |
GET |
/api/v1/search |
conn_mod_def::GMZz6JwATTM::nrDE6X7oQ9el-_zAVotLkQ |
GoogleScholarCaseLaw
| Action |
Method |
Path |
Action id |
| Search Google Scholar Case Law |
GET |
/api/v1/search |
conn_mod_def::GMZz6J5IZTE::BJgxlDr0TE-mCX5BYuTiTg |
GoogleShoppingSearch
| Action |
Method |
Path |
Action id |
| Search Google Shopping |
GET |
/api/v1/search |
conn_mod_def::GMZz6UCnhQg::q2UtepBlT52v8VjarXvxmA |
GoogleScholarSearch
| Action |
Method |
Path |
Action id |
| Search Google Scholar |
GET |
/api/v1/search |
conn_mod_def::GMZz6UD5NrQ::Gag1TPjGQveIo0-NhR-gIA |
GoogleTrends
| Action |
Method |
Path |
Action id |
| Search Google Trends |
GET |
/api/v1/search |
conn_mod_def::GMZz6dZYiJ4::-pn9YlJGQcS-yRlV0WJjqg |
GoogleShorts
| Action |
Method |
Path |
Action id |
| Search Google Shorts |
GET |
/api/v1/search |
conn_mod_def::GMZz6eeLQUk::kdrnfcdzQxWrQesONyzEQw |
GoogleTrendsTrendingNow
| Action |
Method |
Path |
Action id |
| Search Google Trends Trending Now |
GET |
/api/v1/search |
conn_mod_def::GMZz6ox5p1g::ZSdbUTrHS46VL7EWKz5kXg |
SearchGoogle
| Action |
Method |
Path |
Action id |
| Search Google |
GET |
/api/v1/search |
conn_mod_def::GMZz6pJI3So::DoZEHNv5Q6aOOE0S6KWaPw |
GoogleVideosLightSearch
| Action |
Method |
Path |
Action id |
| Search Google Videos Light |
GET |
/api/v1/search |
conn_mod_def::GMZz6qpU71M::JkEdoGuqR_W8ASQx32y0nw |
This lists 80 of 135 actions. For anything not here, call search_one_platform_actions with platform search-api. The full catalog is at https://www.withone.ai/knowledge/search-api.
When a call fails
The error comes from SearchApi, not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed.
Full catalog: https://www.withone.ai/knowledge/search-api
Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.
withoneai