> ## Documentation Index
> Fetch the complete documentation index at: https://agnt.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Marketplace Search Results

> 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.



## OpenAPI

````yaml /openapi/facebook.openapi.json get /v1/data/facebook/get_facebook_marketplace_items_listing
openapi: 3.0.0
info:
  title: agntdata Facebook API
  description: >-
    Unlock Facebook data effortlessly with our powerful scraping tools. Extract
    page names, URLs, contact info, likes, followers, posts, comments,
    Marketplace listings, and meta ads metrics. Perfect for market research,
    trend analysis, and optimizing marketing strategies.
  version: 1.0.0
  contact:
    name: agntdata
    url: https://agntdata.dev
servers:
  - url: https://api.agntdata.dev
    description: agntdata API
security:
  - ApiKeyAuth: []
tags:
  - name: Facebook Marketplace Listings
    description: ''
  - name: Facebook Posts Details
    description: ''
  - name: Facebook Search
    description: >-
      The Facebook Search API group provides a comprehensive set of endpoints to
      perform various types of searches across Facebook data, including posts,
      pages, people, and places. These endpoints enable users to retrieve
      targeted information based on specific query parameters and filters such
      as location, user identifiers, and other relevant attributes.
  - name: Meta Ads Library Search
    description: >-
      The Meta Ads Library Search allows you to search and retrieve detailed
      information from Meta’s Ad Library, providing insights into active and
      inactive ad campaigns across Facebook and Instagram. This tool is ideal
      for marketing analysis, competitor research, and understanding ad
      strategies.
  - name: Facebook Pages Details/Posts
    description: ''
  - name: 'Facebook Groups Details/Posts '
    description: ''
  - name: Facebook Download Media
    description: >-
      Download media (images, videos, audio) from Facebook URLs. Returns file
      size in MB and media type.
paths:
  /v1/data/facebook/get_facebook_marketplace_items_listing:
    get:
      tags:
        - Facebook Marketplace Listings
      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.
      operationId: Get_Marketplace_Search_Results
      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:


            - 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.
        - 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:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Get_facebook_get_facebook_marketplace_items_listing_Response
        '400':
          description: Bad request
        '401':
          description: Unauthorized - invalid API key
        '429':
          description: Rate limit exceeded
      security:
        - ApiKeyAuth: []
components:
  schemas:
    Get_facebook_get_facebook_marketplace_items_listing_Response:
      type: object
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        Bearer token. Pass your agntdata API key as: Authorization: Bearer
        agnt_live_...

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.