firSrSSKrSSKrSSKrSSKrSSKrSSKJr SSKJ r SSK J r \RRR5 \ "SS5rg!\a Nf=f!\a \rN!f=f) zm shodan.client ~~~~~~~~~~~~~ This module implements the Shodan API. :copyright: (c) 2014- by John Matherly N)APIError)create_facet_string)Streamc\rSrSrSr"SS5r"SS5r"SS5r"S S 5r"S S 5r "S S5r "SS5r "SS5r S4Sjr S5SjrS4SjrS6SjrSrSrSrS7SjrS8SjrSrSrS9SjrS:S jrS!rS"rS#rS$rS;S%jrS8S&jrSS*jr#S+r$S,r%S-r&S.r'S4S/jr(S0r)S1r*S2r+S3r,g)?Shodan)aoWrapper around the Shodan REST and Streaming APIs :param key: The Shodan API key that can be obtained from your account page (https://account.shodan.io) :type key: str :ivar exploits: An instance of `shodan.Shodan.Exploits` that provides access to the Exploits REST API. :ivar stream: An instance of `shodan.Shodan.Stream` that provides access to the Streaming API. c&\rSrSrSrSrSrSrg) Shodan.Data2cXlgNparentselfrs R/home/gothic/public_html/Scylla/venv/lib/python3.13/site-packages/shodan/client.py__init__Shodan.Data.__init__4 Kc:URRS05$)zReturns a list of datasets that the user has permission to download. :returns: A list of objects where every object describes a dataset z /shodan/datar_requestrs r list_datasetsShodan.Data.list_datasets7s ;;''; ;rcXURRSRU505$)zReturns a list of files that belong to the given dataset. :returns: A list of objects where each object contains a 'name', 'size', 'timestamp' and 'url' z/shodan/data/{}rrformat)rdatasets r list_filesShodan.Data.list_files>s' ;;''(9(@(@(I2N NrrN)__name__ __module__ __qualname____firstlineno__rrr"__static_attributes__rrDatar 2s ! < Orr*c$\rSrSrSrSSjrSrg) Shodan.DnsEcXlgrrrs rrShodan.Dns.__init__GrrNcSU0nU(aX%S'U(aX5S'URRSRU5U5$)z3Grab the DNS information for a domain. pagehistorytypez/dns/domain/{}r)rdomainr2r3r1argss r domain_infoShodan.Dns.domain_infoJsID")Y#V ;;''(8(?(?(GN Nrr)FNr)r$r%r&r'rr6r(r)rrDnsr,Es  ! Orr8cB\rSrSrSrS SjrSrSrSrSr S r S r g) Shodan.NotifierVcXlgrrrs rrShodan.Notifier.__init__XrrNcVXS'U(aX2S'URRSUSS9$)aCGet the settings for the specified notifier that a user has configured. :param provider: Provider name :type provider: str :param args: Provider arguments :type args: dict :param description: Human-friendly description of the notifier :type description: str :returns: dict -- fields are 'success' and 'id' of the notifier provider description /notifierpostmethodr)rr?r5r@s rcreateShodan.Notifier.create[s3 ( &1]#;;'' T&'I IrcVURRSRU5USS9$)zGet the settings for the specified notifier that a user has configured. :param nid: Notifier ID :type nid: str :param args: Provider arguments :type args: dict :returns: dict -- fields are 'success' and 'id' of the notifier /notifier/{}putrCr)rnidr5s reditShodan.Notifier.editms,;;''(=(=c(BDQV'W WrcXURRSRU505$)zGet the settings for the specified notifier that a user has configured. :param nid: Notifier ID :type nid: str :returns: dict -- object describing the notifier settings rHrrrJs rgetShodan.Notifier.getxs&;;''(=(=c(BBG Grc:URRS05$)zwReturns a list of notifiers that the user has added. :returns: A list of notifierse that are available on the account rArrs rlist_notifiersShodan.Notifier.list_notifierss ;;'' R8 8rc:URRS05$)zzReturns a list of supported notification providers. :returns: A list of providers where each object describes a provider z/notifier/providerrrs rlist_providersShodan.Notifier.list_providerss ;;''(RAS5(a%[<R>RAS5Ulgg) zInitializes the API object. :param key: The Shodan API key. :type key: str :param proxies: A proxies array for the requests library, e.g. {'https': 'your proxy'} :type proxies: dict zhttps://api.shodan.iozhttps://exploits.shodan.iozhttps://trends.shodan.io)proxiesrNFSHODAN_API_URL)!api_keybase_urlbase_exploits_urlbase_trends_urlr*datar8dnsrxrmrrrlabsr[notifierrorgrdtoolsrstreamrequestsSession_sessionapi_rate_limit_api_query_timerupdate trust_envosenvironrO)rkeyrs rrShodan.__init__&s  / !=9IIdO 88D> d+ kk$' IIdO  d+ $$T*ZZ% S2  ((* #  MM ! ! ( ( 1&+DMM # ::>>* + +JJNN+;Jx }}1:>>rc[U[5(aU/n0nU(aX$S'U(aX4S'URSRSR U55U5$)asGet all available information on an IP. :param ip: IP of the computer :type ip: str :param history: (optional) True if you want to grab the historical (non-current) banners for the host, False otherwise. :type history: bool :param minify: (optional) True to only return the list of ports and the general host information, no banners, False otherwise. :type minify: bool r2minifyz/shodan/host/{},) isinstance basestringrr join)ripsr2rrs rhost Shodan.hostsX c: & &%C  '9  %8 }}.55chhsmDfMMrc&URS05$)zReturns information about the current API key, such as a list of add-ons and other features that are enabled for the current user's API plan. z /api-inforrs rr Shodan.infos}}["--rc&URS05$)zhGet a list of ports that Shodan crawls :returns: An array containing the ports that Shodan crawls for. z /shodan/portsrrs rports Shodan.portss }}_b11rc&URS05$)zGet a list of protocols that the Shodan on-demand scanning API supports. :returns: A dictionary containing the protocol name and description. z/shodan/protocolsrrs r protocolsShodan.protocolss }}0"55rc[U[5(aU/n[U[5(a[R"U5nOSR U5nUUS.nUR SUSS9$)aScan a network using Shodan :param ips: A list of IPs or netblocks in CIDR notation or an object structured like: { "9.9.9.9": [ (443, "https"), (8080, "http") ], "1.1.1.0/24": [ (503, "modbus") ] } :type ips: str or dict :param force: Whether or not to force Shodan to re-scan the provided IPs. Only available to enterprise users. :type force: bool :returns: A dictionary with a unique ID to check on the scan progress, the number of IPs that will be crawled and how many scan credits are left. r)rforcez /shodan/scanrBrC)rrrrrrr)rrrnetworksrs rscan Shodan.scanse& c: & &%C c4 zz#Hxx}H  }}^VF}CCrc*URSSU05$)zqGet a list of scans submitted :param page: Page through the list of scans 100 results at a time :type page: int z /shodan/scansr1r)rr1s rscans Shodan.scanss! }}_ D/   rc.UUS.nURSUSS9$)aScan a network using Shodan :param port: The port that should get scanned. :type port: int :param port: The name of the protocol as returned by the protocols() method. :type port: str :returns: A dictionary with a unique ID to check on the scan progress. )portprotocolz/shodan/scan/internetrBrCr)rrrrs r scan_internetShodan.scan_internets)   }}4fV}LLrcDURSRU505$)zGet the status information about a previously submitted scan. :param id: The unique ID for the scan that was submitted :type id: str :returns: A dictionary with general information about the scan, including its status in getting processed. z/shodan/scan/{}rr )rscan_ids r scan_statusShodan.scan_status s!}}.55g>CCrcUUS.nU(aX8S'U(aXHS'OX(S'U(a[U5US'U(a)[U[5(aSRU5US'UR SU5$) aSearch the SHODAN database. :param query: Search query; identical syntax to the website :type query: str :param page: (optional) Page number of the search results :type page: int :param limit: (optional) Number of results to return :type limit: int :param offset: (optional) Search offset to begin getting results from :type offset: int :param facets: (optional) A list of properties to get summary information on :type facets: str :param minify: (optional) Whether to minify the banner and only return the important data :type minify: bool :param fields: (optional) List of properties that should get returned. This option is mutually exclusive with the "minify" parameter :type fields: str :returns: A dictionary with 2 main items: matches and total. If facets have been provided then another property called "facets" will be available at the top-level of the dictionary. Visit the website for more detailed information. )rkrlimitoffsetr1rlrfieldsz/shodan/host/search)rrlistrr) rrkr1rrrlrrr5s rrr Shodan.searchss*  !M!'XL 08DN j.. XXf-DN}}2D99rc## SnSnSnURXXTS9nUS(a%[[R"USS- 55nUSHn U v M US- nXV::a1URXXTS9nUSHn U v M US- nSnXV::aM0gg![a  gf=f![a  gf=f![ a= Xs:a[ SRU55eUS- n[R"U5 Nqf=f7f) aSearch the SHODAN database. This method returns an iterator that can directly be in a loop. Use it when you want to loop over all of the results of a search query. But this method doesn't return a "matches" array or the "total" information. And it also can't be used with facets, it's only use is to iterate over results more easily. :param query: Search query; identical syntax to the website :type query: str :param minify: (optional) Whether to minify the banner and only return the important data :type minify: bool :param retries: (optional) How often to retry the search in case it times out :type retries: int :returns: A search cursor that can be used as an iterator/ generator. rr)rr1rtotaldmatchesNzRetry limit reached ({:d})) rrintmathceil GeneratorExitrrr rr) rrkrretriesrr1 total_pagestriesresultsbanners r search_cursorShodan.search_cursor=s+" ++e+M 7 dii(83(>?@Ki(F  )  ! "++e+U%i0F$ 1  ! !  ) "#"#?#F#Fw#OPP  5!  "sADBD$B7=B& B7 DD B#D"B##D& B40B72D3B44B77AC>;D=C>>Dc&URS05$)zReturns a list of search facets that can be used to get aggregate information about a search query. :returns: A list of strings where each is a facet name z/shodan/host/search/facetsrrs rrShodan.search_facetsqs }}92>>rc&URS05$)znReturns a list of search filters that are available. :returns: A list of strings where each is a filter name z/shodan/host/search/filtersrrs rrShodan.search_filtersxs }}:B??rc.SU0nURSU5$)zReturns information about the search query itself (filters used etc.) :param query: Search query; identical syntax to the website :type query: str :returns: A dictionary with 4 main properties: filters, errors, attributes and string. rkz/shodan/host/search/tokensr)rrkrqs r search_tokensShodan.search_tokenss$ U }}9:FFrc&URS05$)zGet a list of services that Shodan crawls :returns: A dictionary containing the ports/ services that Shodan crawls for. The key is the port number and the value is the name of the service. z/shodan/servicesrrs rservicesShodan.servicess }}/44rc2UUUS.nURSU5$)aList the search queries that have been shared by other users. :param page: Page number to iterate over results; each page contains 10 items :type page: int :param sort: Sort the list based on a property. Possible values are: votes, timestamp :type sort: str :param order: Whether to sort the list in ascending or descending order. Possible values are: asc, desc :type order: str :returns: A list of saved search queries (dictionaries). )r1sortorderz /shodan/queryr)rr1rrr5s rqueriesShodan.queriess'  }}_d33rc0UUS.nURSU5$)a"Search the directory of saved search queries in Shodan. :param query: The search string to look for in the search query :type query: str :param page: Page number to iterate over results; each page contains 10 items :type page: int :returns: A list of saved search queries (dictionaries). )r1rkz/shodan/query/searchr)rrkr1r5s rqueries_searchShodan.queries_searchs% }}3T::rc.SU0nURSU5$)zSearch the directory of saved search queries in Shodan. :param size: The number of tags to return :type size: int :returns: A list of tags. sizez/shodan/query/tagsr)rr#r5s r queries_tagsShodan.queries_tagss$ D }}1488rc:USU0US.nURS0USS9nU$)zCreate a network alert/ private firehose for the specified IP range(s) :param name: Name of the alert :type name: str :param ip: Network range(s) to monitor :type ip: str OR list of str :returns: A dict describing the alert r)namefiltersexpiresz /shodan/alertrBrrrDr)rr'rr)rresponses r create_alertShodan.create_alerts;b  ==tTZ=[rcTSSU00nURSRU50USS9nU$)zEdit the IPs that should be monitored by the alert. :param aid: Alert ID :type name: str :param ip: Network range(s) to monitor :type ip: str OR list of str :returns: A dict describing the alert r(r/shodan/alert/{}rBr*r)raidrrr+s r edit_alertShodan.edit_alertsC b  ==!3!:!:3!?VZci=jrc`U(aSRU5nOSnURUSU0S9nU$)z4List all of the active alerts that the user created.z/shodan/alert/{}/infoz/shodan/alert/infoinclude_expiredrr r)rr0r4funcr+s ralerts Shodan.alertss= *11#6D'D== / = rcJSRU5nURU0SS9nU$)z#Delete the alert with the given ID.r/rX)rrDr5)rr0r6r+s r delete_alertShodan.delete_alerts+!((-==b=Brc&URS05$)zbReturn a list of available triggers that can be enabled for alerts. :returns: A list of triggers z/shodan/alert/triggersrrs ralert_triggersShodan.alert_triggerss }}5r::rcBURSRX50SS9$)z&Enable the given trigger on the alert./shodan/alert/{}/trigger/{}rIrCrrr0triggers renable_alert_triggerShodan.enable_alert_trigger s%}}:AA#OQS\a}bbrcBURSRX50SS9$)z'Disable the given trigger on the alert.r@rXrCrrAs rdisable_alert_triggerShodan.disable_alert_trigger s%}}:AA#OQS\d}eerc US;aMU(aF[U[5(a1URSRXX4SR U550SS9$URSRXX450SS9$)z:Ignore trigger notifications for the provided IP and port.) vulnerablevulnerable_unverifiedz+/shodan/alert/{}/trigger/{}/ignore/{}:{}/{}rrIrC(/shodan/alert/{}/trigger/{}/ignore/{}:{})rrrr r)rr0rBrrvulnss r!ignore_alert_trigger_notification(Shodan.ignore_alert_trigger_notifications = =%JW\^bLcLc==!N!U!UVYdfnqnvnvw|n}!~ACLQ=R R}}GNNs]_fhjsx}yyrcDURSRXX450SS9$)zrfs  (  ..0  | c| c  Js#$AA(A%$A%(A32A3