Locations

Endpointhttps://api.adquick.com

Locations are the physical places where OOH advertising can be displayed.

Guaranteed Location Collection

GET

https://api.adquick.com

/v2/guaranteed/locations

Returns a paginated list of locations. Supports optional filtering by type and name.

Guaranteed Location Collection › query Parameters

page

integer

Page number (1-based)

Example: 1

Default: 1

per_page

integer

Number of records per page (max 100)

Example: 30

Default: 30

type

string

Filter by place type. Accepted values: country, region, district, place, neighborhood, locality, postcode, street, block, address, secondary_address, poi, dma.

Example: place

name

string

Filter by name (case-insensitive substring match)

Example: New York

Guaranteed Location Collection › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key.

Example: Bearer YOUR_API_KEY

Guaranteed Location Collection › Responses

successful

object[] · required

object · required

Pagination metadata for paginated responses

GET/v2/guaranteed/locations

curl --request GET \
  --url https://api.adquick.com/v2/guaranteed/locations \
  --header 'Authorization: <string>'

shell

Example Responses

{
  "records": [
    {
      "id": 1,
      "name": "New York",
      "location_name": "New York, New York, United States",
      "location_type": "place",
      "short_code": "NY"
    },
    {
      "id": 2,
      "name": "Los Angeles",
      "location_name": "Los Angeles, California, United States",
      "location_type": "place",
      "short_code": "CA"
    },
    {
      "id": 3,
      "name": "Chicago",
      "location_name": "Chicago, Illinois, United States",
      "location_type": "place",
      "short_code": "IL"
    }
  ],
  "pagination": {
    "current_page": 1,
    "total_pages": 1,
    "total_entries": 3,
    "next_page": null,
    "prev_page": null
  }
}

json

application/json

Programmatic Location Collection

GET

https://api.adquick.com

/v2/programmatic/locations

Returns a paginated list of locations. Supports optional filtering by type and name. Valid type values: zip code, city, metro area, state, county, sub county, country.

Programmatic Location Collection › query Parameters

page

integer

Page number (1-based)

Example: 1

Default: 1

per_page

integer

Number of records per page (max 100)

Example: 30

Default: 30

type

string

Filter by location type. Accepted values: zip code, city, metro area, state, county, sub county, country.

Example: city

name

string

Filter by name (case-insensitive substring match)

Example: New York

Programmatic Location Collection › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key.

Example: Bearer YOUR_API_KEY

Programmatic Location Collection › Responses

successful

object[] · required

object · required

Pagination metadata for paginated responses

GET/v2/programmatic/locations

curl --request GET \
  --url https://api.adquick.com/v2/programmatic/locations \
  --header 'Authorization: <string>'

shell

Example Responses

{
  "records": [
    {
      "id": 1,
      "name": "New York",
      "location_name": "New York, New York",
      "location_type": "city",
      "short_code": ""
    },
    {
      "id": 2,
      "name": "Los Angeles",
      "location_name": "Los Angeles, California",
      "location_type": "city",
      "short_code": ""
    },
    {
      "id": 3,
      "name": "Illinois",
      "location_name": "Illinois",
      "location_type": "state",
      "short_code": ""
    }
  ],
  "pagination": {
    "current_page": 1,
    "total_pages": 1,
    "total_entries": 3,
    "next_page": null,
    "prev_page": null
  }
}

json

application/json

Advertisers Campaigns

Guaranteed Location Collection

GET

https://api.adquick.com

/v2/guaranteed/locations

Returns a paginated list of locations. Supports optional filtering by type and name.

Guaranteed Location Collection › query Parameters

page

integer

Page number (1-based)

Example: 1

Default: 1

per_page

integer

Number of records per page (max 100)

Example: 30

Default: 30

type

string

Filter by place type. Accepted values: country, region, district, place, neighborhood, locality, postcode, street, block, address, secondary_address, poi, dma.

Example: place

name

string

Filter by name (case-insensitive substring match)

Example: New York

Guaranteed Location Collection › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key.

Example: Bearer YOUR_API_KEY

Guaranteed Location Collection › Responses

successful

object[] · required

object · required

Pagination metadata for paginated responses

Programmatic Location Collection

GET

https://api.adquick.com

/v2/programmatic/locations

Returns a paginated list of locations. Supports optional filtering by type and name. Valid type values: zip code, city, metro area, state, county, sub county, country.

Programmatic Location Collection › query Parameters

page

integer

Page number (1-based)

Example: 1

Default: 1

per_page

integer

Number of records per page (max 100)

Example: 30

Default: 30

type

string

Filter by location type. Accepted values: zip code, city, metro area, state, county, sub county, country.

Example: city

name

string

Filter by name (case-insensitive substring match)

Example: New York

Programmatic Location Collection › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key.

Example: Bearer YOUR_API_KEY

Programmatic Location Collection › Responses

successful

object[] · required

object · required

Pagination metadata for paginated responses