1. listing
Paralleg
  • API
    • v1
      • attributes
        • car
          • Get Brands
          • Get Models
          • Get Types
      • categories
        • Get Categories
        • Get Category
        • Get Category Parameters
      • parameters
        • Get Parameter
        • Get Parameter Values
      • listing
        • Listing Lookup
          POST
      • offers
        • Offer Lookup
        • Get Offer
        • Get Offer By External ID
        • Get Offer Text
        • Get Offer Images
        • Get Offer Related
      • images
        • Image
        • Image redirect
        • Proxy image content in original size
        • Proxy image content resized
    • Get request info
      GET
    • Schemas
      • v1
        • Offers
          • Offer
          • OfferCategory
          • ListingOffer
          • OfferParameter
          • OfferText
          • OfferParameterValue
          • OfferProduct
          • OfferSeller
          • ReplacementOffer
        • CarAttributes
          • CarBrand
          • CarModel
          • CarType
          • CarModelGroup
        • Parameters
          • Restrictions
            • ParameterIntegerRestrictions
            • ParameterFloatRestrictions
            • ParameterStringRestrictions
            • ParameterDisctionaryRestrictions
          • Parameter
          • ParameterValue
        • Images
          • Image
          • ImageVariant
        • Lang
        • Category
        • Pagination
        • Currency
  • Browser API
    • v1
  1. listing

Listing Lookup

POST
/v1/listings/lookup
Last modified:2026-04-04 17:38:50

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Query Params

Header Params

Body Params application/json

Example
{
    "search": "string",
    "category_id": "8de4c9fd-61a4-4c0b-bf88-0ed3a0fe3fa2",
    "car_brand_id": "3f9c33dd-7fd0-44da-a989-a0b0bf40761e",
    "car_model_group_id": "0e5991f9-547b-478c-be92-54d30d1c56db",
    "car_model_id": "251a1202-8b8c-4a26-a987-2e6f460bc4ad",
    "car_type_id": "38612c9a-9cba-4d63-8ed8-ac5739209f76",
    "price_from": 0,
    "price_to": 0,
    "sort": "relevance",
    "limit": 12,
    "page": 1,
    "lang": "pl"
}

Responses

🟢200Success
application/json
Bodyapplication/json

Example
{
    "meta": {
        "lang": "pl",
        "pagination": {
            "limit": 0,
            "page": 0,
            "pages_count": 0,
            "items_count": 0
        }
    },
    "data": [
        {
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "external_id": 0,
            "name": "string",
            "price": "string",
            "currency": "PLN",
            "category": {
                "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                "external_id": "string",
                "name": "string"
            },
            "product": {
                "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                "external_id": "string"
            },
            "seller": {
                "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                "external_id": "string"
            },
            "image": {
                "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                "variants": {
                    "s256": {
                        "url": "http://example.com",
                        "external_url": "http://example.com"
                    },
                    "s512": {
                        "url": "http://example.com",
                        "external_url": "http://example.com"
                    },
                    "s1024": {
                        "url": "http://example.com",
                        "external_url": "http://example.com"
                    },
                    "source": {
                        "url": "http://example.com",
                        "external_url": "http://example.com"
                    }
                }
            }
        }
    ]
}
🟠422Validation Error
🟠404
🔴500
🔴502
Modified at 2026-04-04 17:38:50
Previous
Get Parameter Values
Next
Offer Lookup
Built with