> ## Documentation Index > Fetch the complete documentation index at: https://docs.neuralverge.ai/llms.txt > Use this file to discover all available pages before exploring further. # 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. ## OpenAPI ````yaml /openapi.json post /functions/v1/run-mercari-items-search openapi: 3.0.0 info: title: NeuralVerge API version: 1.0.0 description: >- NeuralVerge API for AI research workflows, search, extraction, and structured data source execution. servers: - url: https://api.neuralverge.ai description: NeuralVerge API security: - BearerAuth: [] tags: - name: AI Research description: Research workflows and session tracking. - name: AI Extract description: Schema-driven extraction workflows. - name: AI Agents description: Reusable saved agents executed through the API. - name: Search description: Fast, synchronous web search with no session or polling. - name: Company intelligence description: Company profile lookups from company databases. - name: E-commerce & Marketplaces description: >- Product, seller, and review lookups on Amazon, eBay, Walmart, AliExpress, and Alibaba. - name: Enrichment description: Email and phone enrichment, validation, and discovery. - name: Product reviews description: >- Software and business reviews from Capterra, Gartner Peer Insights, and Trustpilot. - name: Social media description: LinkedIn profile, company, and people lookups. paths: /functions/v1/run-mercari-items-search: post: tags: - E-commerce & Marketplaces summary: Mercari Items Search description: >- 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. requestBody: required: true content: application/json: schema: type: object properties: keyword: description: Search term. e.g. iphone 15 type: string max_items: description: Max items (up to 500) type: integer minimum: 1 maximum: 500 default: 25 start_page: description: Starting page type: integer minimum: 1 sort: description: >- Sort by. Options: score = Relevance, created_time = Newest, price = Price, num_likes = Most liked type: string enum: - score - created_time - price - num_likes order: description: 'Order. Options: desc = Descending, asc = Ascending' type: string enum: - desc - asc status: description: Status type: array items: type: string enum: - on_sale - sold_out - trading category_id: description: Category ID type: integer minimum: 1 price_min: description: Min price (JPY) type: integer minimum: 0 price_max: description: Max price (JPY) type: integer minimum: 0 required: - keyword example: keyword: iphone 15 max_items: 2 responses: '200': description: Run completed. content: application/json: schema: type: object properties: session_id: type: string description: Session identifier for this run. kind: type: string description: Data source identifier for this endpoint. keyword: type: string max_items: type: integer start_page: type: integer partial: type: boolean description: >- True when the scrape stopped early and returned the records collected so far. human: type: string description: Markdown summary of the result, for display. machine: type: object properties: total_items: type: integer items: type: array items: type: object properties: '@type': type: string id: type: string url: type: string name: type: string price: type: integer currency: type: string status: type: string photo: type: string thumbnail: type: string item_type: type: string page: type: integer position: type: integer response_bytes: type: integer description: Structured result payload. total_points: type: integer description: Points charged for this run. example: 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 - **Keyword:** iphone 15 - **Max items:** 2 - **Starting page:** 1 - **Records returned:** 2 - **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 '400': description: Bad Request '401': description: Unauthorized '402': description: Payment Required '500': description: Internal Error components: securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: API Key ````