API Facebook

Facebook Marketplace API

Cherchez des annonces Facebook Marketplace par mot-clé près d’un lieu, filtrez par prix, état, livraison, ancienneté et disponibilité, et obtenez titre, prix, lieu et image en JSON normalisé.

1,20 $US/1k req, paiement à la requête, sans abonnement.

fMarketplace | Facebook
facebook.com/marketplace

Results for "bike"

PriceLocationCategory

$285

Trek FX 2 Hybrid Bike - Size Medium

Austin, TX

Ce que l’API a renvoyélistings[0]
{
"id": "1029384756102938",
"url": "https://www.facebook.com/marketplace/item/1029384756102938/",
"title": "Trek FX 2 Hybrid Bike - Size Medium",
"priceFormatted": "$285",
"priceAmount": 285,
"locationName": "Austin, TX",
"photoUrl": "https://scontent.xx.fbcdn.net/v/t45.5328-4/marketplace_1029384756102938.jpg",
"isSold": false,
... 11 champs de plus
}
Disponibilité
99,98%
30d · 14 955 appels
Requêtes
15 020
30 j · par semaine, 12 dernières sem.
Réponse
2,1s
médiane · 30d

Tarifs et fournisseurs

Tarifs de l’API Facebook Marketplace : une API, 2 fournisseurs interchangeables

Le fournisseur le moins cher répond en premier. S’il échoue, le suivant prend le relais dans le même appel.

Vous payez
12,00 $US
1,20 $US/1k req, seulement pour ce que vous utilisez. Aucun forfait mensuel.
Vos 83 premières requêtes sont gratuites avec le solde de départ de 0,10 $US.

Essayer

Obtenez Facebook Marketplace en une requête

Ouvrir dans
Obtenir une clé gratuite
Exemple de réponse
Les exécutions gratuites ne renvoient que les 3 premiers résultats. Alimentez une clé pour obtenir la réponse complète.

Cet exemple affiche 24 champs sur 25. Voir tous les champs

{
  "found": true,
  "data": {
    "nextCursor": "AbYq2_marketplace_cursor_04",
    "hasNextPage": true,
    "listings": [
      {
        "id": "1029384756102938",
        "url": "https://www.facebook.com/marketplace/item/1029384756102938/",
        "title": "Trek FX 2 Hybrid Bike - Size Medium",
        "priceFormatted": "$285",
        "priceAmount": 285,
        "locationName": "Austin, TX",
        "photoUrl": "https://scontent.xx.fbcdn.net/v/t45.5328-4/marketplace_1029384756102938.jpg",
        "isSold": false,
        "createdUtc": 1790884800,
        "listingDateText": "Listed 4 days ago",
        "city": "Austin",
        "state": "Texas",
        "cityPageId": "110683425619321",
        "photoId": "5920184736501928",
        "categoryId": "1020384756192837",
        "deliveryTypes": [
          "IN_PERSON",
          "SHIPPING"
        ],
        "isLive": true,
        "isPending": false,
        "isHidden": false
      },
      {
        "id": "2938475610293847",
        "url": "https://www.facebook.com/marketplace/item/2938475610293847/",
        "title": "Kids 20 inch BMX Bike - Barely Used",
        "priceFormatted": "$120",
        "priceAmount": 120,
        "locationName": "Round Rock, TX",
        "photoUrl": "https://scontent.xx.fbcdn.net/v/t45.5328-4/marketplace_2938475610293847.jpg",
        "isSold": false,
        "createdUtc": 1791057600,
        "listingDateText": "Listed 2 days ago",
        "city": "Round Rock",
        "state": "Texas",
        "cityPageId": "129384756019283",
        "photoId": "6019283746501928",
        "categoryId": "1020384756192837",
        "deliveryTypes": [
          "IN_PERSON"
        ],
        "isLive": true,
        "isPending": false,
        "isHidden": false
      }
    ]
  }
}

Référence complète des paramètres et de la réponse : chaque champ, type et exemple de cet endpoint.

Référence

Une requête, une seule forme de réponse.

Chaque champ que vous envoyez et chaque champ que vous recevez, avec un vrai exemple.

Dernière vérification : 2026-11-21 · disponibilité et latence mesurées sur 30d

Corps de la requête

JSON, envoyé à cet endpoint.

  • latstring

    30.2677

    Latitude du lieu de recherche (p. ex. '30.2677').

  • lngstring

    -97.7475

    Longitude du lieu de recherche (p. ex. '-97.7475').

  • querystring

    bike

    Mot-clé de recherche pour des annonces Marketplace (p. ex. 'bike').

  • availabilityenum

    Filtre par disponibilité : available (par défaut), sold ou all (p. ex. sold).

  • conditionenum

    Ne renvoie que les annonces dans cet état (p. ex. used_good).

  • cursorstring

    Curseur de pagination issu d’une réponse précédente pour récupérer la page suivante.

  • dateListedenum

    Ne renvoie que les annonces publiées dans cette fenêtre (p. ex. last_7_days).

  • deliveryMethodenum

    Ne renvoie que les annonces proposant ce mode de livraison (p. ex. shipping).

  • priceMaxinteger

    500

    Prix maximal de l’annonce en unités entières de la devise, p. ex. 500 pour 500 $ US. Facebook peut mélanger quelques annonces suggérées hors de la fourchette.

  • priceMininteger

    100

    Prix minimal de l’annonce en unités entières de la devise, p. ex. 100 pour 100 $ US. Facebook peut mélanger quelques annonces suggérées hors de la fourchette.

  • sortenum

    Ordre de tri des annonces renvoyées (p. ex. price_ascend).

Vous envoyez. Un petit corps JSON. Les valeurs affichées sont des exemples à remplacer par les vôtres.

