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

# Run eBay Product Reviews

> Returns buyer reviews for an eBay catalog product by ePID or URL. List endpoint: 1 point per returned record.



## OpenAPI

````yaml /openapi.json post /functions/v1/run-ebay-product-reviews
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-ebay-product-reviews:
    post:
      tags:
        - E-commerce & Marketplaces
      summary: Run eBay Product Reviews
      description: >-
        Returns buyer reviews for an eBay catalog product by ePID or URL. List
        endpoint: 1 point per returned record.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                product:
                  type: string
                  description: ePID or product URL.
                max_items:
                  type: integer
                  minimum: 1
                  maximum: 500
                  default: 10
                  description: >-
                    Maximum number of records to return (1-500). Billed at 1
                    point per returned record.
                start_page:
                  type: integer
                  minimum: 1
                  default: 1
                  description: Result page to start from.
              required:
                - product
            example:
              product: '1234567890'
              max_items: 10
      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.
                  product:
                    type: string
                  max_items:
                    type: integer
                  start_page:
                    type: integer
                  human:
                    type: string
                    description: Markdown summary of the result, for display.
                  machine:
                    type: object
                    properties:
                      total_items:
                        type: integer
                      reviews:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                            rating:
                              type: integer
                            text:
                              type: string
                            author:
                              type: string
                            created_at:
                              type: string
                            created_date: {}
                            is_verified:
                              type: boolean
                            condition:
                              type: string
                              nullable: true
                            sold_by:
                              type: string
                            helpful_count:
                              type: integer
                            is_top_favorable:
                              type: boolean
                            is_top_critical:
                              type: boolean
                      proxy_traffic_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: ebay_product_reviews
                product: '28032667767'
                max_items: 2
                start_page: 1
                human: |-
                  # eBay product reviews

                  - **Product:** 28032667767
                  - **Starting page:** 1
                  - **Max items:** 2
                  - **Records returned:** 2
                  - **Proxy traffic:** 481.5 KB
                machine:
                  total_items: 2
                  reviews:
                    - id: '10000000318520591'
                      rating: 5
                      text: >-
                        Fantastic item! Mouse works perfectly. It is better for
                        my wrist than the one I had. Did not realize how much of
                        an angle my hand was at all day. This — Fantastic item!
                        Mouse works perfectly. It is better for my wrist than
                        the one I had. Did not realize how much of an angle my
                        hand was at all day. This mouse is accurate and I love
                        the features on it. Thank you
                      author: jrstufff
                      created_at: May 31, 2024
                      created_date: null
                      is_verified: true
                      condition: null
                      sold_by: onlyonedeal
                      helpful_count: 0
                      is_top_favorable: false
                      is_top_critical: false
                    - id: '10000000283857118'
                      rating: 1
                      text: >-
                        Must have a unifying receiver to use this wireless
                        mouse. — Received the mouse and was excited to put it to
                        work.  Found out none of my existing usb receivers were
                        compatible.  Tried multiple combinations on my three
                        other M705 mice and none of them are interchangeable. 
                        Only the receiver that came with the original mouse
                        worked. Sorry this didn't work out.  Had high hopes.
                      author: pw923941kpx
                      created_at: Mar 31, 2020
                      created_date: null
                      is_verified: true
                      condition: Pre-Owned
                      sold_by: voltage_electro...
                      helpful_count: 0
                      is_top_favorable: false
                      is_top_critical: false
                  proxy_traffic_bytes: 493088
                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

````