Marktplaats Listings API

RapidAPI2026-07-04 更新2026-07-06 收录

二手商品

信息检索

数据链接：

https://rapidapi.com/piotrv1001/api/marktplaats-listings-api 数据链接链接失效反馈

官方服务：

资源简介：

Search live Marktplaats.nl listings by keyword or category URL — get EUR prices, sellers, locations, images, categories, and full listing detail as structured JSON.

创建时间：

2026-07-04

原始信息汇总

数据集概述：Marktplaats Listings API

核心功能 该API可实时搜索荷兰最大分类广告平台 Marktplaats.nl 的在线 listings，并以结构化JSON格式返回数据。支持按关键词或粘贴完整的搜索/分类URL进行查询，并可获取单个 listing 的完整详细信息。

主要特性

快速：响应时间在几百毫秒内，直接返回结构化 JSON，无需解析HTML。
数据丰富：每条 listing 包含20+字段，如欧元价格、价格类型、描述、卖家及验证状态、GPS位置、分类、属性及图片。
灵活查询：支持关键词或完整URL查询，可自动处理分页。
详细数据：可获取图片画廊、浏览/收藏数、完整分类路径、卖家资料、配送选项及出价信息。
自愈性：对上游变化具有弹性，运行于Apify平台。

API端点

方法	端点	描述
`GET`	`/search`	按关键词或URL搜索 listings，返回一页标准化结果。
`GET`	`/detail`	获取单个listing的完整详细信息对象。

/search 请求参数

参数	类型	必填	默认值	描述
`query`	string	否*	—	自由文本搜索关键词。
`url`	string	否*	—	完整的Marktplaats搜索或分类URL（可作为`query`的替代）。
`page`	integer	否	`1`	页码（从1开始）。
`limit`	integer	否	`30`	每页结果数（1-100）。
`details`	boolean	否	`false`	是否从详情页丰富每条listing（速度较慢）。

*需提供query或url其中之一。

/detail 请求参数

参数	类型	必填	描述
`url`	string	是	Marktplaats listing (VIP) URL。

响应字段（/search）

字段	类型	描述
`id`	string	Marktplaats listing ID。
`url`	string	规范化的listing URL（可用于`/detail`）。
`title`	string	listing标题。
`description`	string	简短描述文本。
`price`	number	欧元价格（出价/免费/保留价时为`0`）。
`priceType`	string	例如 `FIXED`, `FAST_BID`, `SEE_DESCRIPTION`。
`currency`	string	始终为 `EUR`。
`sellerId`	number	卖家ID。
`sellerName`	string	卖家显示名称。
`sellerIsVerified`	boolean	卖家是否已验证。
`city` / `country`	string	listing所在地。
`latitude` / `longitude`	number	近似GPS坐标。
`date`	string	listing日期/时间戳。
`categoryId`	number	Marktplaats分类ID。
`attributes`	object	键值对属性映射（如状况、品牌等）。
`imageUrl`	string	主图URL。
`imageUrls`	array	所有缩略图URL。

/detail 额外字段 当调用/detail端点或设置details=true时，每条listing还会包含：categoryName、categoryFullName、viewCount、favoritedCount、listedSince、sellerType、sellerActiveSince、sellerPageUrl、biddingEnabled、minimumBid、shippingOptions以及全分辨率图片images画廊。