分类广告列表 API

API ID 14552

在一个 JSON API 中搜索 Facebook Marketplace OLX Wallapop Leboncoin 和 Custojusto:最低价查找 价格比较 和完整列表详情

API 文档

端点

请求
返回支持的市场及其 ID、标签和国家,以便您知道可以传递给搜索端点的源值
Endpoint ID: 37262
GET https://zylalabs.com/api/14552/classifieds+listings+api/37262/list+sources
输入参数

剩余免费测试请求:3 / 3。

此端点不需要任何输入参数。

API 示例响应
JSON
{
    "data": {
        "sources": [
            {
                "country": "PT",
                "id": "olx",
                "label": "OLX"
            },
            {
                "country": "ES",
                "id": "wallapop",
                "label": "Wallapop"
            },
            {
                "country": "FR",
                "id": "leboncoin",
                "label": "Leboncoin"
            },
            {
                "country": "PT",
                "id": "custojusto",
                "label": "Custojusto"
            },
            {
                "country": "GLOBAL",
                "id": "facebook",
                "label": "Facebook Marketplace"
            }
        ]
    },
    "error": null,
    "message": "Success"
}
列表来源 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/14552/classifieds+listings+api/37262/list+sources' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
搜索单一市场(facebook、olx、wallapop、leboncoin或custojusto)并返回规范化的列表,包括价格、图片、位置和卖家
Endpoint ID: 37263
GET https://zylalabs.com/api/14552/classifieds+listings+api/37263/search+one+source
输入参数

搜索一个来源 — 端点功能

对象 描述
query 必需 Keyword search text for the listings.
category 可选 Source-specific category id to narrow the search.
location 可选 City, zip code or lat,lon depending on the source.
minPrice 可选 Minimum price in the source currency.
maxPrice 可选 Maximum price in the source currency.
sortBy 可选 One of relevance, price_asc, price_desc or date.
page 可选 Page number, default 1.
limit 可选 Results per page, default 30, maximum 100.
cursor 可选 Wallapop only: nextCursor token from the previous response.
source 必需

剩余免费测试请求:3 / 3。


输入参数

query
category
location
minPrice
maxPrice
sortBy
page
limit
cursor
API 示例响应
JSON
{
    "data": {
        "hasMore": true,
        "listings": [
            {
                "category": "Telefones e Acessorios",
                "currency": "EUR",
                "id": "custojusto:45469559",
                "images": [
                    "https://prod-images.custojusto.pt/example.jpg"
                ],
                "location": {
                    "county": "Esposende",
                    "district": "Braga"
                },
                "postedAt": "2026-10-27T13:05:33Z",
                "price": 300,
                "seller": {
                    "isCompany": false,
                    "name": "filipa07silva"
                },
                "source": "custojusto",
                "sourceId": "45469559",
                "title": "iPhone 14 Midnight 128GB com Caixa",
                "url": "https://www.custojusto.pt/braga/telemoveis/iphone-14-45469559"
            }
        ],
        "source": "custojusto",
        "total": null
    },
    "error": null,
    "message": "Success"
}
搜索一个来源 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/14552/classifieds+listings+api/37263/search+one+source?query=iphone&maxPrice=500&limit=10&source=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回一个列表的完整记录,包括所有图片和卖家信息。使用源ID用于Wallapop和Facebook,或其他来源的编码URL路径
Endpoint ID: 37264
GET https://zylalabs.com/api/14552/classifieds+listings+api/37264/get+listing+detail
输入参数

剩余免费测试请求:3 / 3。

API 示例响应
JSON
{
    "data": {
        "currency": "EUR",
        "id": "wallapop:wzvg1qglddzl",
        "images": [
            "https://cdn.wallapop.com/example.jpg"
        ],
        "price": 120,
        "seller": {
            "isCompany": false,
            "name": "maria"
        },
        "source": "wallapop",
        "title": "Sofa 3 plazas",
        "url": "https://es.wallapop.com/item/sofa-wzvg1qglddzl"
    },
    "error": null,
    "message": "Success"
}
获取挂牌详细信息 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/14552/classifieds+listings+api/37264/get+listing+detail&source=Required&/listing/=Required&id=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
粉丝同时向多个市场发出一个查询并返回一个合并的排序列表 一个失败的来源在错误中被报告而不影响请求
Endpoint ID: 37265
GET https://zylalabs.com/api/14552/classifieds+listings+api/37265/search+multiple+sources
输入参数

