Bing::Search::Response - A response object for the Bing AJAX Api


    my $resulsts = $search->search();

    my $array_ref = $response->results;


This object contains the results from a search. Or something telling you why things went horribly wrong. It should be noted that this does not tell you if your request failed at some LWP-style failure -- for that, check the request_obj of your Bing::Search object.


Responses are generally a read-only ordeal. You may change the values here in these various methods, if it makes you feel better. Nothing will try to stop you. Won't do much, though.


Contains the Bing API version.


The query sent to Bing. Use this for verification.


If the query sent to Bing is "fixed" automatically by Bing, this string will allow you to re-submit the query "as-is". The example from the Bing documentation:

    For example, if the original query is microsift offic, then AlterationOverrideQuery would be +microsift +offic


This is the biggie. This is an arrayref of the Bing::Search::Result objects. This is what you want to fiddle with.


This is the total number of results generated by your search(es). If you have more than one source, these results are summed together.

If you need access to the individual source's counts, you may access it in the data hashref (see below) with {SearchResponse}->{source name}->{Total}, where the source name is "Web" or "Video" or so forth and so on.


A hashref, it initially contains the deparsed JSON structure. As objects are populated, it is depopulated. Anything left over is something Bing sent but was, for some reason, not handled. In a perfect world, by the time you're able to do anything, this should be empty. You probably don't want to fiddle with it.


Don't mess with this. It's what turns data into objects. Seriously. Just leave it alone.


Probably. Patches welcome.




Dave Houston, " ", 2010


This library is free software; you may redistribute and/or modify it under the same terms as Perl itself.

1 POD Error

The following errors were encountered while parsing the POD:

Around line 160:

L<> starts or ends with whitespace