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

# /gumtree/listings/search

> Search Gumtree ads across every section (For Sale, Motors, Property, Jobs, Pets, Services, Community): for each result returns title, price, location, posting date, promotion flags, seller and images. Supports keyword, category, location and radius plus section-specific filters for vehicles, property and jobs.

**Price:** 20 credits per 30 results



## OpenAPI

````yaml /openapi/e-commerce-marketplaces.json post /api/gumtree/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/gumtree/listings/search:
    post:
      tags:
        - /gumtree
      summary: /gumtree/listings/search
      description: >-
        Search Gumtree ads across every section (For Sale, Motors, Property,
        Jobs, Pets, Services, Community): for each result returns title, price,
        location, posting date, promotion flags, seller and images. Supports
        keyword, category, location and radius plus section-specific filters for
        vehicles, property and jobs.


        **Price:** 20 credits per 30 results
      operationId: __api_gumtree_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/GumtreeListingsSearchPayload'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/GumtreeAdCard'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    GumtreeListingsSearchPayload:
      properties:
        timeout:
          type: integer
          maximum: 1500
          minimum: 20
          default: 300
        keyword:
          anyOf:
            - type: string
              minLength: 1
            - type: 'null'
        count:
          type: integer
          minimum: 1
        search_category:
          anyOf:
            - type: string
              minLength: 1
            - type: 'null'
        search_location:
          anyOf:
            - type: string
              minLength: 1
            - type: 'null'
        distance:
          anyOf:
            - $ref: '#/components/schemas/GumtreeDistance'
            - type: 'null'
        sort:
          anyOf:
            - $ref: '#/components/schemas/GumtreeSort'
            - type: 'null'
        seller_type:
          anyOf:
            - items:
                $ref: '#/components/schemas/GumtreeSellerType'
              type: array
            - type: 'null'
        min_price:
          anyOf:
            - type: number
              minimum: 0
            - type: 'null'
        max_price:
          anyOf:
            - type: number
              minimum: 0
            - type: 'null'
        has_photos:
          type: boolean
          default: false
        is_urgent:
          type: boolean
          default: false
        is_featured:
          type: boolean
          default: false
        search_in_description:
          type: boolean
          default: false
        condition:
          anyOf:
            - items:
                $ref: '#/components/schemas/GumtreeCondition'
              type: array
            - type: 'null'
        delivery_available:
          type: boolean
          default: false
        vehicle_make:
          anyOf:
            - $ref: '#/components/schemas/GumtreeVehicleMake'
            - type: 'null'
        vehicle_model:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
        vehicle_body_type:
          anyOf:
            - items:
                $ref: '#/components/schemas/GumtreeVehicleBodyType'
              type: array
            - type: 'null'
        vehicle_fuel_type:
          anyOf:
            - items:
                $ref: '#/components/schemas/GumtreeVehicleFuelType'
              type: array
            - type: 'null'
        vehicle_transmission:
          anyOf:
            - items:
                $ref: '#/components/schemas/GumtreeVehicleTransmission'
              type: array
            - type: 'null'
        vehicle_colour:
          anyOf:
            - items:
                $ref: '#/components/schemas/GumtreeVehicleColour'
              type: array
            - type: 'null'
        vehicle_doors:
          anyOf:
            - items:
                type: integer
              type: array
            - type: 'null'
        vehicle_seats:
          anyOf:
            - items:
                type: integer
              type: array
            - type: 'null'
        vehicle_average_mpg:
          anyOf:
            - $ref: '#/components/schemas/GumtreeVehicleMpg'
            - type: 'null'
        min_vehicle_registration_year:
          anyOf:
            - type: integer
              minimum: 1900
            - type: 'null'
        max_vehicle_registration_year:
          anyOf:
            - type: integer
              minimum: 1900
            - type: 'null'
        min_vehicle_mileage:
          anyOf:
            - type: integer
              minimum: 0
            - type: 'null'
        max_vehicle_mileage:
          anyOf:
            - type: integer
              minimum: 0
            - type: 'null'
        min_vehicle_engine_size:
          anyOf:
            - type: integer
              minimum: 0
            - type: 'null'
        max_vehicle_engine_size:
          anyOf:
            - type: integer
              minimum: 0
            - type: 'null'
        property_type:
          anyOf:
            - items:
                $ref: '#/components/schemas/GumtreePropertyType'
              type: array
            - type: 'null'
        min_bedrooms:
          anyOf:
            - type: integer
              minimum: 0
            - type: 'null'
        max_bedrooms:
          anyOf:
            - type: integer
              minimum: 0
            - type: 'null'
        all_bills_included:
          type: boolean
          default: false
        council_tax_included:
          type: boolean
          default: false
        pets_allowed:
          type: boolean
          default: false
        job_contract_type:
          anyOf:
            - items:
                $ref: '#/components/schemas/GumtreeJobContractType'
              type: array
            - type: 'null'
        job_hours:
          anyOf:
            - items:
                $ref: '#/components/schemas/GumtreeJobHours'
              type: array
            - type: 'null'
        job_level:
          anyOf:
            - items:
                $ref: '#/components/schemas/GumtreeJobLevel'
              type: array
            - type: 'null'
        job_language:
          anyOf:
            - items:
                $ref: '#/components/schemas/GumtreeJobLanguage'
              type: array
            - type: 'null'
        recruiter_type:
          anyOf:
            - items:
                $ref: '#/components/schemas/GumtreeRecruiterType'
              type: array
            - type: 'null'
        is_course:
          type: boolean
          default: false
        min_salary:
          anyOf:
            - type: integer
              minimum: 0
            - type: 'null'
        max_salary:
          anyOf:
            - type: integer
              minimum: 0
            - type: 'null'
      type: object
      required:
        - count
    GumtreeAdCard:
      properties:
        '@type':
          type: string
          default: GumtreeAdCard
        id:
          type: string
        url:
          type: string
        price:
          anyOf:
            - type: number
            - type: 'null'
        currency:
          type: string
          default: GBP
        city:
          anyOf:
            - type: string
            - type: 'null'
        region:
          anyOf:
            - type: string
            - type: 'null'
        distance:
          anyOf:
            - type: string
            - type: 'null'
        posted_at:
          anyOf:
            - type: integer
            - type: 'null'
        status:
          anyOf:
            - type: string
            - type: 'null'
        category_id:
          anyOf:
            - type: string
            - type: 'null'
        is_featured:
          type: boolean
          default: false
        is_urgent:
          type: boolean
          default: false
        is_standout:
          type: boolean
          default: false
        is_premium:
          type: boolean
          default: false
        has_video:
          type: boolean
          default: false
        seller_id:
          anyOf:
            - type: string
            - type: 'null'
        is_pro_seller:
          type: boolean
          default: false
        favourite_count:
          anyOf:
            - type: integer
            - type: 'null'
        attributes:
          additionalProperties:
            type: string
          type: object
          default: {}
        image:
          anyOf:
            - type: string
            - type: 'null'
        images:
          items:
            type: string
          type: array
          default: []
        image_count:
          anyOf:
            - type: integer
            - type: 'null'
      type: object
      required:
        - id
        - url
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
      type: object
    GumtreeDistance:
      type: string
      enum:
        - '1'
        - '3'
        - '5'
        - '10'
        - '15'
        - '30'
        - '50'
        - '75'
        - '100'
        - '1000'
    GumtreeSort:
      type: string
      enum:
        - relevance
        - date
        - price_lowest_first
        - price_highest_first
        - distance
    GumtreeSellerType:
      type: string
      enum:
        - trade
        - private
    GumtreeCondition:
      type: string
      enum:
        - new
        - as_good_as_new
        - good
        - fair
    GumtreeVehicleMake:
      type: string
      enum:
        - abarth
        - ac
        - aixam
        - alfa_romeo
        - aston_martin
        - audi
        - austin
        - bedford
        - bentley
        - bmc
        - bmw
        - byd
        - cadillac
        - caterham
        - chery
        - chevrolet
        - chrysler
        - citroen
        - cupra
        - dacia
        - daewoo
        - daf_trucks
        - daihatsu
        - daimler
        - dodge
        - ds
        - ferrari
        - fiat
        - ford
        - genesis
        - great_wall
        - honda
        - hummer
        - hyundai
        - ineos
        - infiniti
        - isuzu
        - isuzu_trucks
        - iveco
        - jaecoo
        - jaguar
        - jeep
        - kgm
        - kia
        - ktm
        - lamborghini
        - land_rover
        - ldv
        - leapmotor
        - levc
        - lexus
        - lotus
        - lti
        - man
        - marcos
        - marlin
        - maserati
        - maxus
        - maybach
        - mazda
        - mclaren
        - mercedes_benz
        - mg
        - mg_motor_uk
        - microcar
        - mini
        - mitsubishi
        - mitsubishi_fuso
        - morgan
        - nissan
        - omoda
        - opel
        - perodua
        - peugeot
        - piaggio
        - polestar
        - porsche
        - proton
        - reliant
        - renault
        - renault_trucks
        - rolls_royce
        - rover
        - saab
        - scania
        - seat
        - skoda
        - smart
        - ssangyong
        - subaru
        - suzuki
        - talbot
        - tesla
        - toyota
        - tvr
        - vauxhall
        - volkswagen
        - volvo
        - westfield
        - other_manufacturer
    GumtreeVehicleBodyType:
      type: string
      enum:
        - car_derived_van
        - convertible
        - coupe
        - estate
        - hatchback
        - light_4x4_utility
        - minibus
        - motor_caravan
        - mpv
        - panel_van
        - pick_up
        - saloon
        - sports
        - window_van
        - other
    GumtreeVehicleFuelType:
      type: string
      enum:
        - diesel
        - electric
        - gas
        - gas_bi_fuel
        - hybrid_electric
        - petrol
        - petrol_gas
        - other
    GumtreeVehicleTransmission:
      type: string
      enum:
        - automatic
        - manual
        - semi_auto
        - other
    GumtreeVehicleColour:
      type: string
      enum:
        - biege
        - black
        - blue
        - bronze
        - brown
        - cream
        - gold
        - green
        - grey
        - maroon
        - mauve
        - multi_coloured
        - orange
        - pink
        - purple
        - red
        - silver
        - white
        - yellow
        - other
    GumtreeVehicleMpg:
      type: string
      enum:
        - over_30
        - over_40
        - over_50
        - over_60
    GumtreePropertyType:
      type: string
      enum:
        - flat
        - house
        - other
    GumtreeJobContractType:
      type: string
      enum:
        - cashinhand
        - contract
        - freelance
        - locum
        - permanent
        - selfemployed
        - subcontractor
        - voluntary
    GumtreeJobHours:
      type: string
      enum:
        - evening
        - full_time
        - morning
        - nights
        - part_time
        - saturday_job
        - term-time
        - weekends
    GumtreeJobLevel:
      type: string
      enum:
        - apprenticeship
        - experienced
        - graduate
        - internship
        - management
    GumtreeJobLanguage:
      type: string
      enum:
        - arabic
        - filipino
        - english
        - french
        - german
        - greek
        - hindi
        - italian
        - polish
        - romanian
        - spanish
        - swedish
        - thai
        - turkish
        - urdu
    GumtreeRecruiterType:
      type: string
      enum:
        - direct
        - agency
    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

````