搜索多个来源 — 端点功能

对象 描述
query 必需 Keyword search text for the listings.
sources 可选 Comma separated sources, all five if omitted.
minPrice 可选 Minimum price in the source currency.
maxPrice 可选 Maximum price in the source currency.
limit 可选 Results per source, default 30, maximum 100.

剩余免费测试请求:3 / 3。


输入参数

query
sources
minPrice
maxPrice
limit
API 示例响应
JSON
{
    "data": {
        "count": 10,
        "errors": [],
        "listings": [
            {
                "currency": "EUR",
                "id": "olx:123",
                "price": 150,
                "source": "olx",
                "title": "Sofa de canto",
                "url": "https://www.olx.pt/d/anuncio/sofa-123"
            }
        ],
        "sources": {
            "olx": {
                "count": 5,
                "hasMore": true,
                "ok": true
            },
            "wallapop": {
                "count": 5,
                "hasMore": true,
                "ok": true
            }
        }
    },
    "error": null,
    "message": "Success"
}
搜索多个来源 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/14552/classifieds+listings+api/37265/search+multiple+sources?query=sofa&sources=olx,wallapop&limit=5' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
与多源搜索相同,但按价格升序预排序,回答当前在所有市场上最便宜的商品是什么
Endpoint ID: 37266
GET https://zylalabs.com/api/14552/classifieds+listings+api/37266/find+cheapest+listings
输入参数

查找最便宜的房源 — 端点功能

对象 描述
query 必需 Keyword search text for the listings.
sources 可选 Comma separated sources, all five if omitted.
maxPrice 可选 Maximum price in the source currency.
limit 可选 Results per source, default 30, maximum 100.

剩余免费测试请求:3 / 3。


输入参数

query
sources
maxPrice
limit
API 示例响应
JSON
{
    "data": {
        "count": 2,
        "errors": [],
        "listings": [
            {
                "currency": "EUR",
                "id": "wallapop:abc",
                "price": 210,
                "source": "wallapop",
                "title": "iPhone 13 128GB",
                "url": "https://es.wallapop.com/item/abc"
            },
            {
                "currency": "EUR",
                "id": "olx:456",
                "price": 230,
                "source": "olx",
                "title": "iPhone 13 azul",
                "url": "https://www.olx.pt/d/anuncio/456"
            }
        ]
    },
    "error": null,
    "message": "Success"
}
查找最便宜的房源 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/14552/classifieds+listings+api/37266/find+cheapest+listings?query=iphone 13&sources=olx,wallapop&maxPrice=400&limit=10' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
按市场将相同查询分组,并统计数量、最小值、最大值和平均价格,并进行总体汇总,显示物品价格最低的地方
Endpoint ID: 37267
GET https://zylalabs.com/api/14552/classifieds+listings+api/37267/compare+prices+by+source
输入参数

按来源比较价格 — 端点功能

对象 描述
query 必需 Keyword search text for the listings.
sources 可选 Comma separated sources, all five if omitted.
minPrice 可选 Minimum price in the source currency.
maxPrice 可选 Maximum price in the source currency.
limit 可选 Results per source, default 30, maximum 100.

剩余免费测试请求:3 / 3。


输入参数

query
sources
minPrice
maxPrice
limit
API 示例响应
JSON
{
    "data": {
        "bySource": {
            "olx": {
                "avg": 380.5,
                "count": 20,
                "max": 900,
                "min": 100
            },
            "wallapop": {
                "avg": 450.1,
                "count": 20,
                "max": 1200,
                "min": 85
            }
        },
        "errors": [],
        "overall": {
            "avg": 412.3,
            "count": 40,
            "max": 1200,
            "min": 85
        }
    },
    "error": null,
    "message": "Success"
}
按来源比较价格 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/14552/classifieds+listings+api/37267/compare+prices+by+source?query=iphone 13&limit=20' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回完整的Leboncoin类别树,以便您可以选择Leboncoin搜索的类别ID
Endpoint ID: 37268
GET https://zylalabs.com/api/14552/classifieds+listings+api/37268/leboncoin+categories
输入参数

剩余免费测试请求:3 / 3。

此端点不需要任何输入参数。

