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

# Kleinanzeigen listings search

> Search live Kleinanzeigen ads by keyword with category, price, condition, seller type, shipping and sort filters. 1 point per returned record.



## OpenAPI

````yaml /openapi.json post /functions/v1/run-kleinanzeigen-listings-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-kleinanzeigen-listings-search:
    post:
      tags:
        - E-commerce & Marketplaces
      summary: Kleinanzeigen listings search
      description: >-
        Search live Kleinanzeigen ads by keyword with category, price,
        condition, seller type, shipping and sort filters. 1 point per returned
        record.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                keyword:
                  description: Search term. e.g. fahrrad
                  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
                  default: 1
                sort:
                  description: >-
                    Sort by. Options: newest = Newest, price_asc = Price: low to
                    high, price_desc = Price: high to low, distance = Distance
                  type: string
                  enum:
                    - newest
                    - price_asc
                    - price_desc
                    - distance
                condition:
                  description: >-
                    Condition. Options: new_with_tag = New with tag, new = New,
                    like_new = Like new, good = Good, ok = OK, defect =
                    Defective
                  type: string
                  enum:
                    - new_with_tag
                    - new
                    - like_new
                    - good
                    - ok
                    - defect
                offer_type:
                  description: >-
                    Offer type. Options: offer = Offers (for sale), wanted =
                    Wanted ads
                  type: string
                  enum:
                    - offer
                    - wanted
                seller_type:
                  description: >-
                    Seller type. Options: private = Private, commercial =
                    Commercial
                  type: string
                  enum:
                    - private
                    - commercial
                shipping:
                  description: >-
                    Shipping. Options: shipping = Shipping available, pickup =
                    Pickup only
                  type: string
                  enum:
                    - shipping
                    - pickup
                carrier:
                  description: 'Carrier. Options: dhl = DHL, hermes = Hermes'
                  type: string
                  enum:
                    - dhl
                    - hermes
                min_price:
                  description: Min price (EUR)
                  type: number
                  minimum: 0
                max_price:
                  description: Max price (EUR)
                  type: number
                  minimum: 0
                category_id:
                  description: Category ID. e.g. e.g. 217
                  type: string
                buy_now:
                  description: Buy Now only
                  type: boolean
              required:
                - keyword
            example:
              keyword: fahrrad
              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
                      first_item:
                        type: object
                        properties:
                          id:
                            type: string
                          title:
                            type: string
                          url:
                            type: string
                          price:
                            type: integer
                          currency:
                            type: string
                          old_price:
                            type: integer
                          is_negotiable:
                            type: boolean
                          is_free:
                            type: boolean
                          description:
                            type: string
                          postal_code:
                            type: string
                          state:
                            type: string
                          city:
                            type: string
                          posted_at: {}
                          shipping_available:
                            type: boolean
                          image:
                            type: string
                          image_count:
                            type: integer
                      items:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                            title:
                              type: string
                            url:
                              type: string
                            price:
                              type: integer
                            currency:
                              type: string
                            old_price:
                              type: integer
                              nullable: true
                            is_negotiable:
                              type: boolean
                            is_free:
                              type: boolean
                            description:
                              type: string
                            postal_code:
                              type: string
                            state:
                              type: string
                            city:
                              type: string
                            posted_at: {}
                            shipping_available:
                              type: boolean
                            image:
                              type: string
                            image_count:
                              type: integer
                      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: kleinanzeigen_listings_search
                keyword: fahrrad
                max_items: 2
                start_page: 1
                partial: false
                human: |-
                  # Kleinanzeigen listings search

                  - **Keyword:** fahrrad
                  - **Starting page:** 1
                  - **Max items:** 2
                  - **Records returned:** 2
                  - **Proxy traffic:** 120.6 KB
                machine:
                  total_items: 2
                  first_item:
                    id: '3474575215'
                    title: >-
                      Canyon Neuron CF 9 SL Mountainbike 2024 Kashima Carbon
                      Rahmen L
                    url: >-
                      https://www.kleinanzeigen.de/s-anzeige/canyon-neuron-cf-9-sl-mountainbike-2024-kashima-carbon-rahmen-l/3474575215-217-2187
                    price: 2888
                    currency: EUR
                    old_price: 3480
                    is_negotiable: true
                    is_free: false
                    description: >-
                      Ich biete mein neuwertiges Canyon Neuron CF 9 SL
                      Mountainbike aus dem Modelljahr 2024 an. Dieses...
                    postal_code: '06484'
                    state: Sachsen-Anhalt
                    city: Quedlinburg
                    posted_at: null
                    shipping_available: true
                    image: >-
                      https://img.kleinanzeigen.de/api/v1/prod-ads/images/8a/8abf7ccb-10a5-41ed-8a94-95db73f64672?rule=$_59.AUTO
                    image_count: 1
                  items:
                    - id: '3474575215'
                      title: >-
                        Canyon Neuron CF 9 SL Mountainbike 2024 Kashima Carbon
                        Rahmen L
                      url: >-
                        https://www.kleinanzeigen.de/s-anzeige/canyon-neuron-cf-9-sl-mountainbike-2024-kashima-carbon-rahmen-l/3474575215-217-2187
                      price: 2888
                      currency: EUR
                      old_price: 3480
                      is_negotiable: true
                      is_free: false
                      description: >-
                        Ich biete mein neuwertiges Canyon Neuron CF 9 SL
                        Mountainbike aus dem Modelljahr 2024 an. Dieses...
                      postal_code: '06484'
                      state: Sachsen-Anhalt
                      city: Quedlinburg
                      posted_at: null
                      shipping_available: true
                      image: >-
                        https://img.kleinanzeigen.de/api/v1/prod-ads/images/8a/8abf7ccb-10a5-41ed-8a94-95db73f64672?rule=$_59.AUTO
                      image_count: 1
                    - id: '3521420108'
                      title: 2024 Gazelle Eclipse T11 Bosch Performance CX Top
                      url: >-
                        https://www.kleinanzeigen.de/s-anzeige/2024-gazelle-eclipse-t11-bosch-performance-cx-top/3521420108-217-1309
                      price: 3299
                      currency: EUR
                      old_price: null
                      is_negotiable: false
                      is_free: false
                      description: >-
                        Budget Bikes Hoeve Ihre E Bike shop mit nur qualität E
                        Bikes von bekannte hersteller, Biete...
                      postal_code: '48599'
                      state: Nordrhein-Westfalen
                      city: Gronau (Westfalen)
                      posted_at: null
                      shipping_available: true
                      image: >-
                        https://img.kleinanzeigen.de/api/v1/prod-ads/images/5e/5e5fcb67-3b8a-4b3c-b47f-8a2d59778eee?rule=$_59.AUTO
                      image_count: 20
                  proxy_traffic_bytes: 123464
                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

````