An easy-to-use Facebook Marketplace API, that functions without the need to log into a Facebook account. Wraps the Facebook GraphQL API, allowing for quick and easy retrieval of Facebook Marketplace listings and other relevant Marketplace data.

All endpoints will return a JSON response in the following format:

{
    "status": String,
    "error": {
        "source": String,
        "message": String
    },
    "data": Array
}

status: Indicates whether a request was a success or failure. Successful requests will have a status of "Success" and failed requests will have a status of "Failure".

error: A request error (will be empty if no error exists).

• error.source: Indicates the party responsible for an error. Server-side Facebook errors will have a source of "Facebook" and errors caused by the user will have a source of "User".
• error.message: A detailed description of the request error.

data: A list of JSON objects representing the information an endpoint retrieved (will be empty if an error exists).

• /locations
  Response:
  Locations which are exact, or close matches, to the search query provided. Latitude and longitude coordinates for a location are required to find Marketplace listings in a targeted area.
  
  Example:

  {
      "status": "Success",
      "error": {},
      "data": {
          "locations": [
              {
                  "name": "Houston, Texas",
                  "latitude": "29.7602",
                  "longitude": "-95.3694"
              },
              {
                  "name": "Downtown Houston, TX",
                  "latitude": "29.758767",
                  "longitude": "-95.361523"
              },
              {
                  "name": "Houston, Mississippi",
                  "latitude": "33.8981",
                  "longitude": "-89.0017"
              },
              {
                  "name": "Houston, Alaska",
                  "latitude": "61.6083",
                  "longitude": "-149.774"
              }
          ]
      }
  }

  
  

  Required Parameters:
  

  {
      // A location in which to find the latitude and longitude coordinates
      "locationQuery": String
  }

• /search
  Response:
  Listings which are exact, or close matches, to the listing query and optional filter(s) provided.
  
  Example (number of pages/listings displayed and listing's primary photo URL have been removed to shorten this example):

  {
      "status": "Success",
      "error": {}, 
      "data": {
          "listingPages": [
              {
                  "listings": [
                      {
                          "id": "4720490308074106",
                          "name": "Small sectional couch", 
                          "currentPrice": "$150",
                          "previousPrice": "",
                          "saleIsPending": "false",
                          "primaryPhotoURL": "Removed to shorten example",
                          "sellerName": "Cory Yount",
                          "sellerLocation": "Scottsdale, Arizona",
                          "sellerType": "User"
                      },
                      {
                          "id": "296832592544544",
                          "name": "Sectional sofa couch",
                          "currentPrice": "$400",
                          "previousPrice": "",
                          "saleIsPending": "false",
                          "primaryPhotoURL": "Removed to shorten example",
                          "sellerName": "Alexis Brown",
                          "sellerLocation": "Scottsdale, Arizona",
                          "sellerType": "User"
                      },
                      {
                          "id": "261980506019699",
                          "name": "Living spaces couch",
                          "currentPrice": "$600",
                          "previousPrice": "",
                          "saleIsPending": "false",
                          "primaryPhotoURL": "Removed to shorten example",
                          "sellerName": "Chelsea Markley",
                          "sellerLocation": "Scottsdale, Arizona",
                          "sellerType": "User"
                      },
                      {
                          "id": "683280016149318",
                          "name": "Beige couch",
                          "currentPrice": "$100",
                          "previousPrice": "",
                          "saleIsPending": "false",
                          "primaryPhotoURL": "Removed to shorten example",
                          "sellerName": "Sarah Wilke",
                          "sellerLocation": "Phoenix, Arizona",
                          "sellerType": "User"
                      },
                      {
                          "id": "545545826911162",
                          "name": "BRAND NEW gray L shaped couch with reversible chaise!",
                          "currentPrice": "$450",
                          "previousPrice": "$480",
                          "saleIsPending": "false",
                          "primaryPhotoURL": "Removed to shorten example",
                          "sellerName": "Jamie Clark Hopkins",
                          "sellerLocation": "Paradise Valley, Arizona",
                          "sellerType": "User"
                      },
                      {
                          "id": "321297783315616",
                          "name": "Leather Couch Set",
                          "currentPrice": "$150",
                          "previousPrice": "",
                          "saleIsPending": "false",
                          "primaryPhotoURL": "Removed to shorten example",
                          "sellerName": "Samantha Crosner",
                          "sellerLocation": "Scottsdale, Arizona",
                          "sellerType": "User"
                      }
                  ]
              }
          ]
      }
  }

  
  

  Required Parameters:
  

  {
      // The latitude coordinate of the search location
      "locationLatitude": String,
      // The longitude coordinate of the search location
      "locationLongitude": String,
      // Keywords for which listings to retrieve
      "listingQuery": String
  }