API 示例响应
JSON
{
    "data": {
        "categories": [
            {
                "id": "2",
                "name": "Vehicules"
            },
            {
                "id": "9",
                "name": "Immobilier"
            }
        ]
    },
    "error": null,
    "message": "Success"
}
Leboncoin 类别 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/14552/classifieds+listings+api/37268/leboncoin+categories' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回给定查询和位置的Custojusto面包屑和类别树
Endpoint ID: 37269
GET https://zylalabs.com/api/14552/classifieds+listings+api/37269/custojusto+categories
输入参数

Custojusto 类别 — 端点功能

对象 描述
query 可选 Keyword used to build the category tree.
location 可选 City name used to narrow the category tree.

剩余免费测试请求:3 / 3。


输入参数

query
location
API 示例响应
JSON
{
    "data": {
        "categories": [
            {
                "id": "telemoveis",
                "name": "Telefones e Acessorios"
            }
        ]
    },
    "error": null,
    "message": "Success"
}
Custojusto 类别 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/14552/classifieds+listings+api/37269/custojusto+categories?query=iphone' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回完整的原始OLX列表记录,包括每个图像和完整的卖家信息,用于一个列表ID或编码URL
Endpoint ID: 37270
GET https://zylalabs.com/api/14552/classifieds+listings+api/37270/olx+raw+listing+state
输入参数

OLX原始列表状态 — 端点功能

对象 描述
id 必需 OLX listing id or the URL encoded listing URL.

剩余免费测试请求:3 / 3。


输入参数

id
API 示例响应
JSON
{
    "data": {
        "id": "123456",
        "images": [
            "https://ireland.apollo.olxcdn.com/example.jpg"
        ],
        "title": "Sofa de canto",
        "user": {
            "name": "Joao"
        }
    },
    "error": null,
    "message": "Success"
}
OLX原始列表状态 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/14552/classifieds+listings+api/37270/olx+raw+listing+state?id=123456' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
在Wallapop的汽车类别中仅限于车辆搜索,可以按品牌、年份范围和价格范围进行筛选
Endpoint ID: 37271
GET https://zylalabs.com/api/14552/classifieds+listings+api/37271/wallapop+cars+search
输入参数

Wallapop 汽车搜索 — 端点功能

对象 描述
query 可选 Keyword search text for the cars.
brand 可选 Car brand to filter by.
minYear 可选 Minimum registration year.
maxYear 可选 Maximum registration year.
minPrice 可选 Minimum price in euros.
maxPrice 可选 Maximum price in euros.

剩余免费测试请求:3 / 3。


输入参数

query
brand
minYear
maxYear
minPrice
maxPrice
API 示例响应
JSON
{
    "data": {
        "hasMore": true,
        "listings": [
            {
                "currency": "EUR",
                "id": "wallapop:car1",
                "price": 9500,
                "title": "Renault Clio 2019",
                "url": "https://es.wallapop.com/item/car1"
            }
        ],
        "source": "wallapop"
    },
    "error": null,
    "message": "Success"
}
Wallapop 汽车搜索 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/14552/classifieds+listings+api/37271/wallapop+cars+search?brand=Renault&minYear=2018' --header 'Authorization: Bearer YOUR_API_KEY' 


    

API 访问密钥和身份验证

注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 分类广告列表 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。

标头
标头 描述
授权 必需 应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。

无长期承诺。随时升级、降级或取消。

起价
$10,000/年


  • 自定义数量
  • 自定义速率限制
  • 专业客户支持
  • 实时 API 监控

概览

在一个 JSON API 中搜索 Facebook Marketplace、OLX、Wallapop、Leboncoin 和 Custojusto:最便宜的查找,价格比较和完整列表详情

分类广告列表 API FAQs

Facebook 市场 OLX Wallapop Leboncoin 和 Custojusto 通过一个请求表单和一个标准化的列表对象

是的 每个响应都是在您呼叫时从市场中获取的 而不是从过时的数据库中获取的

您仍然可以从其他地方获得结果,而失败的来源则列在错误数组中 Leboncoin 和 Wallapop 使用了反机器人保护,因此可能需要偶尔重试

调用查找最低价列表的终端并进行查询 它合并所有来源并按升序排序

使用获取列表详情传递Wallapop和Facebook的sourceId或OLX、Custojusto和Leboncoin的URL编码列表路径

通过Telegram联系支持 @pintoflow 以获取有关问题 新来源 自定义字段或更高限制的信息

一般常见问题

