/search

Search for a product based on item parameters


Definition

https://api.upcdatabase.org/search/?query=your_query


Response

The response contains an array of up to 20 items.

{
    "success": true,
    "timestamp": 1585088665,
    "results": 20,
    "items": [
        {
            "barcode": "079784913400",
            "title": "\"The Dog\" Notepad",
            "alias": "",
            "description": "\"The Dog\" 4x4 inch notepad."
        },
        {
            "barcode": "794043469138",
            "title": "Wag the Dog",
            "alias": "",
            "description": ""
        },
        {
            "barcode": "0735836369853",
            "title": "Clover the Dog, stuffed animal",
            "alias": "",
            "description": "Clover the Dog, stuffed animal"
        },
        ...
        {
            "barcode": "0079784911437",
            "title": "The Dog Notebook; Mini; Pug",
            "alias": "",
            "description": ""
        }
    ]
}
{
    "message" => "Not Found. No products could be found with that search query.",
    "status": 400,
    "error": true
}
{
    "message": "Forbidden. Are you using the right authentication method and API token?",
    "status": 403,
    "error": true
}
{
    "message" => "Not Found. No products could be found with that search query.",
    "status": 404,
    "error": true
}