Réponse

JSON, une valeur d’exemple par champ.

datadata
  • hasNextPageboolean

    true

  • nextCursorstring

    AbYq2_marketplace_cursor_04

    Opaque cursor for the next page of listings, or null when this lane has no more. Pass it back as cursor to continue.

each listingdata.listings[]
  • categoryIdstring

    1020384756192837

    Numeric Facebook Marketplace category id, as a string.

  • citystring

    Austin

    City the listing is located in.

  • cityPageIdstring

    110683425619321

    Numeric Facebook id of the city page, as a string.

  • createdUtcnumber

    1790884800

    UTC epoch timestamp in seconds (Unix time) the listing was created. Multiply by 1000 for a JS Date in milliseconds. Null when the source does not report it.

  • deliveryTypesstring[]

    Delivery options the seller offers, e.g. "IN_PERSON" or "SHIPPING".

  • idstring

    1029384756102938

    Populated whenever the provider has data for the entity.

  • isHiddenboolean

    false

    Whether the listing is hidden.

  • isLiveboolean

    true

    Whether the listing is currently live.

  • isPendingboolean

    false

    Whether the listing is marked pending.

  • isSoldboolean

    false

  • listingDateTextstring

    Listed 4 days ago

    Human-readable listing age Facebook shows, e.g. "Listed 2 weeks ago".

  • locationNamestring

    Austin, TX

    Populated whenever the provider has data for the entity.

  • photoIdstring

    5920184736501928

    Numeric Facebook id of the listing's primary photo, as a string.

  • photoUrlstring

    https://scontent.xx.fbcdn.net/v/t45.5328-4/marketplace_1029384756102938.jpg

    Populated whenever the provider has data for the entity.

  • priceAmountnumber

    285

    Populated whenever the provider has data for the entity.

  • priceFormattedstring

    $285

    Populated whenever the provider has data for the entity.

  • statestring

    Texas

    State or region the listing is located in.

  • titlestring

    Trek FX 2 Hybrid Bike - Size Medium

    Populated whenever the provider has data for the entity.

  • urlstring

    https://www.facebook.com/marketplace/item/1029384756102938/

    Populated whenever the provider has data for the entity.

top level
  • foundboolean

    true

  • reason"not_found"

    Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.

Vous recevez. Des champs nommés et typés, dans la même forme quelle que soit la source qui répond.

FAQ

À propos de l’API Facebook Marketplace

L’API Facebook Marketplace d’AnyAPI renvoie des données Facebook en JSON normalisé à partir d’un appel POST à /v1/run/facebook.marketplace. Cherchez des annonces Facebook Marketplace par mot-clé près d’un lieu, filtrez par prix, état, livraison, ancienneté et disponibilité, et obtenez titre, prix, lieu et image en JSON normalisé. AnyAPI route chaque requête sur 2 sources et bascule automatiquement quand l’une échoue. Elle coûte à partir de 1,20 $US pour 1 000 requêtes, en dollars US, sans abonnement et sans minimum mensuel. Ces 30 derniers jours, 100,0% des appels Facebook Marketplace passés par AnyAPI ont réussi, avec un temps de réponse médian de 2,1 secondes, sur 14 955 appels mesurés.

Elle coûte à partir de 1,20 $US pour 1 000 requêtes, en dollars US, sans abonnement et sans minimum mensuel. Vous alimentez un portefeuille en USD et chaque appel le débite. Certaines requêtes échouées financées par le portefeuille entraînent des frais de traitement que nous répercutons au prix coûtant, sans marge ; la réponse d’erreur indique le montant facturé.

Cherchez des annonces Facebook Marketplace par mot-clé près d’un lieu, filtrez par prix, état, livraison, ancienneté et disponibilité, et obtenez titre, prix, lieu et image en JSON normalisé. La réponse est du JSON normalisé avec la même enveloppe que celle de tous les endpoints AnyAPI, donc analyser un second endpoint revient à changer l’URL et rien d’autre.

Ces 30 derniers jours, 100,0% des appels Facebook Marketplace passés par AnyAPI ont réussi, avec un temps de réponse médian de 2,1 secondes, sur 14 955 appels mesurés. Ce sont les propres mesures d’AnyAPI du trafic passant par la passerelle, recalculées en continu, et non un objectif de niveau de service publié.

Oui. Un nouveau compte AnyAPI démarre avec 0,10 $US de solde gratuit, sans carte, ce qui couvre 83 appels Facebook Marketplace à 0,0012 $US chacun.

AnyAPI interroge la suivante de ses 2 sources dans la même requête, la moins chère d’abord, donc la panne d’une source ne fait pas échouer votre appel.

Envoyez une requête POST à https://api.getanyapi.com/v1/run/facebook.marketplace avec votre clé AnyAPI dans un en-tête « Authorization: Bearer » et l’entrée en corps JSON. La même clé et le même portefeuille fonctionnent sur tous les endpoints AnyAPI.

Non. Vous ajoutez des dollars US à un solde AnyAPI prépayé unique et chaque requête le débite. Il n’y a ni forfait mensuel ni minimum, et le même solde paie tous les endpoints AnyAPI.

Oui. Installez @getanyapi/sdk depuis npm pour TypeScript ou getanyapi depuis pip pour Python. Les deux appellent chaque endpoint AnyAPI avec la même clé, et n’importe quel client HTTP fonctionne aussi.

Oui. Un agent peut se connecter au serveur MCP d’AnyAPI à https://api.getanyapi.com/mcp, ou créer sa propre clé d’essai gratuit avec un seul POST non authentifié vers https://api.getanyapi.com/agent/signup et appeler cet endpoint en HTTP.