Zyla API Hub 就像一个大型 API 商店,您可以在一个地方找到数千个 API。我们还为所有 API 提供专门支持和实时监控。注册后,您可以选择要使用的 API。请记住,每个 API 都需要自己的订阅。但如果您订阅多个 API,您将为所有这些 API 使用相同的密钥,使事情变得更简单。
价格以 USD(美元)、EUR(欧元)、CAD(加元)、AUD(澳元)和 GBP(英镑)列出。我们接受所有主要的借记卡和信用卡。我们的支付系统使用最新的安全技术,由 Stripe 提供支持,Stripe 是世界上最可靠的支付公司之一。如果您在使用卡片付款时遇到任何问题,请通过 [email protected]

此外,如果您已经以这些货币中的任何一种(USD、EUR、CAD、AUD、GBP)拥有有效订阅,该货币将保留用于后续订阅。只要您没有任何有效订阅,您可以随时更改货币。
定价页面上显示的本地货币基于您 IP 地址的国家/地区,仅供参考。实际价格以 USD(美元)为单位。当您付款时,即使您在我们的网站上看到以本地货币显示的等值金额,您的卡片对账单上也会以美元显示费用。这意味着您不能直接使用本地货币付款。
有时,银行可能会因其欺诈保护设置而拒绝收费。我们建议您首先联系您的银行,检查他们是否阻止了我们的收费。此外,您可以访问账单门户并更改关联的卡片以进行付款。如果这些方法不起作用并且您需要进一步帮助,请通过 [email protected]
价格由月度或年度订阅决定,具体取决于所选计划。
API 调用根据成功请求从您的计划中扣除。每个计划都包含您每月可以进行的特定数量的调用。只有成功的调用(由状态 200 响应指示)才会计入您的总数。这确保失败或不完整的请求不会影响您的月度配额。
Zyla API Hub 采用月度订阅系统。您的计费周期将从您购买付费计划的那一天开始,并在下个月的同一日期续订。因此,如果您想避免未来的费用,请提前取消订阅。
要升级您当前的订阅计划,只需转到 API 的定价页面并选择您要升级到的计划。升级将立即生效,让您立即享受新计划的功能。请注意,您之前计划中的任何剩余调用都不会转移到新计划,因此在升级时请注意这一点。您将被收取新计划的全部金额。
要检查您本月剩余多少 API 调用,请参考响应标头中的 "X-Zyla-API-Calls-Monthly-Remaining" 字段。例如,如果您的计划允许每月 1,000 个请求,而您已使用 100 个,则响应标头中的此字段将显示 900 个剩余调用。
要查看您的计划允许的最大 API 请求数,请检查 "X-Zyla-RateLimit-Limit" 响应标头。例如,如果您的计划包括每月 1,000 个请求,此标头将显示 1,000。
"X-Zyla-RateLimit-Reset" 标头显示您的速率限制重置之前的秒数。这告诉您何时您的请求计数将重新开始。例如,如果它显示 3,600,则意味着还有 3,600 秒直到限制重置。
是的,您可以随时通过访问您的账户并在账单页面上选择取消选项来取消您的计划。请注意,升级、降级和取消会立即生效。此外,取消后,您将不再有权访问该服务,即使您的配额中还有剩余调用。
为了让您有机会在没有任何承诺的情况下体验我们的 API,我们提供 7 天免费试用,允许您免费进行最多 50 次 API 调用。此试用只能使用一次,因此我们建议将其应用于您最感兴趣的 API。虽然我们的大多数 API 都提供免费试用,但有些可能不提供。试用在 7 天后或您进行了 50 次请求后结束,以先发生者为准。如果您在试用期间达到 50 次请求限制,您需要"开始您的付费计划"以继续发出请求。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。或者,如果您在第 7 天之前不取消订阅,您的免费试用将结束,您的计划将自动计费,授予您访问计划中指定的所有 API 调用的权限。请记住这一点以避免不必要的费用。
7 天后,您将被收取试用期间订阅的计划的全额费用。因此,在试用期结束前取消很重要。因忘记及时取消而提出的退款请求不被接受。
当您订阅 API 免费试用时,您可以进行最多 50 次 API 调用。如果您希望超出此限制进行额外的 API 调用,API 将提示您执行"开始您的付费计划"。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。
付款订单在每月 20 日至 30 日之间处理。如果您在 20 日之前提交请求,您的付款将在此时间范围内处理。
您可以通过我们的聊天渠道联系我们以获得即时帮助。我们始终在线,时间为上午 8 点至下午 5 点(EST)。如果您在该时间之后联系我们,我们将尽快回复您。此外,您可以通过 [email protected]