> ## 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 Item

> Get a Mercari (Japan) item by id or URL: title, description, price in JPY, status (on sale / sold out), photos, brand, category path, condition, shipping payer/method/origin/days, likes, comments, seller (name, reviews, star rating, verified) and item features. Flat 5 points per successful run.



## OpenAPI

````yaml /openapi.json post /functions/v1/run-mercari-items
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:
    post:
      tags:
        - E-commerce & Marketplaces
      summary: Mercari Item
      description: >-
        Get a Mercari (Japan) item by id or URL: title, description, price in
        JPY, status (on sale / sold out), photos, brand, category path,
        condition, shipping payer/method/origin/days, likes, comments, seller
        (name, reviews, star rating, verified) and item features. Flat 5 points
        per successful run.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                item:
                  description: Item ID or URL. e.g. m47341865350
                  type: string
              required:
                - item
            example:
              item: m47341865350
      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.
                  item:
                    type: string
                  human:
                    type: string
                    description: Markdown summary of the result, for display.
                  machine:
                    type: object
                    properties:
                      item:
                        type: object
                        properties:
                          '@type':
                            type: string
                          id:
                            type: string
                          url:
                            type: string
                          name:
                            type: string
                          description:
                            type: string
                          price:
                            type: integer
                          currency:
                            type: string
                          status:
                            type: string
                          photos:
                            type: array
                            items:
                              type: string
                          thumbnails:
                            type: array
                            items:
                              type: string
                          seller:
                            type: object
                            properties:
                              '@type':
                                type: string
                              id:
                                type: integer
                              name:
                                type: string
                              photo:
                                type: string
                              rating_count:
                                type: integer
                              star_rating_score:
                                type: integer
                              is_verified:
                                type: boolean
                              badges:
                                type: array
                                items: {}
                              url:
                                type: string
                          category:
                            type: object
                            properties:
                              '@type':
                                type: string
                              id:
                                type: integer
                              name:
                                type: string
                              parent_id:
                                type: integer
                              parent_name:
                                type: string
                              root_id:
                                type: integer
                              root_name:
                                type: string
                          brand:
                            type: object
                            properties:
                              id:
                                type: integer
                              name:
                                type: string
                          condition:
                            type: object
                            properties:
                              '@type':
                                type: string
                              id: {}
                              name:
                                type: string
                              subname:
                                type: string
                          shipping_payer:
                            type: string
                          shipping_method: {}
                          shipping_from: {}
                          shipping_days: {}
                          like_count:
                            type: integer
                          comment_count:
                            type: integer
                          hash_tags:
                            type: array
                            items: {}
                          features:
                            type: array
                            items: {}
                          posted_ago:
                            type: string
                          auction: {}
                          created_at: {}
                          updated_at: {}
                          meta_title:
                            type: string
                          localized_title: {}
                          localized_description: {}
                      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_item
                item: m47341865350
                human: |-
                  # Mercari item

                  - **Item:** m47341865350
                  - **Proxy traffic:** 590.5 KB
                  - **Title:** Apple iPhone 12 mini本体 パープル
                  - **Brand:** Apple
                  - **Price:** 20000 JPY
                  - **Status:** sold_out
                machine:
                  item:
                    '@type': MercariItem
                    id: m47341865350
                    url: https://jp.mercari.com/item/m47341865350
                    name: Apple iPhone 12 mini本体 パープル
                    description: |-
                      値下げ不可

                      デュアルカメラシステムを搭載した、鮮やかなパープルカラーのiPhone 12mini本体です。

                      - ブランド: Apple
                      - モデル: iPhone 12mini
                      - カラー: パープル
                      - カメラ構成: デュアルカメラ
                      -SIMフリー
                      -バッテリー容量74%
                      -64GB

                      動作不良など無し
                      画面割れや修復歴ありません。

                      ご覧いただきありがとうございます。
                    price: 20000
                    currency: JPY
                    status: sold_out
                    photos:
                      - >-
                        https://static.mercdn.net/item/detail/orig/photos/m47341865350_1.jpg?1790505176
                      - >-
                        https://static.mercdn.net/item/detail/orig/photos/m47341865350_2.jpg?1790505176
                    thumbnails:
                      - >-
                        https://static.mercdn.net/thumb/item/webp/m47341865350_1.jpg?1790505176
                      - >-
                        https://static.mercdn.net/thumb/item/webp/m47341865350_2.jpg?1790505176
                    seller:
                      '@type': MercariSeller
                      id: 475131661
                      name: かず
                      photo: >-
                        https://static.mercdn.net/thumb/members/webp/475131661.jpg?1588474611
                      rating_count: 17
                      star_rating_score: 5
                      is_verified: true
                      badges: []
                      url: https://jp.mercari.com/user/profile/475131661
                    category:
                      '@type': MercariItemCategory
                      id: 859
                      name: スマートフォン本体
                      parent_id: 100
                      parent_name: スマートフォン・携帯電話
                      root_id: 7
                      root_name: スマホ・タブレット・パソコン
                    brand:
                      id: 3272
                      name: Apple
                    condition:
                      '@type': MercariItemCondition
                      id: null
                      name: 目立った傷や汚れなし
                      subname: 細かな使用感・傷・汚れはあるが、目立たない
                    shipping_payer: 送料込み
                    shipping_method: null
                    shipping_from: null
                    shipping_days: null
                    like_count: 44
                    comment_count: 11
                    hash_tags: []
                    features: []
                    posted_ago: 6時間前
                    auction: null
                    created_at: null
                    updated_at: null
                    meta_title: Apple iPhone 12 mini本体 パープル - メルカリ
                    localized_title: null
                    localized_description: null
                  response_bytes: 604677
                total_points: 5
        '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

````