GET client-brand

A lookup call to retrieve all approved advertiser/brand pairs; use https://oohspace.co.uk/api/client-brand.

Info

Where the term Client is used, this is now a reference to Advertiser

INPUT

As this method is accessed via a GET request there is no HTTP body so options can be specified via the URL.

parameter type description
changed_date string (optional) restricts results to only client-brands that have been changed since this date, date must be formatted as 2015-04-01T08:00:00

OUTPUT - JSON sample


{
    "data": {
        "datetime_last_update": "2020-12-01 16:16:15",
        "approved": [
            {
                "client_id": 4997,
                "client_name": "El Al Israel Airlines Ltd",
                "brand_id": 14215,
                "brand_name": "El Al Israel Airlines",
                "brand_date_added": "2021-02-18 17:25:12",
                "categories": [
                    {
                        "category_id": 30666,
                        "category_name": "Airlines"
                    }
                ]
            },
            {
                "client_id": 4998,
                "client_name": "Hashtag Merky Records Limited",
                "brand_id": 2737,
                "brand_name": "Stormzy",
                "brand_date_added": "2021-02-18 17:25:12",
                "categories": [
                    {
                        "category_id": 20027,
                        "category_name": "Entertainment"
                    }
                ]
            },
            {
                "client_id": 4999,
                "client_name": "[PIAS] UK Ltd",
                "brand_id": 16927,
                "brand_name": "[PIAS]",
                "brand_date_added": "2019-04-11 17:25:54",
                "categories": []
            }
        ],
        "approval_intervention_history": [
            {
                "client_id": 5446,
                "client_name": "Art 15",
                "brand_id": null,
                "brand_name": null,
                "status": "removed",
                "date": "2018-08-16 10:05:18"
            },
            {
                "client_id": 6824,
                "client_name": "Converse",
                "brand_id": 4091,
                "brand_name": "One Star",
                "status": "removed",
                "date": "2018-08-22 14:47:04"
            },
            {
                "client_id": 13856,
                "client_name": "Refresco Drinks UK Limited",
                "brand_id": 4485,
                "brand_name": "Emerge",
                "matched_client_id": 10311,
                "matched_brand_id": 4485,
                "status": "matched",
                "date": "2018-10-23 17:13:44"
            }
        ]
    }
}
        

If an advertiser doesn't have any associated brands/categories then the brand/category fields will be returned as NULL.