Marketplace Arama

GET/v1/facebook/marketplace/search1 kredi

Bir konumun çevresindeki Facebook Marketplace ilanlarında arama yapar; her ilanın başlığını, fiyatını, konumunu, fotoğrafını ve durumunu döndürür.

01Sorgu parametreleri

Ad	Tür	Açıklama
queryzorunlu	string	Aranacak anahtar kelime.
latzorunlu	number	Arama merkezinin enlemi, -90 ile 90 arası.
lngzorunlu	number	Arama merkezinin boylamı, -180 ile 180 arası.
category_idisteğe bağlı	string	Sayısal bir Marketplace kategori id'si (ilanlarda `category_id` olarak gelir).
radius_kmisteğe bağlı	number	Kilometre cinsinden arama yarıçapı, en fazla 500.
min_priceisteğe bağlı	number	En düşük fiyat.
max_priceisteğe bağlı	number	En yüksek fiyat.
sort_byisteğe bağlı	string	Sonuçların sıralaması.Kabul edilen değerler:`suggesteddistance_ascendcreation_time_descendprice_ascendprice_descend`
delivery_methodisteğe bağlı	string	Teslimat filtresi.Kabul edilen değerler:`alllocal_pickupshipping`
conditionisteğe bağlı	string	Ürün durumu filtresi.Kabul edilen değerler:`newused_like_newused_goodused_fair`
date_listedisteğe bağlı	string	Son 1, 7 ya da 30 gün içinde yayınlananlar (`1` ile `last_24_hours` aynı anlama gelir; diğerleri de öyle).Kabul edilen değerler:`all1730last_24_hourslast_7_dayslast_30_days`
availabilityisteğe bağlı	string	Satış durumu filtresi.Kabul edilen değerler:`availablesoldall`
cursoristeğe bağlı	string	Önceki sayfadaki `cursor` değeri.

02İstek

curl "https://api.scrapesocial.ai/v1/facebook/marketplace/search?query=bike&lat=30.2677&lng=-97.7475" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Yanıtlar

API'nin gerçek yanıtları. Listeler 2 öğeye kısaltılmıştır.

