Get Marketplace Search Results

You are wiring up the superagnt "Facebook" API to use this endpoint: Get Marketplace Search Results.

1. CONNECT over MCP (preferred). No token to paste either way.
   On Claude (claude.ai, the desktop app, or Claude Code signed in with a Claude
   account), the server is a connector: give the user this link, they click Add
   and approve:
     https://claude.ai/customize/connectors/yours?modal=add-custom-connector&connectorName=superagnt&connectorUrl=https%3A%2F%2Fmcp.superagnt.com%2Fmcp&open_in_browser=1
   Any other MCP client (or Claude Code signed in with an API key): add the server
   and let the client run the browser sign-in:
     claude mcp add --scope user --transport http superagnt https://mcp.superagnt.com/mcp
     claude mcp login superagnt
   MCP endpoint: https://mcp.superagnt.com/mcp
   After connecting, the tool you want is named exactly:
     data_facebook_get_marketplace_search_results
   Call agnt_tools_search or agnt_tools_list_enabled to confirm it is available.

2. REST fallback (if you are not using MCP):
     GET https://api.superagnt.com/get_facebook_marketplace_items_listing
     Header: Authorization: Bearer <YOUR_AGNTDATA_API_KEY>
   Required parameters:
    - (none)
   Optional parameters:
    - seo_url (string, optional)
    - posted_today (boolean, optional) — posted_today **(boolean)** — If set to **true**, results are limited to items posted today, and the `after_time` and `before_time` filters **are ignored**.
    - fields (string, optional) — 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.
    - commerce_search_and_rp_condition (string, optional) — This field specifies the condition of items to search for. Choose from the following options: - new - used_like_new - used_good - used_fair To 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.
    - timezone (string, optional)
    - after_time (string, optional)
    - before_time (string, optional)
    - exact_match (boolean, optional)
    - proxy_country (string, optional)
    - filter_radius_km (number, optional)
    - filter_price_lower_bound (number, optional)
    - end_cursor (string, optional) — 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.

3. COST & KEY. Each successful call costs $0.008 in credits. Only successful calls are charged.
   Get a superagnt API key at https://app.superagnt.com.

4. TEST. Connect the server (or set the key), discover the tool
   (data_facebook_get_marketplace_search_results), run one minimal call with just the required parameters,
   and report back the shape of the JSON response (top-level fields).

Reference (machine-readable variant): https://www.superagnt.com/docs/apis/social/facebook/endpoints/Get_Marketplace_Search_Results.md

{
  "name": "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": {
    "type": "object",
    "properties": {
      "seo_url": {
        "type": "string",
        "description": "query parameter"
      },
      "posted_today": {
        "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**."
      },
      "fields": {
        "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."
      },
      "commerce_search_and_rp_condition": {
        "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."
      },
      "timezone": {
        "type": "string",
        "description": "query parameter",
        "default": "UTC"
      },
      "after_time": {
        "type": "string",
        "description": "query parameter"
      },
      "before_time": {
        "type": "string",
        "description": "query parameter"
      },
      "exact_match": {
        "type": "boolean",
        "description": "query parameter"
      },
      "proxy_country": {
        "type": "string",
        "description": "query parameter"
      },
      "filter_radius_km": {
        "type": "number",
        "description": "query parameter",
        "default": "65"
      },
      "filter_price_lower_bound": {
        "type": "number",
        "description": "query parameter",
        "default": "0"
      },
      "end_cursor": {
        "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."
      },
      "category_url": {
        "type": "string",
        "description": "Link should match this pattern `"
      },
      "filter_location_latitude": {
        "type": "string",
        "description": "query parameter",
        "default": "40.7142"
      },
      "filter_price_upper_bound": {
        "type": "number",
        "description": "query parameter",
        "default": "214748364700"
      },
      "commerce_search_sort_by": {
        "type": "string",
        "description": "query parameter"
      },
      "query": {
        "type": "string",
        "description": "query parameter",
        "default": "cars"
      },
      "filter_location_longitude": {
        "type": "string",
        "description": "query parameter",
        "default": "-74.0064"
      }
    },
    "required": []
  }
}