NAME
API::Instagram::Search - Instagram Search Object
VERSION
version 0.013
METHODS
find
my
$users
=
->search(
'user'
)->find(
q =>
'larry'
);
for
my
$user
(
@$users
) {
say
$user
->username;
}
Returns a list of type objects searched with the given parameters.
Where type can be: user
, media
, tag
or location
.
user parameters:
my
$search
=
->search(
'user'
);
$search
->find(
q
=>
'larry'
,
# A query string
count
=> 5,
# Number of users to return
);
See http://instagram.com/developer/endpoints/users/#get_users_search.
media parameters:
my
$search
=
->search(
'media'
);
$search
->find(
lat
=> 48.858844,
# Latitude of the center search coordinate. If used, lng is required.
lng
=> 2.294351,
# Longitude of the center search coordinate. If used, lat is required.
min_timestamp
=> 1408720000,
# A unix timestamp. All media returned will be taken later than this timestamp.
max_timestamp
=> 1408723333,
# A unix timestamp. All media returned will be taken earlier than this timestamp.
distance
=> 500,
# Default is 1km (distance=1000), max distance is 5km.
);
See http://instagram.com/developer/endpoints/media/#get_media_search.
tag parameters:
my
$search
=
->search(
'tag'
);
$search
->find(
q =>
'perl'
,
# A valid tag name without a leading #.
);
See http://instagram.com/developer/endpoints/tags/#get_tags_search.
location parameters:
my
$search
=
->search(
'location'
);
$search
->find(
distance
=> 2000,
# Default is 1000m (distance=1000), max distance is 5000.
lat
=> 48.858844,
# Latitude of the center search coordinate. If used, lng is required.
lng
=> 2.294351,
# Longitude of the center search coordinate. If used, lat is required.
facebook_places_id
=> 123,
# Returns a location mapped off of a Facebook places id. If used, a Foursquare id and lat, lng are not required.
foursquare_id
=> 456,
# Returns a location mapped off of a foursquare v1 api location id. If used, you are not required to use lat and lng. Note that this method is deprecated; you should use the new foursquare IDs with V2 of their API.
foursquare_v2_id
=> 789,
# Returns a location mapped off of a foursquare v2 api location id. If used, you are not required to use lat and lng.
);
See http://instagram.com/developer/endpoints/locations/#get_locations_search.
AUTHOR
Gabriel Vieira <gabriel.vieira@gmail.com>
COPYRIGHT AND LICENSE
This software is copyright (c) 2014 by Gabriel Vieira.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.