Allowed text values string : These text values except Unspecified limit results to items with the condition defined in conditionId or item specifics.
More importantly, always see the seller's listing for full details and description of any imperfections before purchasing an item. All rights reserved. ItemFilterType string Values that can be used for the itemFilter. Item filter LocatedIn cannot be used together with item filter AvailableTo. Allowed values string : Expects the two-letter ISO country code to indicate the country where the item is located.
For English names that correspond to each code e. Default is false. Allowed values boolean : true, false CharityOnly If true, the search results are limited to items for which all or part of the proceeds are given to a charity. Each item in the search results will include the ID of the given charity.
Allowed values boolean : true, false Condition Limits items to those that have the matching item condition. The order of the results depends on the sortOrder you specify not ordered by conditions. Mostly useful to filter items where the seller used one of eBay's structured item condition formats conditionId or item specifics to specify the item condition.
If the seller used item specifics, the condition is only returned in conditionDisplayName. As of Julymany categories require items to use the condition ID format. Older GTC listings may continue to use item specifics to specify condition until spring If you repeat condition values, the values are processed using OR logic. For example: To precisely find only brand new and manufacturer-refurbished items, pass the filter with values of and in the same request.
To find all flavors of new items plus refurbished items but not used itemspass the filter with values of New,and To find a much broader set of new items, plus items with no condition specified, pass the filter with values of New and Unspecified.
The order of the values does not affect the results. That is, passing New,and then gives the same results as passingNew, and then New New or the equivalent. Excludes items with used, refurbished, for parts, or unspecified conditions.
Used Used, refurbished, or for parts. Excludes items with new or unspecified conditions. Unspecified The seller did not specify an item condition using one of eBay's structured formats. That is, either the item has no condition, or the seller only specified the condition in the title or narrative description.
You can try including words like "new" in your search keywords to reduce unspecified results.This tutorial shows how easy it is to use the Finding API. The tutorial shows you how to build a simple PHP application that submits a findItemsByKeywords call to search for eBay listings based on a keyword query.
After completing the tutorial, you'll have an application that displays an HTML page that looks similar to the following when it runs:. For notes about the tutorial, additional resources, and suggestions for next steps, please see Notes and Next Steps.
Joining is free and you get 5, API calls a day just for joining! Apache is easy to install and configure. The steps in this tutorial are written with the assumption you are using Apache.
PHP is, however, compatible with most popular web servers, so Apache is not strictly required. The tutorial code should run on any web server configured to support PHP. The code for this tutorial is written in PHP.
Save the file as MySample. The request will fail if a Sandbox AppID is used. The tutorial code is not yet ready to run. Proceed to the next step to add the code that submits the API request and parses the response. The code loops through the array of items in the search results, adding a new row to the table for each item. Each row consists of the item's gallery image and title. The title links to the item's View Item page.
This file is now runnable, but we're not done yet. Skip ahead to Step 4 to see what it looks like, or proceed to the next step to add item filters to the request.
This step adds item filters to your request. This is done by first creating a PHP array of the item filters. Whenever you use repeating fields in a URL-format request, you must index the fields for them to be properly processed.
The dark mode beta is finally here. Change your preferences any time. Stack Overflow for Teams is a private, secure spot for you and your coworkers to find and share information. I am new to eBay API. I using JSON format for request and reply. Please help me. Thanks in advance. Learn more. Asked 8 years, 7 months ago. Active 9 months ago. Viewed 5k times. Ajay nath Ajay nath 2 2 silver badges 10 10 bronze badges. Active Oldest Votes. The Overflow Blog. The Overflow How many jobs can be done at home?
Featured on Meta. Community and Moderator guidelines for escalating issues via new response…. Feedback on Q2 Community Roadmap. Technical site integration observational experiment live on Stack Overflow. Triage needs to be fixed urgently, and users need to be notified upon…. Dark Mode Beta - help us root out low-contrast and un-converted bits. Related Hot Network Questions.
By setting the descriptionSearch field to trueyour keyword queries also search the item descriptions, in addition to searching through the item title and subtitles. The findItemsAdvanced response contains details about items matching your search criteria. By default, eBay returns a specific set of data in the response to your call.
Control findItemsAdvanced result sets using the following methods:. For details on these response control mechanisms, refer to findItemsByKeywords. If you are an eBay affiliate, you can specify your affiliate information using the fields in the affiliate container. By specifying your affiliate information, you can earn commissions on user activity generated from your site.
The box below lists all fields that could be included in the call request. To learn more about an individual field or its type, click its name in the box or scroll down to find it in the table below the box.
See currencyId Values for a list of possible currency enumeration values. See ItemFilterType for information about the allowed values, usage rules, and dependencies. See Searching by Keywords for a list of valid wildcard characters. See eBay Partner Network site for information about commissions. The box below lists all fields that might be returned in the response. See Item Condition IDs and Names for a list of display names and the typical meaning of each condition.
See Listing Items with Parts Compatibility. See English country names and code elements for country names and corresponding ISO codes. See shipToLocations for a complete list of shipping locations. This call does not support varying Detail Levels. You do not need to pass DetailLevel in the request. The outputSelector input field gives you control over which call-specific output fields may be returned from your queries.
All standard output fields are returned regardless of outputSelector. The table below details the fields that each outputSelector value controls. In addition, the table includes a none column that shows the fields that are not controlled by outputSelector settings.
The dark mode beta is finally here. Change your preferences any time. Stack Overflow for Teams is a private, secure spot for you and your coworkers to find and share information. Currently I work on a ASP. The goal i want to accomplish is to create a Website on which you can search for different articles on Ebay and being able to use certain filters using the Ebay finding API. This is a training projekt for me, as the C part of the whole thing is a good practice in my opinion.
Frankly i have no idea what im doing and I hope some of you may have an idea or some tips for me. Obisously i filled in the IDs and the token but deleted it for this post. In the "Index" class at the end of my piece of code I entered the ID of a random Ebay article for testing purposes. When i debug I get this Exception:. ApiException: 'This item cannot be accessed because the listing has been deleted, is a Half. I would really appreciate if someone can show me how to do it correctly or push me in the right direction.
I have to admit that i find the whole Ebay API documentation etc. I take any advice you guys can give me! From the error you are getting I would guess that you are trying to get information regarding a "random listing" you have not entered yourself on the eBay sandbox. In order to use GetItem the listing you are retrieving has to have been created using your sandbox user id.
Learn more. Asked 1 year, 8 months ago. Active 1 year, 8 months ago.API: How To Make A Call Using PHP
Viewed times. What have i done so far? Important: I currently only work with the sandbox! When i debug I get this Exception: "eBay. Here is the code I found and used so far: using System; using System. Generic; using System. Linq; using System. Web; using System.Skip to main content. Add Your Api. Write for us Become member Login.
Become member Login. How To. Source Code. Primary Category Search. Secondary Categories AuctionseCommerce. Version status Recommended active, supported. Followers Track this API. Developers 8. API Mashups 9. Geo Ship.
eBay Finding API - How To
Geo Ship is a global search for all eBay sites. Various filters and sorting options that are not included on the official site. Geo Ship contains useful features like saved searches notifications, Christmas List App. Add gifts to your wish lists from any site with the Christmas List App web application or Chrome Bookfinder is a mobile application that lets users browse and search for different book titles.
Related Articles 7. Promoted Listings. Developers can also request the search functionality.The Finding API provides programmatic access to the next generation search capabilities on the eBay platform.
It lets you search and browse for items listed on eBay, and provides useful metadata to refine searches and enhance the search experience. Affiliates can use this API to build search and browse capabilities into bidding and buying applications. Sellers need to understand how searching and browsing works so they can optimize their listings for better search visibility. Categories, such as shoes or digital cameras, are a buy-side grouping of items.
Aspects are item characteristics shared by items in a given category. The search calls and the getHistogram call return category and aspect metadata that can be used to refine searches. You can use the Finding API to search or browse for items. Each method has its advantages, depending on the experience your users want:.
The keywords field is the basis for item searches. The search calls, such as findItemsByKeywordssearch for item listings where the specified keywords are found in the title and, in some cases, the item subtitle or structured item data, returning those matching items in the result set.
Queries aren't case-sensitive, so it doesn't matter whether you use uppercase or lowercase letters. The following search features help you get the most relevant search results possible with your keyword queries:. The value specified in the keywords field can contain one or more keywords. The words "and" and "or" are treated like any other word.
Only use "and," "or," or "the" if you are searching for listings containing these words. The following table shows the operators and character punctuation that can be used in keyword queries, and the effects they have. With the exception of the advanced search operators, punctuation marks, such as hyphens -commas followed by spaces, exclamation points! Keyword queries always search item titles for words or phrases that match exactly the keywords you specified.
In some cases, eBay automatically expands keyword queries to increase the number of relevant results in the response. This is why search results may contain items with titles that do not have all the keywords you specified in your query.
Using advanced search operators e. Item listings can be retrieved for one or more specific categories on an eBay site to create a browsing experience. The findItemsByCategory response contains details about items in the specified categories.
This call supports item filters itemFilter and aspect filters aspectFilter to refine your search results. By default, eBay returns a standard set of data for each item in the response. Use outputSelector to specify additional data to include in the response for each item. By default, results are sorted by Best Match, with the most relevant items first.
Use sortOrder to specify different sort order, such as by current price or the listing end time. Use paginationInput to specify how many items to return per response page and the specific page of data to return. Within the context of eBay, a product is stock information from a catalog. A seller can take this product data and use it to pre-fill some of the details in their listings.
We call this Pre-filled Item Information. For example, a seller can list a book using the book's ISBN and the listing will automatically include a stock photo of the book, the listing title will include the title of the book and the name of the author, and details about the book will be included in the item specifics.
For example, if you search the eBay site for "harry potter and the chamber of secrets," the site will return matching items. If you click on one of the items and look in the Product Details section of the description, you will see information about the product, such as author, publisher, publication date, and ISBN.