# DBA Search API Documentation Search public ads on DBA (dba.dk), the Danish classifieds marketplace. Filter by keyword, category, price range, region, condition, seller type, ad type and shipping, sort by relevance, newest, oldest or price, and page through up to 50 pages of 53 ads. Each ad has id, title, city with coordinates, price in DKK, ad type, url, images, publish date (ISO 8601, UTC), labels and a dealer flag. Facets list the category, condition, seller type, ad type, shipping and region values with hit counts. A valid search with no results is a successful response. - **Documentation:** [https://scrappa.co/docs/dba-api/dba_search](https://scrappa.co/docs/dba-api/dba_search) - **API group:** DBA API - **Endpoint:** `GET https://scrappa.co/api/dba/search` ## Authentication Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key. ## Parameters | Parameter | Type | Required | Description | | --- | --- | --- | --- | | `query` | string | No | Search text, e.g. cykel. Optional when a category is set. Maximum 200 characters. | | `category` | string | No | DBA category id: 0.x top level, 1.x.y sub category, 2.x.y.z product category. Read the ids from the facets.category field of a search response. Example: 0.93. | | `price_from` | integer | No | Minimum price in DKK (whole kroner). | | `price_to` | integer | No | Maximum price in DKK. Must be greater than or equal to price_from. | | `sort` | string | No | Sort order: RELEVANCE (default), PUBLISHED_DESC, PUBLISHED_ASC, PRICE_ASC or PRICE_DESC. | | `page` | integer | No | 1-based page number, 1 to 50. Each page holds up to 53 ads. Defaults to 1. | | `location` | string | No | DBA region id from facets.location, e.g. 0.200009 (Fyn). | | `condition` | array | No | Condition filter 1 to 5 (1 brand new, 2 like new). Repeat the parameter for several values: condition[]=1&condition[]=2. | | `dealer_segment` | string | No | 1 for private sellers, 3 for dealers. | | `trade_type` | string | No | 1 for sale, 2 for give away, 3 for wanted. | | `shipping_types` | string | No | 0 for ads that offer DBA shipping, 1 for ads with free shipping. | | `published` | string | No | Set to 1 to return only ads published today. | ## Example request ```bash #!/bin/bash curl -X GET \ -H "x-api-key: YOUR_API_KEY_HERE" \ "https://scrappa.co/api/dba/search?query=cykel&sort=PUBLISHED_DESC" ``` ## Example response ```json { "success": true, "data": { "query": "cykel", "results": [ { "position": 1, "id": "11565460", "title": "Renovering af Bakfiets ladcykel batteri (36V) 14Ah", "location": { "city": "K\u00f8ge", "coordinates": { "lat": 55.4704, "lng": 12.18454 } }, "price": { "amount": 2999, "currency": "DKK" }, "trade_type": "Til salg", "url": "https://www.dba.dk/recommerce/forsale/item/11565460", "images": [ { "url": "https://images.dbastatic.dk/dynamic/default/6a/6a6f9d2b-4016-4b74-be0d-2ca4396b3d2e" } ], "published_at": "2026-10-15T19:25:05Z", "labels": [ "Forhandler" ], "dealer": "BatteriService", "is_dealer": true }, { "position": 2, "id": "25859380", "title": "Bysykkel med kurv og gir", "location": { "city": "K\u00f8benhavn V", "coordinates": { "lat": 55.66901, "lng": 12.56801 } }, "price": { "amount": 700, "currency": "DKK" }, "trade_type": "Til salg", "url": "https://www.dba.dk/recommerce/forsale/item/25859380", "images": [ { "url": "https://images.dbastatic.dk/dynamic/default/item/25859380/b0c8f0d1-417b-4a62-be70-134e0c33c31c" }, { "url": "https://images.dbastatic.dk/dynamic/default/item/25859380/b8aff898-ba23-471b-859b-d530c35e90c0" }, { "url": "https://images.dbastatic.dk/dynamic/default/item/25859380/8cba8606-d59a-47f7-a9aa-6e8bbb97e10c" }, { "url": "https://images.dbastatic.dk/dynamic/default/item/25859380/295258cf-8a65-472c-9306-295fb2865b0d" }, { "url": "https://images.dbastatic.dk/dynamic/default/item/25859380/91af07aa-6908-4f88-92df-a71c8d7b783d" }, { "url": "https://images.dbastatic.dk/dynamic/default/item/25859380/a54c84c6-425f-40ba-b8e6-556838036648" } ], "published_at": "2026-10-15T19:24:45Z", "labels": [ "Privat" ], "is_dealer": false } ], "pagination": { "page": 1, "last_page": 50, "per_page": 53, "total": 40571 }, "has_more": true, "facets": { "category": [ { "value": "0.90", "label": "Bil-, b\u00e5d- og motorcykeludstyr", "count": 844, "children": [ { "value": "1.90.3975", "label": "ATV-tilbeh\u00f8r og reservedele", "count": 13 }, { "value": "1.90.82", "label": "Biltilbeh\u00f8r og reservedele", "count": 403 } ] } ], "condition": [ { "value": "1", "label": "Helt ny - u\u00e5bnet/med prism\u00e6rke", "count": 6849 }, { "value": "2", "label": "Som ny - ingen synlige brugsspor", "count": 6354 } ], "dealer_segment": [ { "value": "3", "label": "Forhandler", "count": 9929 }, { "value": "1", "label": "Privat", "count": 30642 } ], "trade_type": [ { "value": "1", "label": "Til salg", "count": 40511 }, { "value": "2", "label": "Gives v\u00e6k", "count": 59 } ] } }, "meta": { "endpoint_family": "search", "billable": true } } ``` ## Errors | Status | Error | Description | | --- | --- | --- | | 422 | Validation Error | A query parameter is missing or invalid. This response is not billable. | | 422 | Rejected Filter Value | DBA rejected a filter value, for example an unknown category id. This response is not billable. | | 503 | Invalid Source Response | DBA answered with a shape that no longer matches the documented contract. This response is not billable. | | 503 | Service Unavailable | The upstream service is temporarily unavailable. Please retry shortly. | ## More Scrappa resources - [API documentation](https://scrappa.co/docs) - [Full LLM-readable API reference](https://scrappa.co/llms-full.txt) - [OpenAPI specification](https://scrappa.co/docs/api.json) - [Pricing](https://scrappa.co/pricing)