GET /v1/facebook/marketplace/search?query=bike&lat=30.2677&lng=-97.7475

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "listings": [
    {
      "id": "4498962133715634",
      "url": "https://www.facebook.com/marketplace/item/4498962133715634/",
      "title": "Roadmaster Bike",
      "creation_time": "2026-10-16T12:52:50.000Z",
      "listing_date_text": "Listed 1 week ago",
      "mileage": null,
      "custom_subtitles": [],
      "price": {
        "formatted_amount": "$60",
        "amount_with_offset_in_currency": 6000,
        "amount": 60
      },
      "strikethrough_price": null,
      "location": {
        "city": "Austin",
        "state": "TX",
        "display_name": "Austin, Texas",
        "city_page_id": "106224666074625"
      },
      "primary_photo": {
        "id": "1420646603548194",
        "url": "https://scontent.fedo1-1.fna.fbcdn.net/v/t39.84726-6/853884342_1420646606881527_2693364933188619938_n.jpg?stp=c89.0.540.540a_dst-jpg_p180x540_tt6&_nc_cat=100&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=92e707&_nc_ohc=cOXWeGUYhlQQ7kNvwEMJn9f&_nc_oc=AdqKATVw73erooguKDKHrjw8vnOMMZA3uUwRjCnT4Y23Vhy7RDjQG10t6t0mC7Nn_U8&_nc_zt=14&_nc_ht=scontent.fedo1-1.fna&_nc_gid=iUcqSLdtqJmFlP-2QVZ5FA&_nc_ss=7b289&oh=0…"
      },
      "category_id": "1658310421102081",
      "is_hidden": false,
      "is_live": true,
      "is_pending": false,
      "is_sold": false,
      "is_viewer_seller": false,
      "delivery_types": [
        "IN_PERSON"
      ],
      "story_type": "POST",
      "story_key": "28118784927798629"
    },
    {
      "id": "28921894767476661",
      "url": "https://www.facebook.com/marketplace/item/28921894767476661/",
      "title": "Kids bike",
      "creation_time": "2026-10-22T13:04:59.000Z",
      "listing_date_text": "Listed 3 days ago",
      "mileage": null,
      "custom_subtitles": [],
      "price": {
        "formatted_amount": "$50",
        "amount_with_offset_in_currency": 5000,
        "amount": 50
      },
      "strikethrough_price": null,
      "location": {
        "city": "Austin",
        "state": "TX",
        "display_name": "Dessau, Texas",
        "city_page_id": "106600749373884"
      },
      "primary_photo": {
        "id": "1900393394653895",
        "url": "https://scontent.fedo1-1.fna.fbcdn.net/v/t39.84726-6/857233002_1900393407987227_4917888034339255672_n.jpg?stp=c316.0.540.540a_dst-jpg_p180x540_tt6&_nc_cat=108&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=92e707&_nc_ohc=pQ8SQv6XoxEQ7kNvwFgMrhb&_nc_oc=AdqXuFkkUCczEr7wSeZRi8XMBKs6NsZmuWL3NlsmKovqGPeCVszQZ-hAG_ikoAbiNS0&_nc_zt=14&_nc_ht=scontent.fedo1-1.fna&_nc_gid=iUcqSLdtqJmFlP-2QVZ5FA&_nc_ss=7b289&oh=…"
      },
      "category_id": "1658310421102081",
      "is_hidden": false,
      "is_live": true,
      "is_pending": false,
      "is_sold": false,
      "is_viewer_seller": false,
      "delivery_types": [
        "IN_PERSON"
      ],
      "story_type": "POST",
      "story_key": "39386688810975374"
    }
  ],
  "cursor": "eyJwZyI6MCwiYjJjIjp7ImJyIjoiIiwiaXQiOjAsImhtc3IiOmZhbHNlLCJ0YmkiOjB9LCJjMmMiOnsiYnIiOiJBYnB0M0RyYVAta1Z4RDJJbDZ2RHFqSzl0ak9rWmhZcmhMZWtQaFZlUmk2dmtmLW56OWFxVXdranhmSXg3ZEZJU3JaS3E3UzlrMzJiNTVtVllIdndEQTVPM1BwWFpSVnZ6aGg2d1Z2YjZmRkstRkstOXRiT3U2bl9JYS1aZFU5Z0FQbF9mTHlXOXZtVjFUNG9VXzV5ZzFXcHBRd2h5RG5nSnlFb1FWUExTX3QwbEFmZ0tPSWVGUHNlM0JsVy1nVmczOGxxSTVEaDJxc2VHX3U3cmlab1JUMDd6RUxrNmx0ZUpBOXJfZ05Fd3lr…",
  "has_next_page": true
}

Tüm uç noktalarda ortak

Her rota bunları döndürebilir: eksik ya da hatalı anahtar, biten kredi, yanıt vermeyen platform ya da bizim tarafımızdaki bir hata. Hiçbiri kredi harcamaz.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notlar

Sayfa başına en fazla 24 ilan döner; `has_next_page` true olduğu sürece yanıttaki `cursor` değerini geri gönderin. İlan bulunamayan bir arama 0 krediyle boş liste döndürür. Geçersiz filtre değerleri ücretsiz bir 400 ile reddedilir. İlan içermeyen bir sayfa aramayı bitirir: `has_next_page` false, `cursor` null olur.

05Hatalar ve krediler

Her hatada success: false ve gerçek bir HTTP durum kodu döner; kredi düşmez.

400missing_parameter
Zorunlu bir parametre eksik veya geçersiz.
403private_account
Hesap gizli ya da yaş kısıtlamalı.
404not_found
Böyle bir hesap yok.
503upstream_error
Platform şu an cevap vermiyor; tekrar deneyin.