Facebook Marketplace Listings

Get Marketplace Vehicles Search Results

GET/facebook_marketplace_vehicles_listings

$0.008/calljson responserest · mcp

01// about this endpoint

Access Facebook data through superagnt: Get Marketplace Vehicles Search Results. Fetch Vehicles listings from the marketplace. Responses are structured JSON for AI agents, analytics, and automation — one API key instead of juggling upstream accounts. Ideal when you need page and group posts, marketplace listings, video content, and ad discovery programmatically.

02// code samples

Call it over REST

Authenticate with a bearer token against https://api.superagnt.com. Swap the placeholders for your key and parameter values.

curlbash

curl -s "https://api.superagnt.com/facebook_marketplace_vehicles_listings?after_time=<after_time>&end_cursor=<end_cursor>" \
  -H "Authorization: Bearer <YOUR_AGNTDATA_API_KEY>"

03// give it to your agent

Copy-paste prompt

Paste this into a coding agent. It connects the superagnt MCP server, finds the tool data_facebook_get_marketplace_vehicles_search_results, and runs a first call — with the REST fallback if MCP is unavailable.

agent prompttext

You are wiring up the superagnt "Facebook" API to use this endpoint: Get Marketplace Vehicles 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_vehicles_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/facebook_marketplace_vehicles_listings
     Header: Authorization: Bearer <YOUR_AGNTDATA_API_KEY>
   Required parameters:
    - (none)
   Optional parameters:
    - after_time (string, optional)
    - end_cursor (string, optional)
    - exact_match (boolean, optional)
    - before_time (string, optional)
    - sort_by (string, optional)
    - filter_location_latitude (string, optional)
    - filter_price_upper_bound (number, optional)
    - proxy_country (string, optional)
    - is_c2c_listing_only (boolean, optional) — This field indicates whether the listings are from individual sellers only
    - filter_price_lower_bound (number, optional)
    - filter_location_longitude (string, optional)
    - filter_radius_km (number, optional)

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_vehicles_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_Vehicles_Search_Results.md

mcp tool definitionjson

{
  "name": "get_marketplace_vehicles_search_results",
  "description": "Fetch Vehicles listings from the marketplace.",
  "parameters": {
    "type": "object",
    "properties": {
      "after_time": {
        "type": "string",
        "description": "query parameter"
      },
      "end_cursor": {
        "type": "string",
        "description": "query parameter"
      },
      "exact_match": {
        "type": "boolean",
        "description": "query parameter"
      },
      "before_time": {
        "type": "string",
        "description": "query parameter"
      },
      "sort_by": {
        "type": "string",
        "description": "query parameter"
      },
      "filter_location_latitude": {
        "type": "string",
        "description": "query parameter",
        "default": "40.7142"
      },
      "filter_price_upper_bound": {
        "type": "number",
        "description": "query parameter",
        "default": "214748364700"
      },
      "proxy_country": {
        "type": "string",
        "description": "query parameter"
      },
      "is_c2c_listing_only": {
        "type": "boolean",
        "description": "This field indicates whether the listings are from individual sellers only"
      },
      "filter_price_lower_bound": {
        "type": "number",
        "description": "query parameter",
        "default": "0"
      },
      "filter_location_longitude": {
        "type": "string",
        "description": "query parameter",
        "default": "-74.0064"
      },
      "filter_radius_km": {
        "type": "number",
        "description": "query parameter",
        "default": "65"
      }
    },
    "required": []
  }
}

04// parameters

Name	In	Type	Required	Description
`after_time`	query	`string`	optional
`end_cursor`	query	`string`	optional
`exact_match`	query	`boolean`	optional
`before_time`	query	`string`	optional
`sort_by`	query	`string`	optional
`filter_location_latitude`	query	`string`	optional
`filter_price_upper_bound`	query	`number`	optional
`proxy_country`	query	`string`	optional
`is_c2c_listing_only`	query	`boolean`	optional	This field indicates whether the listings are from individual sellers only
`filter_price_lower_bound`	query	`number`	optional
`filter_location_longitude`	query	`string`	optional
`filter_radius_km`	query	`number`	optional

05// responses

Response

200json

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "page_info": {
          "type": "object",
          "properties": {
            "end_cursor": {
              "type": "string"
            },
            "has_next": {
              "type": "boolean"
            }
          }
        },
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "listingUrl": {
                "type": "string"
              },
              "id": {
                "type": "string"
              },
              "primary_listing_photo": {
                "type": "object",
                "properties": {
                  "__typename": {
                    "type": "string"
                  },
                  "id": {
                    "type": "string"
                  },
                  "photo_image_url": {
                    "type": "string"
                  }
                }
              },
              "listing_price": {
                "type": "object",
                "properties": {
                  "formatted_amount": {
                    "type": "string"
                  },
                  "amount_with_offset_in_currency": {
                    "type": "string"
                  },
                  "amount": {
                    "type": "string"
                  }
                }
              },
              "strikethrough_price": {
                "nullable": true
              },
              "comparable_price": {
                "nullable": true
              },
              "comparable_price_type": {
                "nullable": true
              },
              "location": {
                "type": "object",
                "properties": {
                  "reverse_geocode": {
                    "type": "object",
                    "properties": {
                      "city": {
                        "type": "string"
                      },
                      "state": {
                        "type": "string"
                      },
                      "city_page": {
                        "type": "object",
                        "properties": {
                          "display_name": {
                            "type": "string"
                          },
                          "id": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                }
              },
              "is_hidden": {
                "type": "boolean"
              },
              "is_live": {
                "type": "boolean"
              },
              "is_pending": {
                "type": "boolean"
              },
              "is_sold": {
                "type": "boolean"
              },
              "is_viewer_seller": {
                "type": "boolean"
              },
              "min_listing_price": {
                "nullable": true
              },
              "max_listing_price": {
                "nullable": true
              },
              "marketplace_listing_category_id": {
                "type": "string"
              },
              "marketplace_listing_title": {
                "type": "string"
              },
              "custom_title": {
                "type": "string"
              },
              "custom_sub_titles_with_rendering_flags": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "subtitle": {
                      "type": "string"
                    }
                  }
                }
              },
              "origin_group": {
                "nullable": true
              },
              "listing_video": {
                "nullable": true
              },
              "parent_listing": {
                "nullable": true
              },
              "marketplace_listing_seller": {
                "type": "object",
                "properties": {
                  "__typename": {
                    "type": "string"
                  },
                  "name": {
                    "nullable": true
                  },
                  "id": {
                    "nullable": true
                  }
                }
              },
              "delivery_types": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    }
  }
}

06// pricing

$0.008per successful request

Credits are deducted from your superagnt balance on each successful call. Failed requests (4xx/5xx) are not charged.

Get started at app.superagnt.com.

08// more from Facebook

GETGet Facebook Video Post Details/get_facebook_video_post_details GETGet Facebook Posts Comments/get_facebook_post_comments_details GETGet Facebook Post Details/get_facebook_post_details GETGet Facebook Post Attachement Details/get_facebook_post_attachement_details GETGet Facebook Posts Comment Replies/get_facebook_post_comment_replies GETFetch Archive Ad Details/fetch_archive_ad_details

All Facebook endpoints See it as a tool

start calling

Point your client at https://mcp.superagnt.com/mcp and your agent has this endpoint, plus every other source on one balance.

Start free→

Facebook APIFacebook data APIget marketplace vehicles search results APIAI agents data APIFacebook APIFacebook data APIFacebook for AI agents