SocialFetch

Search Facebook Marketplace listings by keyword near a latitude and longitude.

Resource: api.socialfetch.dev/v1/facebook/marketplace/search

Network: eip155:8453 · Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 · Pay to: 0x02C2fCAfCe36B4AAdB39625866Bc6B1699d83043

Payment methods: — · Last validation: 2026-09-14 12:11:00.13+00

{
  "input": {
    "type": "object",
    "required": [
      "type",
      "method"
    ],
    "properties": {
      "type": {
        "type": "string",
        "const": "http"
      },
      "method": {
        "enum": [
          "GET"
        ],
        "type": "string"
      },
      "queryParams": {
        "type": "object",
        "required": [
          "query"
        ],
        "properties": {
          "lat": {
            "type": "number",
            "maximum": 90,
            "minimum": -90,
            "description": "Latitude for the marketplace search location."
          },
          "lng": {
            "type": "number",
            "maximum": 180,
            "minimum": -180,
            "description": "Longitude for the marketplace search location."
          },
          "count": {
            "type": "integer",
            "maximum": 100,
            "minimum": 1,
            "description": "Deprecated alias for `limit`. When both are set, `limit` wins."
          },
          "limit": {
            "type": "integer",
            "maximum": 100,
            "minimum": 1,
            "description": "Optional number of listings to return (1–100). Prefer this over `count`."
          },
          "query": {
            "type": "string",
            "maxLength": 512,
            "minLength": 1,
            "description": "Search query text for marketplace listings."
          },
          "cursor": {
            "type": "string",
            "minLength": 1,
            "description": "Opaque pagination cursor returned by a previous response."
          },
          "sortBy": {
            "enum": [
              "suggested",
              "distanceAscend",
              "creationTimeDescend",
              "priceAscend",
              "priceDescend"
            ],
            "type": "string",
            "description": "Optional sort order for marketplace listings. `suggested`: Facebook's default relevance ranking. `distanceAscend`: nearest first. `creationTimeDescend`: newest listings first. `priceAscend`/`priceDescend`: lowest/highest price first."
          },
          "maxPrice": {
            "type": "number",
            "minimum": 0,
            "description": "Optional maximum listing price. Must be greater than or equal to `minPrice` when both are set."
          },
          "minPrice": {
            "type": "number",
            "minimum": 0,
            "description": "Optional minimum listing price. Must be less than or equal to `maxPrice` when both are set."
          },
          "radiusKm": {
            "type": "number",
            "description": "Optional search radius in kilometers.",
            "exclusiveMinimum": 0
          },
          "condition": {
            "enum": [
              "new",
              "usedLikeNew",
              "usedGood",
              "usedFair"
            ],
            "type": "string",
            "description": "Optional item condition filter for marketplace listings."
          },
          "dateListed": {
            "enum": [
              "1",
              "7",
              "30",
              "all",
              "last24Hours",
              "last7Days",
              "last30Days"
            ],
            "type": "string",
            "description": "Optional date-listed filter for marketplace listings. `1`/`last24Hours` both mean the last 24 hours, `7`/`last7Days` both mean the last 7 days, and `30`/`last30Days` both mean the last 30 days — these are separate values Facebook accepts for the same window; prefer the named variants (`last24Hours`, `last7Days`, `last30Days`) for clarity. `all` applies no date filter."
          },
          "availability": {
            "enum": [
              "available",
              "sold",
              "all"
            ],
            "type": "string",
            "description": "Optional availability filter for marketplace listings."
          },
          "deliveryMethod": {
            "enum": [
              "all",
              "localPickup",
              "shipping"
            ],
            "type": "string",
            "description": "Optional delivery method filter for marketplace listings."
          }
        }
      }
    },
    "additionalProperties": false
  },
  "output": {
    "type": "object",
    "required": [
      "type"
    ],
    "properties": {
      "type": {
        "type": "string"
      },
      "example": {
        "type": "object"
      }
    }
  },
  "paymentRequirements": [
    {
      "raw": {
        "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "extra": {
          "name": "USD Coin",
          "version": "2"
        },
        "payTo": "0x02C2fCAfCe36B4AAdB39625866Bc6B1699d83043",
        "amount": "14000",
        "scheme": "exact",
        "network": "eip155:8453",
        "maxTimeoutSeconds": 300
      },
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "payTo": "0x02C2fCAfCe36B4AAdB39625866Bc6B1699d83043",
      "scheme": "exact",
      "network": "eip155:8453",
      "amountAtomic": "14000"
    }
  ]
}

Source catalog records are retained separately from live endpoint observations. Sonar score, uptime, and latency are advisory metrics. CDP indexing is not inferred from validation.