> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anysite.io/llms.txt
> Use this file to discover all available pages before exploring further.

# /surugaya/products/search

> Search the Suruga-ya (駿河屋) catalogue of new and second-hand hobby goods by keyword, product name, barcode or manufacturer part number, narrowed by category, condition, brand, genre, hardware type, shop, price range, discount against the list price, release year, market movement and stock, with six orderings. Returns product cards with the id, name, photo, kind of product, brand, release date, the price of every condition on offer, the manufacturer list price and the cheapest partner-shop price with its offer count.

**Price:** 1 credit

**⚠️ Common errors:** 422: No search scope was given, or a malformed category_id, isbn or model_number



## OpenAPI

````yaml /openapi/e-commerce-marketplaces.json post /api/surugaya/products/search
openapi: 3.1.0
info:
  title: Any Site API
  description: >+
    Any Site API provides programmatic access to data from LinkedIn, Instagram,
    Twitter, and other platforms.


    ## Authentication


    All API endpoints require an `access-token` header with a valid API token.
    Tokens can be created in the [dashboard](https://app.anysite.io/).


    ## Pricing


    Each endpoint has a credit cost listed in its description. Credits are
    deducted from your token balance per request.

  version: 0.0.1
servers: []
security:
  - AccessToken: []
paths:
  /api/surugaya/products/search:
    post:
      tags:
        - /surugaya
      summary: /surugaya/products/search
      description: >-
        Search the Suruga-ya (駿河屋) catalogue of new and second-hand hobby goods
        by keyword, product name, barcode or manufacturer part number, narrowed
        by category, condition, brand, genre, hardware type, shop, price range,
        discount against the list price, release year, market movement and
        stock, with six orderings. Returns product cards with the id, name,
        photo, kind of product, brand, release date, the price of every
        condition on offer, the manufacturer list price and the cheapest
        partner-shop price with its offer count.


        **Price:** 1 credit


        **⚠️ Common errors:** 422: No search scope was given, or a malformed
        category_id, isbn or model_number
      operationId: __api_surugaya_products_search_post
      parameters:
        - name: access-token
          in: header
          required: true
          schema:
            anyOf:
              - type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SurugayaProductsSearchPayload'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SurugayaProductCard'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    SurugayaProductsSearchPayload:
      properties:
        timeout:
          type: integer
          maximum: 1500
          minimum: 20
          default: 300
        keyword:
          anyOf:
            - type: string
              minLength: 1
            - type: 'null'
        exclude_keyword:
          anyOf:
            - type: string
              minLength: 1
            - type: 'null'
        product_title:
          anyOf:
            - type: string
              minLength: 1
            - type: 'null'
        category_id:
          anyOf:
            - type: string
            - type: 'null'
        count:
          type: integer
          maximum: 9984
          minimum: 1
        condition:
          anyOf:
            - $ref: '#/components/schemas/SurugayaCondition'
            - type: 'null'
        brand:
          anyOf:
            - type: string
            - type: 'null'
        genre:
          anyOf:
            - type: string
            - type: 'null'
        hardware_type:
          anyOf:
            - type: string
            - type: 'null'
        store_id:
          anyOf:
            - type: string
            - type: 'null'
        trend:
          anyOf:
            - $ref: '#/components/schemas/SurugayaTrend'
            - type: 'null'
        seller_scope:
          anyOf:
            - $ref: '#/components/schemas/SurugayaSellerScope'
            - type: 'null'
        price_min:
          anyOf:
            - type: integer
              minimum: 0
            - type: 'null'
        price_max:
          anyOf:
            - type: integer
              minimum: 0
            - type: 'null'
        price_ratio_min:
          anyOf:
            - type: integer
              minimum: 0
            - type: 'null'
        price_ratio_max:
          anyOf:
            - type: integer
              minimum: 0
            - type: 'null'
        release_year_min:
          anyOf:
            - type: integer
              maximum: 2200
              minimum: 1900
            - type: 'null'
        release_year_max:
          anyOf:
            - type: integer
              maximum: 2200
              minimum: 1900
            - type: 'null'
        isbn:
          anyOf:
            - type: string
            - type: 'null'
        model_number:
          anyOf:
            - type: string
            - type: 'null'
        include_out_of_stock:
          type: boolean
          default: false
        sort:
          $ref: '#/components/schemas/SurugayaSort'
          default: relevance
      type: object
      required:
        - count
    SurugayaProductCard:
      properties:
        '@type':
          type: string
          default: SurugayaProductCard
        id:
          type: string
        url:
          type: string
        name:
          anyOf:
            - type: string
            - type: 'null'
        image:
          anyOf:
            - type: string
            - type: 'null'
        product_type:
          anyOf:
            - type: string
            - type: 'null'
        brand:
          anyOf:
            - type: string
            - type: 'null'
        release_date:
          anyOf:
            - type: string
            - type: 'null'
        prices:
          items:
            $ref: '#/components/schemas/SurugayaPriceTag'
          type: array
          default: []
        price:
          anyOf:
            - type: number
            - type: 'null'
        list_price:
          anyOf:
            - type: number
            - type: 'null'
        currency:
          type: string
          default: JPY
        is_sold_out:
          type: boolean
          default: false
        is_new_arrival:
          type: boolean
          default: false
        marketplace_price:
          anyOf:
            - type: number
            - type: 'null'
        marketplace_offer_count:
          anyOf:
            - type: integer
            - type: 'null'
        marketplace_offer_label:
          anyOf:
            - type: string
            - type: 'null'
      type: object
      required:
        - id
        - url
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
      type: object
    SurugayaCondition:
      type: string
      enum:
        - new
        - used
        - preorder
    SurugayaTrend:
      type: string
      enum:
        - rising
        - price_drop
        - new_arrival
    SurugayaSellerScope:
      type: string
      enum:
        - marketplace
        - surugaya
    SurugayaSort:
      type: string
      enum:
        - relevance
        - price_asc
        - price_desc
        - updated
        - release_date_desc
        - release_date_asc
    SurugayaPriceTag:
      properties:
        '@type':
          type: string
          default: SurugayaPriceTag
        condition:
          type: string
        price:
          type: number
      type: object
      required:
        - condition
        - price
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
        msg:
          type: string
        type:
          type: string
        input: {}
        ctx:
          type: object
      type: object
      required:
        - loc
        - msg
        - type
  securitySchemes:
    AccessToken:
      type: apiKey
      in: header
      name: access-token
      description: API token from the dashboard

````