2iWfddlZddlZddlmZddlmZdZdZdZdZ dZ d Z d Z d Z d ZGd deZy)N Pagination)SerpApiClientExceptiongooglebingbaidugoogle_scholaryandexebayyahoo home_depotyoutubeceZdZdZdZdZddZddZddZddZ dZ d Z d Z d Z d Zd ZdZddZdZddZddZy) SerpApiClientaSerpApiClient enables to query any search engines supported by SerpApi and parse the results. ```python from serpapi import GoogleSearch search = SerpApiClient({ "q": "Coffee", "location": "Austin,Texas", "engine": "google", "api_key": "" }) data = search.get_json() ``` https://serpapi.com/search-api zhttps://serpapi.comNc.||_||_||_yN) params_dictenginetimeout)selfrrrs _/var/www/html/marco-python-backend/venv/lib/python3.12/site-packages/serpapi/serp_api_client.py__init__zSerpApiClient.__init__#s&  c8d|jd<|jr|j|jd<|jr'd|jvr|j|jd<d|jvr td|j|z|jfS)Npythonsource serp_api_keyrz/engine must be defined in params_dict or engine)r SERP_API_KEYrrBACKENDrpaths r construct_urlzSerpApiClient.construct_url(s%-"   /3/@/@D  ^ , ;;t///-1[[  *4+++()Z[ [||d"D$4$444rcd} |j|\}}tj|||j}|S#tj$r5}t d|zt ||j j|d}~wwxYw)zFReturns: Response object provided by requests.get N)rzfail: )r"requestsgetr HTTPErrorprintresponse status_code)rr!url parameterr(es r get_responsezSerpApiClient.get_response3sx !//5NC||CDLLIHO!!  (S. ! !QZZ++ ,G s7<B0A??Bc8|j|jS)z1Returns: Response text field )r-textr s r get_resultszSerpApiClient.get_resultsBs  &+++rc"|jS)zAReturns: Raw HTML search result from Gooogle )r0rs rget_htmlzSerpApiClient.get_htmlHs!!rcfd|jd<tj|jS)zNReturns: Formatted JSON search results using json package jsonoutput)rr5loadsr0r2s rget_jsonzSerpApiClient.get_jsonNs,&,"zz$**,--rc@d|jd<|jS)zDReturns: Formatted JSON search result as string r5r6)rr0r2s r get_raw_jsonzSerpApiClient.get_raw_jsonUs#&,"!!rc4t|jS)zFReturns: Dict with the formatted response content )dictr8r2s rget_dictionaryzSerpApiClient.get_dictionary\sDMMO$$rc"|jS)zmReturns: Dict with the formatted response content (alias for get_dictionary) )r=r2s rget_dictzSerpApiClient.get_dictbs ""$$rcF|j}|jd|S)zcReturns: Dynamically created python object wrapping the result data structure r()r= make_pyobj)rnodes r get_objectzSerpApiClient.get_objectis# ""$z400rc ^t|tfi}|}t|trAt ||g|D]-}t ||j |j||/|St|tr|jD]\}}t|tr@t ||g|D]-}t ||j |j||/Vt|trt |||j||t ||||St ||||Sr) typeobject isinstancelistsetattrgetattrappendrAr<items)rnamerBpytypepyobjelchilds rrAzSerpApiClient.make_pyobjrsdVJ+ dD ! E4 $ Gt$++DOOD",EF GL d ##zz| 0 eeT*E4,#Ot,33DOOD"4MNOt,E4u)EFE4/ 0  E4 & rc||jdj||}|dk(rtj|}|S)a3Retrieve search result from the Search Archive API Parameters: search_id (int): unique identifier for the search provided by metadata.id format (string): search format: json or html [optional] Returns: dict|string: search result from the archive z/searches/{0}.{1}r5)r0formatr5r7)r search_idrSresults rget_search_archivez SerpApiClient.get_search_archives=!!"5"<"rusN )D   (    a7Fa7r