Get Marketplace Search Results

{
  "operationId": "Get_Marketplace_Search_Results",
  "method": "get",
  "path": "/get_facebook_marketplace_items_listing",
  "summary": "Get Marketplace Search Results",
  "description": "This endpoint retrieves Facebook Marketplace items by entering a search term and configuring filters like 🌍 Location, 💲 Price Range, 📅 Date Range, 📏 Radius, 🗂️ Category, and 🔄 Sort Order—enabling fast, customized searches for marketplace listings.",
  "parameters": [
    {
      "name": "seo_url",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "posted_today",
      "in": "query",
      "required": false,
      "schema": {
        "type": "boolean"
      },
      "description": "posted_today **(boolean)** — If set to **true**, results are limited to items posted today, and the `after_time` and `before_time` filters **are ignored**."
    },
    {
      "name": "fields",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string"
      },
      "description": "Comma-separated keys to filter the response. Supports dot notation and nested keys (e.g. `items.id,items.listingUrl,items.listing_price,page_info.end_cursor`). Invalid keys are ignored. If omitted, the full response is returned."
    },
    {
      "name": "commerce_search_and_rp_condition",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string"
      },
      "description": "This field specifies the condition of items to search for. Choose from the following options:\n\n- new\n- used_like_new\n- used_good\n- used_fair\n\nTo include **multiple conditions**, separate them with commas without spaces. For example, use **new**, **used_like_new**, **used_good**, **used_fair** to search for both new items and items in good used condition. Any value not in this list will result in an error."
    },
    {
      "name": "timezone",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string",
        "default": "UTC"
      }
    },
    {
      "name": "after_time",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "before_time",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "exact_match",
      "in": "query",
      "required": false,
      "schema": {
        "type": "boolean"
      }
    },
    {
      "name": "proxy_country",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "filter_radius_km",
      "in": "query",
      "required": false,
      "schema": {
        "type": "number",
        "default": "65"
      }
    },
    {
      "name": "filter_price_lower_bound",
      "in": "query",
      "required": false,
      "schema": {
        "type": "number",
        "default": "0"
      }
    },
    {
      "name": "end_cursor",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string"
      },
      "description": "If **end_cursor** is empty, retrieve up to **three** posts, utilizing the **newly generated** end_cursor from the **page_info** details in the response to fetch subsequent posts in the list."
    },
    {
      "name": "category_url",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string"
      },
      "description": "Link should match this pattern `"
    },
    {
      "name": "filter_location_latitude",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string",
        "default": "40.7142"
      }
    },
    {
      "name": "filter_price_upper_bound",
      "in": "query",
      "required": false,
      "schema": {
        "type": "number",
        "default": "214748364700"
      }
    },
    {
      "name": "commerce_search_sort_by",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "query",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string",
        "default": "cars"
      }
    },
    {
      "name": "filter_location_longitude",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string",
        "default": "-74.0064"
      }
    }
  ],
  "responses": [
    {
      "statusCode": "200",
      "description": "Successful response",
      "content": {
        "application/json": {
          "schema": {
            "type": "object"
          }
        }
      }
    },
    {
      "statusCode": "400",
      "description": "Bad request"
    },
    {
      "statusCode": "401",
      "description": "Unauthorized - invalid API key"
    },
    {
      "statusCode": "429",
      "description": "Rate limit exceeded"
    }
  ]
}