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

# /paypayfleamarket/items/search

> Search Yahoo!フリマ (formerly PayPay フリマ) listings across the whole marketplace filter surface: free-text keyword restricted to a single field if needed, category, brand, seller, product catalogue entry, hashtag, on-sale or sold state, declared condition, price range in yen, fashion facets (gender, clothing, shoe and kids sizes, how many times the item was worn, colour family), first-time listings, countdown-campaign listings, branded-only, suspected counterfeits excluded, bulk-purchase listings and listings native to Yahoo!フリマ against those cross-listed from Yahoo! Auctions. Each result carries the price and the price it was marked down from, condition, like count, category path, brand, hashtags and the seller's rating.

**Price:** 1 credit

**⚠️ Common errors:** 422: No search scope given (keyword, category_ids, brand_ids, seller_ids, catalog_ids or hashtag)



## OpenAPI

````yaml /openapi/e-commerce-marketplaces.json post /api/paypayfleamarket/items/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/paypayfleamarket/items/search:
    post:
      tags:
        - /paypayfleamarket
      summary: /paypayfleamarket/items/search
      description: >-
        Search Yahoo!フリマ (formerly PayPay フリマ) listings across the whole
        marketplace filter surface: free-text keyword restricted to a single
        field if needed, category, brand, seller, product catalogue entry,
        hashtag, on-sale or sold state, declared condition, price range in yen,
        fashion facets (gender, clothing, shoe and kids sizes, how many times
        the item was worn, colour family), first-time listings,
        countdown-campaign listings, branded-only, suspected counterfeits
        excluded, bulk-purchase listings and listings native to Yahoo!フリマ
        against those cross-listed from Yahoo! Auctions. Each result carries the
        price and the price it was marked down from, condition, like count,
        category path, brand, hashtags and the seller's rating.


        **Price:** 1 credit


        **⚠️ Common errors:** 422: No search scope given (keyword, category_ids,
        brand_ids, seller_ids, catalog_ids or hashtag)
      operationId: __api_paypayfleamarket_items_search_post
      parameters:
        - name: access-token
          in: header
          required: true
          schema:
            anyOf:
              - type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PaypayfleamarketItemsSearchPayload'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/PaypayfleamarketItemCard'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    PaypayfleamarketItemsSearchPayload:
      properties:
        timeout:
          type: integer
          maximum: 1500
          minimum: 20
          default: 300
        status:
          $ref: '#/components/schemas/PaypayfleamarketItemStatus'
          default: all
        conditions:
          items:
            $ref: '#/components/schemas/PaypayfleamarketCondition'
          type: array
          default: []
        price_min:
          anyOf:
            - type: integer
              minimum: 0
            - type: 'null'
        price_max:
          anyOf:
            - type: integer
              minimum: 0
            - type: 'null'
        sort:
          $ref: '#/components/schemas/PaypayfleamarketSort'
          default: ranking
        order:
          anyOf:
            - $ref: '#/components/schemas/PaypayfleamarketOrder'
            - type: 'null'
        gender:
          items:
            $ref: '#/components/schemas/PaypayfleamarketGender'
          type: array
          default: []
        clothing_size:
          items:
            $ref: '#/components/schemas/PaypayfleamarketClothingSize'
          type: array
          default: []
        shoe_size:
          items:
            $ref: '#/components/schemas/PaypayfleamarketShoeSize'
          type: array
          default: []
        kids_size:
          items:
            $ref: '#/components/schemas/PaypayfleamarketKidsSize'
          type: array
          default: []
        wear_count:
          items:
            $ref: '#/components/schemas/PaypayfleamarketWearCount'
          type: array
          default: []
        color:
          items:
            $ref: '#/components/schemas/PaypayfleamarketColor'
          type: array
          default: []
        keyword:
          type: string
          default: ''
        query_target:
          anyOf:
            - $ref: '#/components/schemas/PaypayfleamarketQueryTarget'
            - type: 'null'
        category_ids:
          items:
            type: integer
          type: array
          default: []
        brand_ids:
          items:
            type: integer
          type: array
          default: []
        seller_ids:
          items:
            type: string
          type: array
          default: []
        catalog_ids:
          items:
            type: string
          type: array
          default: []
        hashtag:
          type: string
          default: ''
        first_submit:
          anyOf:
            - type: boolean
            - type: 'null'
        count_down_campaign:
          anyOf:
            - type: boolean
            - type: 'null'
        has_brand:
          anyOf:
            - type: boolean
            - type: 'null'
        except_suspected_fake:
          anyOf:
            - type: boolean
            - type: 'null'
        include_bulk:
          anyOf:
            - type: boolean
            - type: 'null'
        sparkle_submit:
          anyOf:
            - type: boolean
            - type: 'null'
        count:
          type: integer
          minimum: 1
      type: object
      required:
        - count
    PaypayfleamarketItemCard:
      properties:
        '@type':
          type: string
          default: PaypayfleamarketItemCard
        id:
          type: string
        url:
          type: string
        name:
          type: string
        price:
          anyOf:
            - type: number
            - type: 'null'
        price_before_discount:
          anyOf:
            - type: number
            - type: 'null'
        status:
          anyOf:
            - type: string
            - type: 'null'
        condition:
          anyOf:
            - type: string
            - type: 'null'
        condition_name:
          anyOf:
            - type: string
            - type: 'null'
        image:
          anyOf:
            - type: string
            - type: 'null'
        image_count:
          anyOf:
            - type: integer
            - type: 'null'
        like_count:
          anyOf:
            - type: integer
            - type: 'null'
        opened_at:
          anyOf:
            - type: integer
            - type: 'null'
        ended_at:
          anyOf:
            - type: integer
            - type: 'null'
        category:
          anyOf:
            - $ref: '#/components/schemas/PaypayfleamarketCategoryRef'
            - type: 'null'
        category_path:
          items:
            $ref: '#/components/schemas/PaypayfleamarketCategoryRef'
          type: array
          default: []
        category_url:
          anyOf:
            - type: string
            - type: 'null'
        product_category_id:
          anyOf:
            - type: integer
            - type: 'null'
        brand:
          anyOf:
            - $ref: '#/components/schemas/PaypayfleamarketBrandRef'
            - type: 'null'
        catalog_id:
          anyOf:
            - type: string
            - type: 'null'
        hashtags:
          items:
            type: string
          type: array
          default: []
        seller:
          anyOf:
            - $ref: '#/components/schemas/PaypayfleamarketUserRef'
            - type: 'null'
        is_price_down:
          anyOf:
            - type: boolean
            - type: 'null'
        is_first_submit:
          anyOf:
            - type: boolean
            - type: 'null'
        is_sparkle_submit:
          anyOf:
            - type: boolean
            - type: 'null'
        is_count_down_campaign_target:
          anyOf:
            - type: boolean
            - type: 'null'
        is_bulk_purchase_item:
          anyOf:
            - type: boolean
            - type: 'null'
      type: object
      required:
        - id
        - url
        - name
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
      type: object
    PaypayfleamarketItemStatus:
      type: string
      enum:
        - open
        - sold
        - all
    PaypayfleamarketCondition:
      type: string
      enum:
        - new
        - like_new
        - no_visible_damage
        - slight_damage
        - damaged
    PaypayfleamarketSort:
      type: string
      enum:
        - ranking
        - open_time
        - price
        - like_count
        - end_time
    PaypayfleamarketOrder:
      type: string
      enum:
        - asc
        - desc
    PaypayfleamarketGender:
      type: string
      enum:
        - mens
        - womens
        - boys
        - girls
    PaypayfleamarketClothingSize:
      type: string
      enum:
        - 2xs
        - xs
        - s
        - m
        - l
        - xl
        - 2xl
        - 3xl
        - 4xl
        - 5xl
        - 6xl
        - 7xl
        - 8xl
        - 9xl
        - free
    PaypayfleamarketShoeSize:
      type: string
      enum:
        - 9cm
        - 9.5cm
        - 10cm
        - 10.5cm
        - 11cm
        - 11.5cm
        - 12cm
        - 12.5cm
        - 13cm
        - 13.5cm
        - 14cm
        - 14.5cm
        - 15cm
        - 15.5cm
        - 16cm
        - 16.5cm
        - 17cm
        - 17.5cm
        - 18cm
        - 18.5cm
        - 19cm
        - 19.5cm
        - 20cm
        - 20.5cm
        - 21cm
        - 21.5cm
        - 22cm
        - 22.5cm
        - 23cm
        - 23.5cm
        - 24cm
        - 24.5cm
        - 25cm
        - 25.5cm
        - 26cm
        - 26.5cm
        - 27cm
        - 27.5cm
        - 28cm
        - 28.5cm
        - 29cm
        - 29.5cm
        - 30cm
        - 30.5cm
        - 31cm
        - 31.5cm
        - 32cm
        - 32.5cm
        - 33cm
        - 33.5cm
        - 34cm
        - free
    PaypayfleamarketKidsSize:
      type: string
      enum:
        - 50cm
        - 60cm
        - 70cm
        - 80cm
        - 90cm
        - 95cm
        - 100cm
        - 110cm
        - 120cm
        - 130cm
        - 140cm
        - 150cm
        - 160cm
        - 170cm
        - 180cm
        - free
    PaypayfleamarketWearCount:
      type: string
      enum:
        - once_or_twice
        - three_to_five
        - six_to_ten
        - eleven_or_more
    PaypayfleamarketColor:
      type: string
      enum:
        - white
        - black
        - gray
        - beige
        - brown
        - red
        - pink
        - purple
        - navy
        - blue
        - green
        - khaki
        - yellow
        - orange
        - gold
        - silver
        - clear
        - multi
    PaypayfleamarketQueryTarget:
      type: string
      enum:
        - name
        - description
        - category_name
        - brand_name
        - name_description_brand_or_category
    PaypayfleamarketCategoryRef:
      properties:
        '@type':
          type: string
          default: PaypayfleamarketCategoryRef
        id:
          type: integer
        name:
          type: string
      type: object
      required:
        - id
        - name
    PaypayfleamarketBrandRef:
      properties:
        '@type':
          type: string
          default: PaypayfleamarketBrandRef
        id:
          type: integer
        name:
          type: string
      type: object
      required:
        - id
        - name
    PaypayfleamarketUserRef:
      properties:
        '@type':
          type: string
          default: PaypayfleamarketUserRef
        id:
          type: string
        url:
          type: string
        rating_count:
          anyOf:
            - type: integer
            - type: 'null'
        good_ratio:
          anyOf:
            - type: number
            - type: 'null'
      type: object
      required:
        - id
        - url
    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

````