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

# /marktplaats/listings/search

> Search Marktplaats listings by keyword and/or category: for each result returns title, price, location, seller, images, category attributes and posting date. Supports filters by price range, condition, delivery method, advertiser kind, publication period, postcode radius, construction year and mileage ranges, category-specific attributes and numeric ranges, and sort order. Works across marktplaats.nl, 2dehands.be and 2ememain.be.

**Price:** 20 credits per 100 results



## OpenAPI

````yaml /openapi/e-commerce-marketplaces.json post /api/marktplaats/listings/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/marktplaats/listings/search:
    post:
      tags:
        - /marktplaats
      summary: /marktplaats/listings/search
      description: >-
        Search Marktplaats listings by keyword and/or category: for each result
        returns title, price, location, seller, images, category attributes and
        posting date. Supports filters by price range, condition, delivery
        method, advertiser kind, publication period, postcode radius,
        construction year and mileage ranges, category-specific attributes and
        numeric ranges, and sort order. Works across marktplaats.nl, 2dehands.be
        and 2ememain.be.


        **Price:** 20 credits per 100 results
      operationId: __api_marktplaats_listings_search_post
      parameters:
        - name: access-token
          in: header
          required: true
          schema:
            anyOf:
              - type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MarktplaatsListingsSearchPayload'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/MarktplaatsListingCard'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    MarktplaatsListingsSearchPayload:
      properties:
        timeout:
          type: integer
          maximum: 1500
          minimum: 20
          default: 300
        domain:
          $ref: '#/components/schemas/MarktplaatsDomain'
          default: marktplaats.nl
        keyword:
          anyOf:
            - type: string
              minLength: 1
            - type: 'null'
        count:
          type: integer
          minimum: 1
        category_id:
          anyOf:
            - type: integer
            - type: 'null'
        subcategory_id:
          anyOf:
            - type: integer
            - type: 'null'
        min_price:
          anyOf:
            - type: number
              minimum: 0
            - type: 'null'
        max_price:
          anyOf:
            - type: number
              minimum: 0
            - type: 'null'
        condition:
          anyOf:
            - items:
                $ref: '#/components/schemas/MarktplaatsCondition'
              type: array
            - type: 'null'
        delivery:
          anyOf:
            - items:
                $ref: '#/components/schemas/MarktplaatsDelivery'
              type: array
            - type: 'null'
        advertiser:
          anyOf:
            - $ref: '#/components/schemas/MarktplaatsAdvertiser'
            - type: 'null'
        offered_since:
          anyOf:
            - $ref: '#/components/schemas/MarktplaatsOfferedSince'
            - type: 'null'
        buy_now:
          type: boolean
          default: false
        urgent:
          type: boolean
          default: false
        postcode:
          anyOf:
            - type: string
            - type: 'null'
        distance_meters:
          anyOf:
            - type: integer
              minimum: 1000
            - type: 'null'
        min_construction_year:
          anyOf:
            - type: integer
              minimum: 1900
            - type: 'null'
        max_construction_year:
          anyOf:
            - type: integer
              minimum: 1900
            - type: 'null'
        min_mileage:
          anyOf:
            - type: integer
              minimum: 0
            - type: 'null'
        max_mileage:
          anyOf:
            - type: integer
              minimum: 0
            - type: 'null'
        attributes:
          anyOf:
            - additionalProperties:
                type: string
              type: object
            - type: 'null'
        attribute_ranges:
          anyOf:
            - additionalProperties:
                type: string
              type: object
            - type: 'null'
        sort:
          $ref: '#/components/schemas/MarktplaatsSort'
          default: relevance
      type: object
      required:
        - count
    MarktplaatsListingCard:
      properties:
        '@type':
          type: string
          default: MarktplaatsListingCard
        id:
          type: string
        url:
          anyOf:
            - type: string
            - type: 'null'
        listing_title:
          anyOf:
            - type: string
            - type: 'null'
        price:
          anyOf:
            - type: number
            - type: 'null'
        currency:
          type: string
          default: EUR
        price_type:
          anyOf:
            - type: string
            - type: 'null'
        city:
          anyOf:
            - type: string
            - type: 'null'
        country:
          anyOf:
            - type: string
            - type: 'null'
        country_code:
          anyOf:
            - type: string
            - type: 'null'
        latitude:
          anyOf:
            - type: number
            - type: 'null'
        longitude:
          anyOf:
            - type: number
            - type: 'null'
        created_at:
          anyOf:
            - type: integer
            - type: 'null'
        category_id:
          anyOf:
            - type: integer
            - type: 'null'
        verticals:
          items:
            type: string
          type: array
          default: []
        attributes:
          additionalProperties:
            type: string
          type: object
          default: {}
        traits:
          items:
            type: string
          type: array
          default: []
        highlights:
          items:
            type: string
          type: array
          default: []
        seller_id:
          anyOf:
            - type: integer
            - type: 'null'
        seller_name:
          anyOf:
            - type: string
            - type: 'null'
        is_verified_seller:
          type: boolean
          default: false
        is_promoted:
          type: boolean
          default: false
        is_reserved:
          type: boolean
          default: false
        has_video:
          type: boolean
          default: false
        has_nap_status:
          type: boolean
          default: false
        image:
          anyOf:
            - type: string
            - type: 'null'
        images:
          items:
            type: string
          type: array
          default: []
      type: object
      required:
        - id
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
      type: object
    MarktplaatsDomain:
      type: string
      enum:
        - marktplaats.nl
        - 2dehands.be
        - 2ememain.be
    MarktplaatsCondition:
      type: string
      enum:
        - Nieuw
        - Refurbished
        - Zo goed als nieuw
        - Gebruikt
        - Niet werkend
    MarktplaatsDelivery:
      type: string
      enum:
        - Ophalen
        - Verzenden
    MarktplaatsAdvertiser:
      type: string
      enum:
        - Particulier
        - Bedrijf
    MarktplaatsOfferedSince:
      type: string
      enum:
        - Vandaag
        - Gisteren
        - Een week
        - Altijd
    MarktplaatsSort:
      type: string
      enum:
        - relevance
        - date_desc
        - date_asc
        - price_asc
        - price_desc
        - construction_year_desc
        - construction_year_asc
        - mileage_asc
        - mileage_desc
    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

````