Listados

Listados

Los listados disponibles para descargar por la API de JSON son:

Paises
Ciudades
Regiones
Navegadores (bproduct)
Sistemas Operativos (osname)
Versiones de sistemas operativos
Modelos de dispositivos móviles
Marcas de dispositivos móviles
Categorías del IAB
Códigos DMA(Designated market area - codigo de Nielsen para identificar grupos de ciudades de Estados Unidos).
Códigos CSBA( Core Statistical Base Area - codigos del Census Bureau de EEUU para agrupar ciudades (ver http://www.census.gov/population/metro/).

Respuesta: al igual para todos los listados, la respuesta se compone de una lista de objetos. La composición de cada objeto para a depender de cada listado.

Paises

URL: /admin/jsapi/country?op=l

El objeto country contiene:

-name: nombre del país

-code: código de una silaba correspondiente al país.

Ejemplo:

{'name':'Djibouti','code':'DJ'}

Ciudades

URL: /admin/jsapi/city?op=l

Para obtener el listado de ciudades, debemos indicar el pais, mediante un parametro adicional: country, el mismo va a tomar el valor del codigo correspondiente, el parámetro code de ese país.

Ejemplo de url con parámetros: /admin/jsapi/city?op=l&country=AR

El objeto city contiene:

-country: código de país

-region_id: id de la región de esa ciudad

-city_id: id de la ciudad

-name: nombre de la ciudad

Ejemplo:

{

'country': 'ar',

'region_id': '5671',

'city_id': '144048',

'name': 'BAHIA BLANCA'

}

Regiones

URL: /admin/jsapi/region?op=l

Para obtener el listado de región, también debemos indicar el país, mediante el parámetro: country, el mismo va a tomar el valor del código correspondiente, el parámetro code de ese país.

Ejemplo de url con parámetros: /admin/jsapi/region?op=l&country=AR

El objeto región contiene:

- country: código del país

- region_id: identificador de la region.

- name: nombre de la región.

Ejemplo:

{

'country': 'ar',

'region_id': '5671',

'iso3166_2': 'B',

'name': 'Buenos aires',

'fips10_4': '01'

}

Navegadores

URL: /admin/jsapi/bproduct?op=l

El objeto bproduct contiene:

-icon: icono del navegador.

- type: Tipo de navegador, lo valores posibles son:

0: STANDARD_BROWSER

1: OFFLINE_BROWSER

3: MOBILE_BROWSER

4: EMAIL_CLIENT

5: LIBRARY

6: WAP_BROWSER

10: VALIDATOR

15: FEED_READER

18: MULTIMEDIA_PLAYER

20: OTHER

50: ANONYMIZER

-type_name: Nombre del tipo de navegador.

-bproduct_id: Identificador del navegador.

-name: nombre del navegador

- company: Compañía creadora del navegador.

-popular: 1 si se encuentra entre los mas destacados y utilizados, 0 sino.

Ejemplo:

{

'icon': 'msie.png',

'type_name': 'Navegador web',

'bproduct_id': '1',

'popular': 1,

'name': 'Internet Explorer',

'type': '0',

'company': 'Microsoft'

}

Sistemas operativos

URL: /admin/jsapi/osname?op=l

El objeto osname contiene:

- osname_id: identificador del objeto

- name: nombre

- popular: 1 si se encuentra entre los mas destacados y utilizados, 0 sino.

Ejemplo:

{

'popular': 1,

'osname_id': '1',

'name': 'Linux'

}

Versiones de sistemas operativos

URL: /admin/jsapi/os?op=l

El objeto os contiene:

-icon: icono del sistema operativo

-popular: 1 si se encuentra entre los mas destacados y utilizados, 0 sino.

-osname_id: identificador del sistema operativo.

-name: nombre de la versión.

- os_id: identificador de la versión.

-company: compañía creadora del sistema.

Ejemplo:

{

'icon': 'macosx.png',

'popular': 0,

'osname_id': '2',

'name': 'Mac OS X',

'os_id': '30',

'company': 'Apple Computer, Inc.'

}

Modelos de dispositivos móviles

URL: /admin/jsapi/mobmodel?op=l

El objeto mobmodel contiene:

-mobmodel_id: identificador del modelo.

-name: nombre del modelo.

-marketing_name: nombre de marketing del modelo

-mobbrand_id: id de la marca del modelo.

Ejemplo:

{

'mobmodel_id': '2',

'status': '0',

'name': 'Acer E101',

'marketing_name': 'beTouch E101',

'mobbrand_id': '2'

}

Marcas de dispositivos móviles

URL: /admin/jsapi/mobbrand?op=l

El objeto mobbrand contiene:

-mobbrand_id: identificador de la marca

-name: nombre de la marca

Ejemplo:

{

'status': '0',

'name': 'Samsung',

'mobbrand_id': '6'

}

Categorías del IAB

URL: /admin/jsapi/contentcat?op=l

El objeto contentcat contiene:

-parent_contentcat_id: identificador de la categoría padre

-fullname: nombre de la categoría incluyendo el nombre de su categoría padre (en caso de tenerla).

-name: nombre de la categoría padre

- contentcat_id: identificador de la categoría

-code: codigo asignado por el IAB a esta categoría.

Ejemplo:

{

'parent_contentcat_id': '0',

'fullname': 'Arts & Entertainment',

'name': 'Arts & Entertainment',

'contentcat_id': '1',

'code': 'IAB1'

}

Códigos DMA

Si bien estos códigos pertenecen únicamente a Estados Unidos, es necesario indicar en la url el código de país :

URL: /admin/jsapi/dma?op=l&country=US

El parámetro country, tendrá un valor fijo que es el valor del código de país de Estados Unidos “US”.

El objeto dma contiene:

-country: siempre tomara el valor “US”.

-dma_id: identificador del grupo de ciudades

-name: nombre del grupo de ciudades

-code: código dma para ese grupo

Ejemplo:

{

'country': 'US',

'dma_id': '1',

'name': 'New York',

'rank': '1',

'code': '501'

}

Códigos CBSA

Al igual que los códigos DMA es necesario indicar el país.

URL: /admin/jsapi/cbsa?op=l&country=US

El objeto cbsa contiene:

-country: siempre tomara el valor US.

-cbsa_id: identificador del grupo de ciudades.

-name: nombre del grupo

-code: código cbsa para ese grupo.

-type: tipo de agrupación, los valores posibles son:

1: METRO

2: MICRO

Ejemplo:

{

'country': 'US',

'cbsa_id': '3',

'name': 'Aberdeen, WA',

'type': '2',

'code': '10140'

}