curl --request POST \
--url https://api.neuralverge.ai/functions/v1/run-mercari-items-search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"keyword": "iphone 15",
"max_items": 2
}
'import requests
url = "https://api.neuralverge.ai/functions/v1/run-mercari-items-search"
payload = {
"keyword": "iphone 15",
"max_items": 2
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({keyword: 'iphone 15', max_items: 2})
};
fetch('https://api.neuralverge.ai/functions/v1/run-mercari-items-search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.neuralverge.ai/functions/v1/run-mercari-items-search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'keyword' => 'iphone 15',
'max_items' => 2
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.neuralverge.ai/functions/v1/run-mercari-items-search"
payload := strings.NewReader("{\n \"keyword\": \"iphone 15\",\n \"max_items\": 2\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.neuralverge.ai/functions/v1/run-mercari-items-search")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"keyword\": \"iphone 15\",\n \"max_items\": 2\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.neuralverge.ai/functions/v1/run-mercari-items-search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"keyword\": \"iphone 15\",\n \"max_items\": 2\n}"
response = http.request(request)
puts response.read_body{
"session_id": "11111111-1111-1111-1111-111111111111",
"kind": "mercari_items_search",
"keyword": "iphone 15",
"max_items": 2,
"start_page": 1,
"partial": false,
"human": "# Mercari items search\n\n- **Keyword:** iphone 15\n- **Max items:** 2\n- **Starting page:** 1\n- **Records returned:** 2\n- **Proxy traffic:** 533.2 KB",
"machine": {
"total_items": 2,
"items": [
{
"@type": "MercariSearchItem",
"id": "m53977554531",
"url": "https://jp.mercari.com/item/m53977554531",
"name": "iPhone 15 Pro 128GB|SIMフリー",
"price": 78000,
"currency": "JPY",
"status": "on_sale",
"photo": "https://static.mercdn.net/item/detail/orig/photos/m53977554531_1.jpg?1790778955",
"thumbnail": "https://static.mercdn.net/thumb/item/webp/m53977554531_1.jpg?1790778955",
"item_type": "item",
"page": 1,
"position": 1
},
{
"@type": "MercariSearchItem",
"id": "m31273954054",
"url": "https://jp.mercari.com/item/m31273954054",
"name": "極美品 iPhone 15 128GB ブルー 本体",
"price": 70000,
"currency": "JPY",
"status": "on_sale",
"photo": "https://static.mercdn.net/item/detail/orig/photos/m31273954054_1.jpg?1790779613",
"thumbnail": "https://static.mercdn.net/thumb/item/webp/m31273954054_1.jpg?1790779613",
"item_type": "item",
"page": 1,
"position": 2
}
],
"response_bytes": 545990
},
"total_points": 2
}Mercari Items Search
Search Mercari (Japan) items by keyword with category, sort, status and price filters. Returns items with id, URL, name, price (JPY), status, thumbnail and photo. 1 point per returned record.
curl --request POST \
--url https://api.neuralverge.ai/functions/v1/run-mercari-items-search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"keyword": "iphone 15",
"max_items": 2
}
'import requests
url = "https://api.neuralverge.ai/functions/v1/run-mercari-items-search"
payload = {
"keyword": "iphone 15",
"max_items": 2
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({keyword: 'iphone 15', max_items: 2})
};
fetch('https://api.neuralverge.ai/functions/v1/run-mercari-items-search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.neuralverge.ai/functions/v1/run-mercari-items-search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'keyword' => 'iphone 15',
'max_items' => 2
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.neuralverge.ai/functions/v1/run-mercari-items-search"
payload := strings.NewReader("{\n \"keyword\": \"iphone 15\",\n \"max_items\": 2\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.neuralverge.ai/functions/v1/run-mercari-items-search")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"keyword\": \"iphone 15\",\n \"max_items\": 2\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.neuralverge.ai/functions/v1/run-mercari-items-search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"keyword\": \"iphone 15\",\n \"max_items\": 2\n}"
response = http.request(request)
puts response.read_body{
"session_id": "11111111-1111-1111-1111-111111111111",
"kind": "mercari_items_search",
"keyword": "iphone 15",
"max_items": 2,
"start_page": 1,
"partial": false,
"human": "# Mercari items search\n\n- **Keyword:** iphone 15\n- **Max items:** 2\n- **Starting page:** 1\n- **Records returned:** 2\n- **Proxy traffic:** 533.2 KB",
"machine": {
"total_items": 2,
"items": [
{
"@type": "MercariSearchItem",
"id": "m53977554531",
"url": "https://jp.mercari.com/item/m53977554531",
"name": "iPhone 15 Pro 128GB|SIMフリー",
"price": 78000,
"currency": "JPY",
"status": "on_sale",
"photo": "https://static.mercdn.net/item/detail/orig/photos/m53977554531_1.jpg?1790778955",
"thumbnail": "https://static.mercdn.net/thumb/item/webp/m53977554531_1.jpg?1790778955",
"item_type": "item",
"page": 1,
"position": 1
},
{
"@type": "MercariSearchItem",
"id": "m31273954054",
"url": "https://jp.mercari.com/item/m31273954054",
"name": "極美品 iPhone 15 128GB ブルー 本体",
"price": 70000,
"currency": "JPY",
"status": "on_sale",
"photo": "https://static.mercdn.net/item/detail/orig/photos/m31273954054_1.jpg?1790779613",
"thumbnail": "https://static.mercdn.net/thumb/item/webp/m31273954054_1.jpg?1790779613",
"item_type": "item",
"page": 1,
"position": 2
}
],
"response_bytes": 545990
},
"total_points": 2
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
Search term. e.g. iphone 15
Max items (up to 500)
1 <= x <= 500Starting page
x >= 1Sort by. Options: score = Relevance, created_time = Newest, price = Price, num_likes = Most liked
score, created_time, price, num_likes Order. Options: desc = Descending, asc = Ascending
desc, asc Status
on_sale, sold_out, trading Category ID
x >= 1Min price (JPY)
x >= 0Max price (JPY)
x >= 0Response
Run completed.
Session identifier for this run.
Data source identifier for this endpoint.
True when the scrape stopped early and returned the records collected so far.
Markdown summary of the result, for display.
Structured result payload.
Show child attributes
Show child attributes
Points charged for this run.