Metadata-Version: 1.1
Name: py-bing-search
Version: 0.2.1
Summary: A simple lightweight python wrapper for the Azure Bing Search API.
Home-page: https://github.com/tristantao/py-bing-search
Author: Tristan Tao
Author-email: tristan@teamleada.com
License: MIT
Description: Intro
        =====
        
        Extremely thin python wrapper for Microsoft Azure Bing Search API. Please note that this module does not use the Bing Search API 2.0 AppIDs which will be deprecated on August 1, 2012. This module requires that you sign up to the Windows Azure Marketplace and apply for an application key.
        
        The modules uses OAuth, so you'll need to get your key here (free for up to 5K/Mon):
        * [All Purpose](https://datamarket.azure.com/dataset/5BA839F1-12CE-4CCE-BF57-A49D98D29A44)
        * [Web Search Only](https://datamarket.azure.com/dataset/8818F55E-2FE5-4CE3-A617-0B8BA8419F65)
        
        
        Installation
        =====
        
        ```pip install py-bing-search```
        
        *Requires the requests library.
        
        Usage
        =====
        
        Remember to set the `API_KEY` as your own.
        
        ####For Web Results:
        
            >>> from py_bing_search import PyBingWebSearch
            >>> search_term = "Python Software Foundation"
            >>> bing_web = PyBingWebSearch('Your-Api-Key-Here', search_term)
            >>> first_fifty_result= bing_web.search(limit=50, format='json') #1-50
            >>> second_fifty_result= bing_web.search(limit=50, format='json') #51-100
        
            >>> print (second_fifty_result[0].description)
            u'Python Software Foundation Home Page. The mission of the Python Software Foundation is to promote, protect, and advance the Python programming language, and to ...'
        
        What you get is a list of WebResult() instances, each comes with the following values:
        
        ```py
        self.title:         title of the result
        self.url:           the url of the result
        self.description:   description for the result
        self.id:            bing id for the page
        
        #Meta info:
        self.meta.uri:      the search uri for bing
        self.meta.type:     for the most part WebResult
        ```
        
        ####For Image Results:
        
            >>> from py_bing_search import PyBingImageSearch
            >>> bing_image = PyBingImageSearch('Your-Api-Key-Here', "x-box console")
            >>> first_fifty_result= bing_image.search(limit=50, format='json') #1-50
            >>> second_fifty_result= bing_image.search(limit=50, format='json') #51-100
            >>> print (second_fifty_result[0].media_url)
            ...
        
        What you get is a list of ImageResult() instances, each comes with the following values:
        
        ```py
        self.id: id of the result
        self.title: title of the resulting image
        self.media_url: url to the full size image
        self.source_url: url of the website that contains the source image
        self.width: width of the image
        self.height: height of the image
        self.file_size: size of the image (in bytes) if available
        self.content_type the MIME type of the image if available
        self.meta: meta info
            
        #Meta info#:
        meta.uri: the search uri for bing
        meta.type: for the most part ImageResult
        ```
        
        ####For Video Results:
        
            >>> from py_bing_search import PyBingVideoSearch
            >>> bing_video = PyBingVideoSearch('Your-Api-Key-Here', "cats")
            >>> first_fifty_result= bing_video.search(limit=50, format='json') #1-50
            >>> second_fifty_result= bing_video.search(limit=50, format='json') #51-100
            >>> print (second_fifty_result[0].media_url)
            ...
        
        What you get is a list of VideoResult() instances, each comes with the following values:
        
        ```py
        self.id: id of the result
        self.title: title of the resulting Video
        self.media_url: url to the full size Video
        self.display_url: url to display on the search result.
        self.run_time: run time of the video
        self.meta: meta info
        
        #Meta info#:
        meta.uri: the search uri for bing
        meta.type: for the most part VideoResult
        ```
        
        ####For News Results:
        
            >>> from py_bing_search import PyBingNewsSearch
            >>> bing_news = PyBingNewsbSearch('Your-Api-Key-Here', "US Election")
            >>> first_fifty_result= bing_news.search(limit=50, format='json') #1-50
            >>> second_fifty_result= bing_news.search(limit=50, format='json') #51-100
            >>> print (second_fifty_result[0].url)
            ...
        
        What you get is a list of NewsResult() instances, each comes with the following values:
        
        ```py
        self.id: id of the result
        self.title: title of the resulting News
        self.url: url to the News
        self.description: description of the article
        self.date: date of the News
        self.meta: meta info
        
        #Meta info#:
        meta.uri: the search uri for bing
        meta.type: for the most part NewsResult
        ```
        
        ## Searching for a specific number of results.
        
        You secan also run __*search_all*__ to keep searching until it fills your required quota. Note that this will make an unpredictable number of api calls (hence drains your credits).
        
            >>> from py_bing_search import PyBingWebSearch
            >>> bing_web = PyBingNewsbSearch('Your-Api-Key-Here', "Python Software Foundation")
            >>> result_list = bing_web.search_all(limit=130, format='json') #will return result 1 to 130
            >>> len(result_list) == 130
            True
            >>> result_list = bing_web.search_all(limit=130, format='json') #will return result 131 to 260
        
        __*search_all*__ is available in all PyBing*search classes.
        
        
Keywords: Azure,Bing,API,Search
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries :: Python Modules
