Developers Program

Finding API: WorldWide search

Published: November 03 2011, 11:51:00 PM·Updated: August 18 2022, 7:16:01 PM

Products

Answer

Finding API WorldWide search has been released to Production.

You can use LocatedIn filter with value set to “WorldWide” to find items, regardless of their Location:

<itemFilter>
<name>LocatedIn</name>
<value>WorldWide</value>
</itemFilter>

There are three new filter values for LocatedIn: “WorldWide”, “North America”, and “European”, apply to LocatedIn only. Note the casing for WorldWide and the space in North America.

Here are sample requests:
Without filter
http://svcs.ebay.com/services/search/FindingService/v1?OPERATION-NAME=findItemsAdvanced&SERVICE-VERSION=1.11.0&SECURITY-APPNAME=YOUR APPID&keywords=canon+60d+slr

With filter
The following request returned items from all the locations as the non-filtered request, and also item from Malaysia and United Kingdom.

URL format - HTTP GET

http://svcs.ebay.com/services/search/FindingService/v1?OPERATION-NAME=findItemsAdvanced&SERVICE-VERSION=1.11.0&SECURITY-APPNAME=YOUR APPID&keywords=canon+60d+slr&itemFilter%280%29.name=LocatedIn&itemFilter%280%29.value=WorldWide

XML format - HTTP POST

<?xml version="1.0" encoding="utf-8"?>
<findItemsAdvancedRequest xmlns="http://www.ebay.com/marketplace/search/v1/services">
<keywords>canon 60d slr</keywords>
<itemFilter>
<name>LocatedIn</name>
<value>WorldWide</value>
</itemFilter>
</findItemsAdvancedRequest>

The value "European" works only if the GLOBAL-ID value corresponds to a European eBay site (e.g., EBAY-FR, EBAY-DE, EBAY-GB, EBAY-AT, ...). For example, won’t work for eBay US (EBAY-US) or eBay Australia (EBAY-AU).

URL format - HTTP GET

http://svcs.ebay.com/services/search/FindingService/v1?OPERATION-NAME=findItemsAdvanced&SERVICE-VERSION=1.11.0&SECURITY-APPNAME=YOUR APPID&keywords=canon+60d+slr&itemFilter%280%29.name=LocatedIn&itemFilter%280%29.value=European&GLOBAL-ID=EBAY-GB

XML format - HTTP POST

<?xml version="1.0" encoding="utf-8"?>
<findItemsAdvancedRequest xmlns="http://www.ebay.com/marketplace/search/v1/services">
<keywords>canon 60d slr</keywords>
<itemFilter>
<name>LocatedIn</name>
<value>European</value>
</itemFilter>
</findItemsAdvancedRequest>

Attachments

How well did this answer your question?