Marketplace.search

From Facebook Developers Wiki

Contents 1 Description 2 Parameters 3 Example Return XML 4 Response 5 Error Codes

[edit] Description

Search Marketplace for listings filtering by category, subcategory, and a query string.

[edit] Parameters

Required	Name	Type	Description
required	api_key	string	The application key associated with the calling application.
	session_key	string	The session key of the logged in user.
	call_id	float	The request's sequence number. Each successive call for any session must use a sequence number greater than the last. We suggest using the current time in milliseconds, such as PHP's microtime(true) function.
	sig	string	An MD5 hash of the current request and your secret key, as described in the authentication guide.
	v	string	This must be set to 1.0 to use this version of the API.
optional	format	string	Desired response format. Either XML (default) or JSON.
	callback	string	Name of a function to call. This is primarily to enable cross-domain JavaScript requests using the <script> tag, also known as JSONP, and works with both the XML and JSON formats. The function will be called with the response passed as the parameter.
	category	string	Filter by a Marketplace category. While this parameter is optional, you must specify it if you want to filter by subcategory.
	subcategory	string	Filter by a Marketplace subcategory.
	query	string	Filter by a query string.

[edit] Example Return XML

<?xml version="1.0" encoding="UTF-8"?> <marketplace_search_response xmlns="http://api.facebook.com/1.0/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://api.facebook.com/1.0/ http://api.facebook.com/1.0/facebook.xsd" list="true"> <listing> <listing_id>5518084855</listing_id> <url>http://www.facebook.com/marketplace/listing.php?classified_id=5518084855</url> <title>For sale: Upon the Altar of a Nation by Harry S. Stout</title> <description>I'm looking to sell Upon the Altar of a Nation by Harry S. Stout</description> <price>29.95</price> <poster>223835</poster> <update_time>0</update_time> <category>FORSALE</category> <subcategory>BOOKS</subcategory> <image_urls list="true"/> <condition>Used</condition> <isbn>9780670034703</isbn> </listing> <listing> <listing_id>4817294217</listing_id> <url>http://www.facebook.com/marketplace/listing.php?classified_id=4817294217</url> <title>For sale: Harry Potter and the Deathly Hallows by J. K. Rowling</title> <description>Ten years after Potter-mania first swept the globe, the epic series draws to a close with HARRY POTTER AND THE DEATHLY HALLOWS, the hotly anticipated seventh and final book of the internationally revered Harry Potter series. Prophecies will be fulfilled. Beloved characters will die. Questions will be answered. (Is Dumbledore really gone forever? Who is R.A.B.? Is Severus Snape truly a villain?) In this final volume, Harrys seemingly impossible quest is to discover the locations of the remaining horcruxes--items sacred to Lord Voldemort containing shreds of his soul, making him immortal--and destroy them, saving the world from becoming a Death Eaters paradise where Muggles are prey and purebloods rule. Accompanied by Ron and Hermione, Harry embarks on a dangerous, confusing, and often frustrating journey to discover the horcruxes. The trio is repeatedly in dire straits, making their mission seem, at times, doomed.Throughout the series, author J. K. Rowling has been steadily escalating events towards the climatic battle between Harry and the Dark Lord, and numerous seemingly trivial details from the previous novels play important roles--proof of Rowling's masterly control of the sprawling and multi-layered "wizarding world" she has invented. By far the darkest of the novels, this impressive finale shows Harry bereft of his godfather Sirius Black, the wise and secretive Dumbledore, and even his friends, forced to truly grow up and face a fight where he is the sole lynchpin in the battle between righteousness and a nearly omnipotent evil. With modern problems re-imagined in a magical setting, echoes of Christianity, and an unwavering faith in goodness, Rowlings epic saga will remain a childrens classic for generations to come. Raquel adds: A MUST READ! If you haven't read it yet, get to it soon before your friends ruin it for you! Powered by muze(r). MuzeBooks(tm) and Out of Print MuzeBooks(tm) Copyright 2007. For personal non-commercial use only. All rights reserved. Portions of this content may be the property of Baker & Taylor, Inc. or its licensors and shall be subject to copyright and all other protections under the law.</description> <price>12</price> <poster>1481790044</poster> <update_time>1189366879</update_time> <category>FORSALE</category> <subcategory>BOOKS</subcategory> <image_urls list="true"/> <condition>Used</condition> <isbn>9780545010221</isbn> </listing> <listing> <listing_id>5092188163</listing_id> <url>http://www.facebook.com/marketplace/listing.php?classified_id=5092188163</url> <title>For sale: Harry Potter and the Prisoner of Azkaban by J. K. Rowling</title> <description>As Harry Potter begins his third year as a student at the Hogwarts School for Witchcraft and Wizardry, he is disturbed to discover that Sirius Black, a wizard who may have been involved with the death of his parents, has escaped from Azkaban Prison. Black left behind two clues, both of which indicate that he is headed for Hogwarts--and Harry. As a result, the school is being watched over by the Dementors, a terrifying sect of black-cloaked guards from the Azkaban Prison--whose very presence at Hogwarts has a potentially life-threatening effect on Harry. Meanwhile, he gets acquainted with Professor Lupin, Hogwarts's new teacher of Defense Against the Dark Arts, but Harry also wonders about his new teacher's secretive relationship with Professor Snape. This is the third entry in the wildly popular Harry Potter series of books, and a film version directed by Alfonso Cuaron was made in 2004. Vincent adds: Read once -- it is basically like new. No marks or highlight. Powered by muze(r). MuzeBooks(tm) and Out of Print MuzeBooks(tm) Copyright 2007. For personal non-commercial use only. All rights reserved. Portions of this content may be the property of Baker & Taylor, Inc. or its licensors and shall be subject to copyright and all other protections under the law.</description> <price>7</price> <poster>29044</poster> <update_time>1189355297</update_time> <category>FORSALE</category> <subcategory>BOOKS</subcategory> <image_urls list="true"/> <condition>Used</condition> <isbn>9780439136358</isbn> </listing> <listing> <listing_id>4921068555</listing_id> <url>http://www.facebook.com/marketplace/listing.php?classified_id=4921068555</url> <title>For sale: Harry Potter and the Half-Blood Prince by J. K. Rowling</title> <description>Packed with mystery, subterfuge, and a more intimate understanding of the challenges that lie ahead of him, Harry Potters sixth year at Hogwarts heaves with his growing sense of responsibility regarding the defeat of Lord Voldemort, a relentlessly sneaking suspicion that classmate Draco Malfoy is a Death Eater in cahoots with the dastardly Professor Snape, and a host of romantic entanglements that hilariously plague everyone. Harrys busy N.E.W.T.-level schedule includes Potions, where he surprises himself by excelling due to strangely helpful, hand-written margin notes in his book, ascribed only to the enigmatic "Half-Blood Prince." Sporadic, private lessons with Dumbledore center on the personal history of Lord Voldemort, which both unnerves and fascinates Harry. At the same time, the romantic ups and downs of Ron and Hermione threaten to destroy their friendship. The sixth installation in the phenomenally successful Harry Potter series opened with record-breaking sales of an estimated 6.9 million books on July 16, 2005. Named both one of Publishers Weekly's Best Children's Books of 2005 and a New York Times Notable Book of 2005. Vincent adds: Read once -- it is basically like new. No marks or highlight. Powered by muze(r). MuzeBooks(tm) and Out of Print MuzeBooks(tm) Copyright 2007. For personal non-commercial use only. All rights reserved. Portions of this content may be the property of Baker & Taylor, Inc. or its licensors and shall be subject to copyright and all other protections under the law.</description> <price>7</price> <poster>29044</poster> <update_time>1189354937</update_time> <category>FORSALE</category> <subcategory>BOOKS</subcategory> <image_urls list="true"/> <condition>Used</condition> <isbn>9780439784542</isbn> </listing> <listing> <listing_id>4770292091</listing_id> <url>http://www.facebook.com/marketplace/listing.php?classified_id=4770292091</url> <title>For sale: Unfaithful Angels by Harry Specht</title> <description>I'm looking to sell Unfaithful Angels by Harry Specht</description> <price>0</price> <poster>7610</poster> <update_time>1187956972</update_time> <category>FORSALE</category> <subcategory>BOOKS</subcategory> <image_urls list="true"/> <condition>Used</condition> <isbn>9780028740867</isbn> </listing> <listing> <listing_id>11121930084</listing_id> <url>http://www.facebook.com/marketplace/listing.php?classified_id=11121930084</url> <title>For sale: Introduction to Physical Anthropology by Harry Nelson</title> <description> Trang adds: There's some highlighting in the book. Book is in good condition.</description> <price>0</price> <poster>3229042</poster> <update_time>1187903497</update_time> <category>FORSALE</category> <subcategory>BOOKS</subcategory> <image_urls list="true"/> <condition>Used</condition> <isbn>9780534514631</isbn> </listing> <listing> <listing_id>2415316093</listing_id> <url>http://www.facebook.com/marketplace/listing.php?classified_id=2415316093</url> <title>Harry Potter and the Goblet of Fire</title> <description>Softcover, used. List price $9</description> <price>3.5</price> <poster>3263</poster> <update_time>1179766421</update_time> <category>FORSALE</category> <subcategory>BOOKS</subcategory> <image_urls list="true"/> <condition>Used</condition> <isbn>0-439-13960-0</isbn> </listing> <listing> <listing_id>2405496494</listing_id> <url>http://www.facebook.com/marketplace/listing.php?classified_id=2405496494</url> <title>Harry Potter and the Half-Blood Prince</title> <description>by JK Rowling. Like new - hardcover</description> <price>8</price> <poster>3263</poster> <update_time>1179766316</update_time> <category>FORSALE</category> <subcategory>BOOKS</subcategory> <image_urls list="true"/> <condition>New</condition> <isbn>0-439-78454-9</isbn> </listing> </marketplace_search_response>

[edit] Response

This method returns all visible listings that match the filter criteria.

[edit] Error Codes

Code	Description
1	An unknown error occurred. Please resubmit the request.
2	The service is not available at this time.
4	The application has reached the maximum number of requests allowed. More requests are allowed once the time window has completed.
5	The request came from a remote address not allowed by this application.
100	One of the parameters specified was missing or invalid.
101	The API key submitted is not associated with any known application.
102	The session key was improperly submitted or has reached its timeout. Direct the user to log in again to obtain another key.
103	The submitted call_id was not greater than the previous call_id for this session.
104	Incorrect signature.