Skip to main content

Search Products GET Endpoint

Our GET endpoint allows you to search for all products using a query string based on the product's name.

Route​

/api/product/search
Authorization: Bearer {Your API Key}

Query Parameters​

You can modify the results by using the following parameters:

  • query - The search query.
  • results - The number of results to show (Min: 1 / Max: 50).

Responses​

You will receive one of the following responses:

  • 400 Input validation failed.
  • 200 Products not found.
  • 200 Results with products.

Here's an example of a successful request and response:

Request:

https://barcodes.gg/api/product/search?query=dd1503-100

Response:

{
    "error": false,
    "results": [
        {
            "product_name": "Nike Dunk Low Coast (W)",
            "product_brand": "Nike",
            "product_category": "sneakers",
            "product_style_code": "DD1503-100",
            "product_release_date": "2021-02-18",
            "product_description": "Nike paid homage to the West Coast with the women's Nike Dunk Low Coast (W). The Coast colorway is reminiscent of UCLA Bruin school colors, prominently featuring light blue, white, and yellow.\n\nWhite and light blue leather comprise the upper of the Nike Dunk Low Coast (W), with white on the vamp and medial panels and light blue on the overlay and Swoosh. Hits of yellow are present in the Nike Air branding on the tongue and heel. A white midsole and light EVA outsole complete the design.\n\nThe women's Nike Dunk Low Coast (W) released in February of 2021 and retailed for $100.",
            "product_colorway": "Sail/Coast-University Gold",
            "product_retail_price": "100",
            "product_image": "hidden, its a base64 string",
            "relevance": 1.5
        }
    ]
}