Introducción
Bienvenido a nuestra documentación de API Megatime! Puedes usar nuestra API REST para acceder a endpoints de varios servicios, los cuales interactúan en forma directa con información de nuestra base de datos.
Tenemos ejemplos para cURL, Python y JavaScript. Puedes ver el código a la derecha (área oscura), y puedes cambiar entre los distintos lenguajes de programación usando los tabs de la zona superior derecha.
DataSuite
Obtener API Key DataSuite
import requests
import json
url = "cuenta.megatime.cl/api/auth/key"
payload = json.dumps({
"email": "user@example.com",
"password": "**********"
})
headers = {
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.json())
curl --location --request POST 'cuenta.megatime.cl/api/auth/key' \
--header 'Content-Type: application/json' \
--data-raw '{
"email": "user@example.com",
"password": "**********"
}'
var request = require("request");
var options = {
method: "POST",
url: "cuenta.megatime.cl/api/auth/key",
headers: {
"Content-Type": "application/json",
},
body: JSON.stringify({
email: "user@example.com",
password: "**********",
}),
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"key": "71e1db8n090am63ca69606c4slb8b6ta"
}
Retorna key que permite el acceso a la API.
Llamada HTTP
POST cuenta.megatime.cl/api/auth/key
Parámetros Body
| Nombre | Tipo | Descripción | Requerido |
|---|---|---|---|
| String | Correo asociado a credencial de Megatime | Sí | |
| password | String | Contraseña asociado a credencial de Megatime | Sí |
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| key | String | Llave de acceso a API |
La API espera que todas las llamadas estén autenticadas con la Api key en el Authorization header:
Authorization: SECRET_API_KEY
Obtener Pauta
import requests
url = "datasuite.megatime.cl/spots?include=1&media=1,2,3,4,5&start_date=10-03-2021&end_date=10-03-2021&brands=1,2,3,4,5&companies=1,2,3,4,5&industries=1,2,3,4,5&sub_industries=1,2,3,4,5&products=1,2,3,4,5&categories=1,2,3,4,5&qualities=1,2,3,4,5&creative_agencies=1,2,3,4,5&media_agencies=1,2,3,4,5&supports=1,2,3,4,5&group=1"
payload={}
headers = {
'Authorization': 'SECRET_API_KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
curl --location --request GET 'datasuite.megatime.cl/spots?include=0&media=1,2,3,4,5&start_date=10-03-2021&end_date=10-03-2021&brands=1,2,3,4,5&companies=1,2,3,4,5&industries=1,2,3,4,5&sub_industries=1,2,3,4,5&products=1,2,3,4,5&categories=1,2,3,4,5&qualities=1,2,3,4,5&creative_agencies=1,2,3,4,5&media_agencies=1,2,3,4,5&supports=1,2,3,4,5&group=1' \
--header 'Authorization: SECRET_API_KEY'
var request = require("request");
var options = {
method: "GET",
url: "datasuite.megatime.cl/spots?include=1&media=1,2,3,4,5&start_date=10-03-2021&end_date=10-03-2021&brands=1,2,3,4,5&companies=1,2,3,4,5&industries=1,2,3,4,5&sub_industries=1,2,3,4,5&products=1,2,3,4,5&categories=1,2,3,4,5&qualities=1,2,3,4,5&creative_agencies=1,2,3,4,5&media_agencies=1,2,3,4,5&supports=1,2,3,4,5&group=1",
headers: {
Authorization: "SECRET_API_KEY",
},
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"result": [
{
"media_id": 1,
"media": "TV Abierta",
"date": "02-02-2022",
"hour": 15,
"minute": 31,
"second": 35,
"weekday": "Jueves",
"daypart": "Tarde",
"ad_first_appearance": "10-01-2022",
"support_id": 1007,
"support": "TVN",
"advertisement_id": 597715,
"advertisement": "LIDER,SUPERMERCADO,MUJER,COMPRANDO,PARRILLEANDO",
"product_id": 98833,
"product": "LIDER,SUPERMERCADO",
"brand_id": 14000,
"brand": "LIDER",
"company_id": 47484,
"company": "WALMART CHILE",
"sub_industry_id": 5973,
"sub_industry": "SUPERMERCADO",
"industry_id": 222,
"industry": "SUPER E HIPERMERCADOS",
"category_id": 21,
"category": "COMERCIO DETALLISTA",
"quality_id": 11,
"quality": "VIDEO COLOR",
"duration": 21,
"ad_duration": 21,
"value": 2867059,
"public_value": 1879488,
"universal_id": 0,
"universal_program_id": 83052,
"ad_supplier": "",
"ad_group_location": 7,
"ad_group_spot_location": 14,
"ad_group_quantity": 16,
"failure": "s/f",
"is_sponsor": false,
"program": "MEA CULPA CLASICOS",
"event": "Apoyo",
"press_centimeter": 0,
"press_column": 0,
"press_page": 0,
"press_size": 0,
"press_module": "",
"press_supplement_id": 0,
"press_supplement": "",
"press_section_id": 0,
"press_section": "",
"ooh_element": "DESCONOCIDO",
"ooh_station": "",
"ooh_location": "",
"internet_impressions": 0,
"internet_campaign": "",
"internet_device": "",
"internet_impact": "0",
"media_agency_id": 454,
"media_agency": "OMG",
"creative_agency_id": 1,
"creative_agency": "BBDO",
"uuid": "0x6c5de827c6dc28e1e5056e8d5e7f79d9"
}
"options": [
{
"classifier": {
"ID": 22,
"name": "Beneficio"
},
"values": [
{
"ID": 61,
"name": "Club"
},
{
"ID": 65,
"name": "Alianza"
}
]
},
{
"classifier": {
"ID": 32,
"name": "Productos"
},
"values": [
{
"ID": 174,
"name": "Parrilla"
}
]
}
]
}
]
}
Ejemplo de retorno en formato JSON con error:
{
"ok": false,
"error": "\"value\" must contain at least one of [brands, companies, industries, sub_industries, products, group]"
}
Retorna una lista de avisajes con aviso asignado asociados a los filtros que se indique.
Llamada HTTP
GET datasuite.megatime.cl/spots
Parámetros URL
| Nombre | Tipo | Descripción | Requerido |
|---|---|---|---|
| include | Integer | (Por defecto: 0) 0 incluir Avisos y PNTs, 1 solo Avisos, 2 solo PNTs, 3 Todos los eventos | No |
| media | Array | Lista de ID de Medios | Si |
| start_date | String | Fecha de formato dd-mm-yyyy | Si |
| end_date | String | Fecha de formato dd-mm-yyyy | Si |
| brands | Array | Lista de ID de Marcas | No |
| companies | Array | Lista de ID de Empresas | No |
| industries | Array | Lista de ID de Rubros | No |
| sub_industries | Array | Lista de ID de Sub-Rubros | No |
| products | Array | Lista de ID de Productos | No |
| categories | Array | Lista de ID de Categorias | No |
| qualities | Array | Lista de ID de Calidades | No |
| creative_agencies | Array | Lista de ID de Agencias Creativas | No |
| media_agencies | Array | Lista de ID de Agencias de Medios | No |
| supports | Array | Lista de ID de Soportes | No |
| group | Integer | ID Grupo | No |
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| result | Array | Lista de objetos tipo Spot |
Atributos Spot
| Nombre | Tipo | Descripción |
|---|---|---|
| uuid | Integer | Identificador único del Avisaje |
| media_id | Integer | ID Medio |
| media | String | Nombre del Medio donde fue encontrado |
| date | String | Fecha de exhibición, en formato DD-MM-YYYY |
| hour | Integer | Hora de exhibición |
| minute | Integer | Minuto de exhibición |
| second | Integer | Segundo de exhibición |
| weekday | String | Día de la semana de su aparición |
| daypart | String | Franja de exhibición |
| ad_first_appearance | String | Primera aparición del aviso, en formato YYYY-MM-DD |
| support_id | Integer | ID Soporte |
| support | String | Soporte |
| advertisement_id | Integer | ID Aviso asociado |
| advertisement | String | Aviso asocicado |
| product_id | Integer | ID Producto |
| product | String | Nombre del Producto asignado al aviso |
| brand_id | Integer | ID Marca |
| brand | String | Marca asociada al producto |
| company_id | Integer | ID Empresa |
| company | String | Nombre de la Empresa asignada al aviso |
| sub_industry_id | Integer | ID Sub-Rubro |
| sub_industry | String | Nombre del Sub-Rubro asignado al Rubro |
| industry_id | Integer | ID Rubro |
| industry | String | Nombre del Rubro asignado al aviso |
| category_id | Integer | ID Categoria |
| category | String | Indica la categoria del Rubro |
| quality_id | String | ID Calidad |
| quality | String | Calidad / Tipo del aviso |
| duration | Integer | Duración real del avisaje |
| ad_duration | Integer | Duración normal del aviso |
| value | Integer | Valor Tarifa del avisaje |
| public_value | Integer | Valor Público del avisaje |
| universal_id | Integer | Código universal |
| universal_program_id | Integer | Código de programa universal |
| ad_supplier | String | En caso de ser publicidad televisiva, indica el nombre del comercializador |
| ad_group_location | Integer | En caso de publicidad televisiva o radial, indica el número de la tanda publicitaria |
| ad_group_spot_location | Integer | En caso de publicidad televisiva o radial, indica la posición del avisaje en la tanda publicitaria |
| ad_group_quantity | Integer | En caso de publicidad televisiva o radial, indica la cantidad de avisajes en la tanda publicitaria |
| failure | String | Descripción de falla |
| is_sponsor | String | Indica si es auspicio |
| program | String | Para publicidad televisiva y radial indica el nombre del Programa |
| event | String | Para publicidad televisiva y radial indica su tipo de evento |
| press_centimeter | Integer | En caso de ser publicidad en papel, indica los centimetros que abarca |
| press_columns | Integer | En caso de ser publicidad en papel, indica el número de la columna |
| press_page | Integer | En caso de ser publicidad en papel, indica el número de la pagina |
| press_size | Integer | En caso de ser publicidad en papel, indica el tamaño físico de la página |
| press_module | String | En caso de ser publicidad en papel, indica el tipo de hoja |
| press_supplement_id | Integer | ID Suplemento |
| press_supplement | String | Suplemento (Prensa) |
| press_section_id | Integer | ID Sección |
| press_section | String | En caso de ser publicidad en papel, indica en que sección de la página se encuentra |
| ooh_element | String | En caso de publicidad vial, indica el elemento donde se encuentra montada la publicidad |
| ooh_location | String | En caso de Via pública, indica la dirección. En caso de Metro, indica el lugar donde se encuentra dentro de la estación |
| ooh_station | String | En caso de publicidad en Metro, indica el nombre de la Estación |
| internet_impressions | Integer | En caso de ser publicidad en internet, indica el número de impresiones estimadas. Dato entregado por Admetricks |
| internet_campaign | String | En caso de publicidad en Internet, indica el nombre de su campaña. Dato entregado por Admetricks. |
| internet_device | String | En caso de publicidad en Internet, indica el dispositivo de visualización de la pieza publicitaria. Dato entregado por Admetricks. |
| internet_impact | Integer | En caso de publicidad en Internet, indica el porcentaje de pantalla que ocupa la pieza publicitaria. Dato entregado por Admetricks. |
| media_agency_id | Integer | ID Agrencia de medios |
| media_agency | String | Nombre de la Agencia de medios |
| creative_agency_id | Integer | ID Agencia creativa |
| creative_agency | String | Nombre de la Agencia creativa |
| options | Array | (Opcional) Solo se devuelve en caso de entregar un parámetro group. Lista de objetos Clasificación, indica las clasificacion y sus respectivas opciones |
Atributos Clasificación
| Nombre | Tipo | Descripción |
|---|---|---|
| classifier | Object | Objeto tipo Clasificador |
| values | Array | Lista de objetos tipo Opción que pertenecen a Clasificador. Esto representa todas las opciones que se le asignar a un clasificador |
Atributos Clasificación
| Nombre | Tipo | Descripción |
|---|---|---|
| ID | Integer | ID Clasificador |
| name | String | Nombre Clasificador |
Atributos Opción
| Nombre | Tipo | Descripción |
|---|---|---|
| ID | Integer | ID Opción |
| name | String | Nombre Opción |
Obtener Avisos con actividad
import requests
url = "datasuite.megatime.cl/advertisement?media=1,2,3,4,5,6,7,8&start_date=01-10-2021&end_date=31-10-2021&industries=1,2,3,4,5&brands=1,2,3,4,5&companies=1,2,3,4,5&sub_industries=1,2,3,4,5&products=1,2,3,4,5&group=1"
payload={}
headers = {
'Authorization': 'SECRET_API_KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
curl --location --request GET 'datasuite.megatime.cl/advertisement?media=1,2,3,4,5,6,7,8&start_date=01-10-2021&end_date=31-10-2021&industries=1,2,3,4,5&brands=1,2,3,4,5&companies=1,2,3,4,5&sub_industries=1,2,3,4,5&products=1,2,3,4,5&group=1' \
--header 'Authorization: SECRET_API_KEY'
var request = require("request");
var options = {
method: "GET",
url: "datasuite.megatime.cl/advertisement?media=1,2,3,4,5,6,7,8&start_date=01-10-2021&end_date=31-10-2021&industries=1,2,3,4,5&brands=1,2,3,4,5&companies=1,2,3,4,5&sub_industries=1,2,3,4,5&products=1,2,3,4,5&group=1",
headers: {
Authorization: "SECRET_API_KEY",
},
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"result": [
{
"media_id": 2,
"media": "Prensa",
"id": 1868567,
"description": "ED,BAZAR ED,CYBERMONDAY,YA COMENZO,DEL 04 AL 06 DE OCTUBRE,(ED)",
"first_appearance": "2021-10-04",
"industry": "FERIAS Y EXPOSICIONES",
"industry_id": 202,
"sub_industry": "FERIA COMERCIAL",
"sub_industry_id": 1483,
"company": "MILANO EDITORES",
"company_id": 2712,
"brand": "ED",
"brand_id": 7426,
"product": "ED,BAZAR ED,CYBERMONDAY",
"product_id": 321910,
"spot_uuid": "0xebf0e4909cc81815f05c114998db7f28"
}
]
}
Retorna una lista con todos los Avisos con actividad
Llamada HTTP
GET datasuite.megatime.cl/advertisement
Parámetros URL
| Nombre | Tipo | Descripción | Requerido |
|---|---|---|---|
| media | Array | Lista de ID de Medios | Si |
| start_date | String | Fecha de formato dd-mm-yyyy | Si |
| end_date | String | Fecha de formato dd-mm-yyyy | Si |
| brands | Array | Lista de ID de Marcas | No |
| companies | Array | Lista de ID de Empresas | No |
| industries | Array | Lista de ID de Rubros | No |
| sub_industries | Array | Lista de ID de Sub-Rubros | No |
| products | Array | Lista de ID de Productos | No |
| group | Integer | ID Grupo | No |
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| result | Array | Lista de objetos tipo Aviso |
Atributos Aviso
| Nombre | Tipo | Descripción |
|---|---|---|
| ID | Integer | Identificador de Aviso |
| media | String | Nombre del Medio donde fue encontrado |
| media_id | Integer | ID Medio |
| description | String | Descripción Aviso |
| first_appearance | String | Fecha de primera aparición |
| industry | String | Nombre del Rubro asignado al aviso |
| industry_id | Integer | ID Rubro |
| sub_industry | String | Nombre SubRubro |
| sub_industry_id | Integer | ID SubRubro |
| company | String | Nombre de la Empresa asignada al aviso |
| company_id | Integer | ID Empresa |
| brand | String | Marca asociada al producto |
| brand_id | Integer | ID Marca |
| product | String | Nombre del Producto asignado al aviso |
| product_id | Integer | ID Producto |
| sub_industry_id | Integer | ID Sub-Rubro |
| sub_industry | String | Nombre del Sub-Rubro asignado al Rubro |
| spot_uuid | String | Identificador único del Avisaje |
Obtener Medios
import requests
url = "datasuite.megatime.cl/filters/media"
payload={}
headers = {
'Authorization': 'SECRET_API_KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
curl --location --request GET 'datasuite.megatime.cl/filters/media' \
--header 'Authorization: SECRET_API_KEY'
var request = require("request");
var options = {
method: "GET",
url: "datasuite.megatime.cl/filters/media",
headers: {
Authorization: "SECRET_API_KEY",
},
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"result": [
{
"ID": 1,
"name": "TV Abierta"
}
]
}
Retorna una lista con todos los Medios.
Llamada HTTP
GET datasuite.megatime.cl/filters/media
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| result | Array | Lista de objetos tipo Medio |
Atributos Medio
| Nombre | Tipo | Descripción |
|---|---|---|
| ID | Integer | ID |
| name | String | Nombre |
Obtener Marcas
import requests
url = "datasuite.megatime.cl/filters/brands?start_date=02-04-2022&end_date=08-06-2022&media=1,2,3&industries=1,2,3&sub_industries=1,2,3&companies=1,2,3&categories=1,2,3"
payload={}
headers = {
'Authorization': 'SECRET_API_KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
curl --location --request GET 'datasuite.megatime.cl/filters/brands?start_date=02-04-2022&end_date=08-06-2022&media=1,2,3&industries=1,2,3&sub_industries=1,2,3&companies=1,2,3&categories=1,2,3' \
--header 'Authorization: SECRET_API_KEY'
var request = require("request");
var options = {
method: "GET",
url: "datasuite.megatime.cl/filters/brands?start_date=02-04-2022&end_date=08-06-2022&media=1,2,3&industries=1,2,3&sub_industries=1,2,3&companies=1,2,3&categories=1,2,3",
headers: {
Authorization: "SECRET_API_KEY",
},
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"result": [
{
"ID": 1,
"name": "TARGET,SOFTWARE"
}
]
}
Retorna una lista con todas las marcas
Llamada HTTP
GET datasuite.megatime.cl/filters/brands
Parámetros URL
| Nombre | Tipo | Descripción |
|---|---|---|
| start_date | String | Fecha de formato dd-mm-yyyy |
| end_date | String | Fecha de formato dd-mm-yyyy |
| industries | Array | Lista de ID de Rubros |
| media | Array | Lista de ID de Medios |
| sub_industries | Array | Lista de ID de Sub-Rubros |
| companies | Array | Lista de ID de Empresas |
| categories | Array | Lista de ID de Categorias |
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| result | Array | Lista de objetos tipo Marca |
Atributos Marca
| Nombre | Tipo | Descripción |
|---|---|---|
| ID | Integer | ID |
| name | String | Nombre |
Obtener Empresas
import requests
url = "datasuite.megatime.cl/filters/companies?start_date=01-03-2022&end_date=07-06-2022&media=1,2,3&industries=1,2,3&sub_industries=1,2,3&categories=1,2,3"
payload={}
headers = {
'Authorization': 'SECRET_API_KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
curl --location --request GET 'datasuite.megatime.cl/filters/companies?start_date=01-03-2022&end_date=07-06-2022&media=1,2,3&industries=1,2,3&sub_industries=1,2,3&categories=1,2,3' \
--header 'Authorization: SECRET_API_KEY'
var request = require("request");
var options = {
method: "GET",
url: "datasuite.megatime.cl/filters/companies?start_date=01-03-2022&end_date=07-06-2022&media=1,2,3&industries=1,2,3&sub_industries=1,2,3&categories=1,2,3",
headers: {
Authorization: "SECRET_API_KEY",
},
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"result": [
{
"ID": 28911,
"name": "SALMONES MULTIEXPORT LTDA"
}
]
}
Retorna una lista con todas las Empresas
Llamada HTTP
GET datasuite.megatime.cl/filters/companies
Parámetros URL
| Nombre | Tipo | Descripción |
|---|---|---|
| start_date | String | Fecha de formato dd-mm-yyyy |
| end_date | String | Fecha de formato dd-mm-yyyy |
| industries | Array | Lista de ID de Rubros |
| media | Array | Lista de ID de Medios |
| sub_industries | Array | Lista de ID de Sub-Rubros |
| categories | Array | Lista de ID de Categorias |
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| result | Array | Lista de objetos tipo Empresa |
Atributos Empresa
| Nombre | Tipo | Descripción |
|---|---|---|
| ID | Integer | ID |
| name | String | Nombre |
Obtener Rubros
import requests
url = "datasuite.megatime.cl/filters/industries?start_date=01-04-2022&end_date=07-06-2022&categories=1,2,3&media=1,2,3"
payload={}
headers = {
'Authorization': 'SECRET_API_KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
curl --location --request GET 'datasuite.megatime.cl/filters/industries?start_date=01-04-2022&end_date=07-06-2022&categories=1,2,3&media=1,2,3' \
--header 'Authorization: SECRET_API_KEY'
var request = require("request");
var options = {
method: "GET",
url: "datasuite.megatime.cl/filters/industries?start_date=01-04-2022&end_date=07-06-2022&categories=1,2,3&media=1,2,3",
headers: {
Authorization: "SECRET_API_KEY",
},
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"result": [
{
"ID": 1,
"name": "PRODUCTOS PARA LA AGRICULTURA"
}
]
}
Retorna una lista con todos los Rubros
Llamada HTTP
GET datasuite.megatime.cl/filters/industries
Parámetros URL
| Nombre | Tipo | Descripción |
|---|---|---|
| start_date | String | Fecha de formato dd-mm-yyyy |
| end_date | String | Fecha de formato dd-mm-yyyy |
| media | Array | Lista de ID de Medios |
| categories | Array | Lista de ID de Categorias |
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| result | Array | Lista de objetos tipo Rubro |
Atributos Rubro
| Nombre | Tipo | Descripción |
|---|---|---|
| ID | Integer | ID |
| name | String | Nombre |
Obtener Sub-Rubros
import requests
url = "datasuite.megatime.cl/filters/subindustries?start_date=01-04-2022&end_date=07-06-2022&categories=1,2,3&media=1,2,3&companies=1,2,3"
payload={}
headers = {
'Authorization': 'SECRET_API_KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
curl --location --request GET 'datasuite.megatime.cl/filters/subindustries?start_date=01-04-2022&end_date=07-06-2022&categories=1,2,3&media=1,2,3&companies=1,2,3' \
--header 'Authorization: SECRET_API_KEY'
var request = require("request");
var options = {
method: "GET",
url: "datasuite.megatime.cl/filters/subindustries?start_date=01-04-2022&end_date=07-06-2022&categories=1,2,3&media=1,2,3&companies=1,2,3",
headers: {
Authorization: "SECRET_API_KEY",
},
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"result": [
{
"ID": 1,
"name": "AVENA",
"industry_id": 17
}
]
}
Retorna una lista con todos los Sub-Rubros
Llamada HTTP
GET datasuite.megatime.cl/filters/subindustries
Parámetros URL
| Nombre | Tipo | Descripción |
|---|---|---|
| start_date | String | Fecha de formato dd-mm-yyyy |
| end_date | String | Fecha de formato dd-mm-yyyy |
| media | Array | Lista de ID de Medios |
| categories | Array | Lista de ID de Categorias |
| companies | Arrat | Lista de ID de Empresas |
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| result | Array | Lista de objetos tipo Sub-Rubro |
Atributos Sub-Rubro
| Nombre | Tipo | Descripción |
|---|---|---|
| ID | Integer | ID |
| name | String | Nombre |
| industry_id | String | ID Rubro asociado |
Obtener Productos
import requests
url = "datasuite.megatime.cl/filters/products?brands=1,2,3&media=1,2,3&start_date=01-01-2021&end_date=12-07-2022&companies=1,2,3&sub_industries=1,2,3&categories=1,2,3&industries=1,2,3"
payload={}
headers = {
'Authorization': 'SECRET_API_KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
curl --location --request GET 'datasuite.megatime.cl/filters/products?brands=1,2,3&media=1,2,3&start_date=01-01-2021&end_date=12-07-2022&companies=1,2,3&sub_industries=1,2,3&categories=1,2,3&industries=1,2,3' \
--header 'Authorization: SECRET_API_KEY'
var request = require("request");
var options = {
method: "GET",
url: "datasuite.megatime.cl/filters/products?brands=1,2,3&media=1,2,3&start_date=01-01-2021&end_date=12-07-2022&companies=1,2,3&sub_industries=1,2,3&categories=1,2,3&industries=1,2,3",
headers: {
Authorization: "SECRET_API_KEY",
},
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"result": [
{
"ID": 1,
"name": "DEYCO,CONSERVAS",
"company_id": 70,
"brand_id": 6748,
"sub_industry_id": 10130
}
]
}
Retorna una lista con todos los Productos
Llamada HTTP
GET datasuite.megatime.cl/filters/products
Parámetros URL
| Nombre | Tipo | Descripción |
|---|---|---|
| start_date | String | Fecha de formato dd-mm-yyyy |
| end_date | String | Fecha de formato dd-mm-yyyy |
| industries | Array | Lista de ID de Rubros |
| media | Array | Lista de ID de Medios |
| sub_industries | Array | Lista de ID de Sub-Rubros |
| categories | Array | Lista de ID de Categorias |
| companies | Array | Lista de ID de Empresas |
| brands | Array | Lista de ID de Marcas |
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| result | Array | Lista de objetos tipo Producto |
Atributos Producto
| Nombre | Tipo | Descripción |
|---|---|---|
| ID | Integer | ID |
| name | String | Nombre |
| company_id | Integer | ID Empresa asociada |
| brand_id | Integer | ID Marca asociada |
| sub_industry_id | String | ID Sub-Rubro asociado |
Obtener Categorias
import requests
url = "datasuite.megatime.cl/filters/categories"
payload={}
headers = {
'Authorization': 'SECRET_API_KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
curl --location --request GET 'datasuite.megatime.cl/filters/categories' \
--header 'Authorization: SECRET_API_KEY'
var request = require("request");
var options = {
method: "GET",
url: "datasuite.megatime.cl/filters/categories",
headers: {
Authorization: "SECRET_API_KEY",
},
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"result": [
{
"ID": 1,
"name": "AGROPECUARIO"
}
]
}
Retorna una lista con todas las Categorias
Llamada HTTP
GET datasuite.megatime.cl/filters/categories
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| result | Array | Lista de objetos tipo Catergoria |
Atributos Categoria
| Nombre | Tipo | Descripción |
|---|---|---|
| ID | Integer | ID |
| name | String | Nombre |
Obtener Calidades
import requests
url = "datasuite.megatime.cl/filters/qualities"
payload={}
headers = {
'Authorization': 'SECRET_API_KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
curl --location --request GET 'datasuite.megatime.cl/filters/qualities' \
--header 'Authorization: SECRET_API_KEY'
var request = require("request");
var options = {
method: "GET",
url: "datasuite.megatime.cl/filters/qualities",
headers: {
Authorization: "SECRET_API_KEY",
},
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"result": [
{
"ID": 11,
"name": "VIDEO COLOR",
"short": "VC",
"media_id": 1
}
]
}
Retorna una lista con todas las Calidades
Llamada HTTP
GET datasuite.megatime.cl/filters/qualities
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| result | Array | Lista de objetos tipo Calidad |
Atributos Calidad
| Nombre | Tipo | Descripción |
|---|---|---|
| ID | Integer | ID |
| name | String | Nombre |
| short | String | Abreviación |
| medio_id | String | ID Medio |
Obtener Agencias Creativas
import requests
url = "datasuite.megatime.cl/filters/creativeagencies"
payload={}
headers = {
'Authorization': 'SECRET_API_KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
curl --location --request GET 'datasuite.megatime.cl/filters/creativeagencies' \
--header 'Authorization: SECRET_API_KEY'
var request = require("request");
var options = {
method: "GET",
url: "datasuite.megatime.cl/filters/creativeagencies",
headers: {
Authorization: "SECRET_API_KEY",
},
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"result": [
{
"ID": 1,
"name": "BBDO",
"short": "BBDO"
}
]
}
Retorna una lista con todas las Agencias Creativas
Llamada HTTP
GET datasuite.megatime.cl/filters/creativeagencies
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| result | Array | Lista de objetos tipo Agencia Creativa |
Atributos Agencias Creativa
| Nombre | Tipo | Descripción |
|---|---|---|
| ID | Integer | ID |
| name | String | Nombre |
| short | String | Abreviación |
Obtener Agencias de Medios
import requests
url = "datasuite.megatime.cl/filters/mediaagencies"
payload={}
headers = {
'Authorization': 'SECRET_API_KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
curl --location --request GET 'datasuite.megatime.cl/filters/mediaagencies' \
--header 'Authorization: SECRET_API_KEY'
var request = require("request");
var options = {
method: "GET",
url: "datasuite.megatime.cl/filters/mediaagencies",
headers: {
Authorization: "SECRET_API_KEY",
},
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"result": [
{
"ID": 1,
"name": "BBDO",
"short": "BBDO"
}
]
}
Retorna una lista con todas las Agencias de Medios
Llamada HTTP
GET datasuite.megatime.cl/filters/mediaagencies
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| result | Array | Lista de objetos tipo Agencia de Medios |
Atributos Agencias de Medios
| Nombre | Tipo | Descripción |
|---|---|---|
| ID | Integer | ID |
| name | String | Nombre |
| short | String | Abreviación |
Obtener Soportes
import requests
url = "datasuite.megatime.cl/filters/supports"
payload={}
headers = {
'Authorization': 'SECRET_API_KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
curl --location --request GET 'datasuite.megatime.cl/filters/supports' \
--header 'Authorization: SECRET_API_KEY'
var request = require("request");
var options = {
method: "GET",
url: "datasuite.megatime.cl/filters/supports",
headers: {
Authorization: "SECRET_API_KEY",
},
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"result": [
{
"ID": 1,
"name": "BBDO",
"short": "BBDO",
"media_id": 1
}
]
}
Retorna una lista con todas las Agencias de Medios
Llamada HTTP
GET datasuite.megatime.cl/filters/supports
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| result | Array | Lista de objetos tipo Soportes |
Atributos Agencias de Medios
| Nombre | Tipo | Descripción |
|---|---|---|
| ID | Integer | ID |
| name | String | Nombre |
| short | String | Abreviación |
| media_id | String | ID Medio |
Obtener Grupos personalizados
import requests
url = "datasuite.megatime.cl/filters/groups"
payload={}
headers = {
'Authorization': 'SECRET_API_KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
curl --location --request GET 'datasuite.megatime.cl/filters/groups' \
--header 'Authorization: SECRET_API_KEY'
var request = require("request");
var options = {
method: "GET",
url: "datasuite.megatime.cl/filters/groups",
headers: {
Authorization: "SECRET_API_KEY",
},
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"result": [
{
"ID": 3,
"name": "Bancos",
"obs": ""
}
]
}
Retorna una lista con todos los Grupos personalizados por el cliente
Llamada HTTP
GET datasuite.megatime.cl/filters/groups
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| result | Array | Lista de objetos tipo Grupo |
Atributos Grupo
| Nombre | Tipo | Descripción |
|---|---|---|
| ID | Integer | ID |
| name | String | Nombre |
| obs | String | Observación |
Crear Grupo personalizado
import requests
import json
url = "datasuite.megatime.cl/filters/groups"
payload = json.dumps({
"name": "Test nuevo grupo",
"obs": "Observacion",
"brands": [
24,
42
]
})
headers = {
'Authorization': 'SECRET_API_KEY',
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
curl --location --request POST 'datasuite.megatime.cl/filters/groups' \
--header 'Authorization: SECRET_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
"name": "Test New Group",
"obs": "Observacion",
"brands": [24,42]
}'
var request = require("request");
var options = {
method: "POST",
url: "datasuite.megatime.cl/filters/groups",
headers: {
Authorization: "SECRET_API_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({
name: "Test New Group",
obs: "Observacion",
brands: [24, 42],
}),
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"ID": 64,
"message": "Grupo creado correctamente"
}
Request para crear un nuevo Grupo Personalizado, responde con el ID del nuevo grupo.
Para asignar Clasificadores y Opciones, debe dirigirse a clasificador.megatime.cl
Llamada HTTP
POST datasuite.megatime.cl/filters/groups
Párametros Body
| Nombre | Tipo | Descripción | Requerido |
|---|---|---|---|
| name | String | Nombre de grupo | Si |
| obs | String | Observación | No |
| brands | Array | Lista de IDs de marcas para asignar al nuevo grupo | Si |
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| ID | Integer | ID grupo creado |
| message | String | Mensaje de estado |
Obtener Registro Cargas
import requests
url = "datasuite.megatime.cl/spots/loads?date=17-02-2022T16:41:10:240&media=1,6"
payload={}
headers = {
'Authorization': 'SECRET_API_KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
curl --location --request GET 'datasuite.megatime.cl/spots/loads?date=17-02-2022T16:41:10:240&media=1,6' \
--header 'Authorization: SECRET_API_KEY'
var request = require("request");
var options = {
method: "GET",
url: "datasuite.megatime.cl/spots/loads?date=17-02-2022T16:41:10:240&media=1,6",
headers: {
Authorization: "SECRET_API_KEY",
},
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"result": [
{
"media_id": 1,
"date": "17-03-2022",
"rows": 7345,
"upload_datetime": "18-03-2022T09:08:58:387"
},
{
"media_id": 6,
"date": "22-01-2021",
"rows": 21830,
"upload_datetime": "17-03-2022T22:22:58:750"
}
]
}
Retorna una lista de las últimas publicaciones de registros con fecha y medio
Llamada HTTP
GET datasuite.megatime.cl/spots/loads
Parámetros URL
| Nombre | Requerido | Descripción |
|---|---|---|
| date | No | Filtro de Fecha-Tiempo en formato dd-mm-yyyyThh:mi:ss:mmm. Permite mostrar sólo publicaciones de cargas mayores a la fecha ingresada |
| media | No | Lista de ID de Medios |
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| result | Array | Lista de objetos tipo Carga |
Atributos Carga
| Nombre | Tipo | Descripción |
|---|---|---|
| medio_id | Integer | ID del medio |
| date | String | Fecha del día publicado en formato dd-mm-yyyy |
| rows | Integer | Cantidad de registros en fecha - medio |
| upload_datetime | String | Fecha de publicación de la carga en formato dd-mm-yyyyThh:mi:ss:mmm |
DataSuite V2
DataSuite V2 mantiene la misma funcionalidad que V1 con mejoras significativas en el endpoint de obtener pauta.
Cambios principales
Diferencias clave con V1 en endpoint "Obtener Pauta":
- Parámetros de fecha: Usa solo
date(fecha única) en lugar destart_dateyend_date - Parámetro media: Requiere un solo ID de medio en lugar de una lista
- Respuesta extendida: Incluye nuevos campos específicos por tipo de medio
- Performance optimizada: Consultas SQL más eficientes
Migración desde V1
Cambios en parámetros
V1:
GET /spots?media=1,2,3&start_date=10-03-2021&end_date=10-03-2021&brands=1,2,3
V2:
GET /v2/spots?media=1&date=10-03-2021&brands=1,2,3
Consideraciones de migración
- Múltiples medios: En V2 debes hacer una llamada por cada medio
- Rango de fechas: En V2 debes hacer una llamada por cada fecha
- Campos adicionales: V2 incluye más información detallada
- Performance: V2 es más eficiente para consultas específicas
Ejemplo de migración
# V1 - Una llamada para múltiples medios y fechas
response_v1 = requests.get('datasuite.megatime.cl/spots?media=1,2,3&start_date=10-03-2021&end_date=12-03-2021&brands=1,2,3')
# V2 - Múltiples llamadas más específicas
results_v2 = []
for media_id in [1, 2, 3]:
for date in ['10-03-2021', '11-03-2021', '12-03-2021']:
response = requests.get(f'datasuite.megatime.cl/v2/spots?media={media_id}&date={date}&brands=1,2,3')
results_v2.extend(response.json()['result'])
Obtener API Key DataSuite
import requests
import json
url = "cuenta.megatime.cl/api/auth/key"
payload = json.dumps({
"email": "user@example.com",
"password": "**********"
})
headers = {
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.json())
curl --location --request POST 'cuenta.megatime.cl/api/auth/key' \
--header 'Content-Type: application/json' \
--data-raw '{
"email": "user@example.com",
"password": "**********"
}'
var request = require("request");
var options = {
method: "POST",
url: "cuenta.megatime.cl/api/auth/key",
headers: {
"Content-Type": "application/json",
},
body: JSON.stringify({
email: "user@example.com",
password: "**********",
}),
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"key": "71e1db8n090am63ca69606c4slb8b6ta"
}
Retorna key que permite el acceso a la API.
Llamada HTTP
POST cuenta.megatime.cl/api/auth/key
Parámetros Body
| Nombre | Tipo | Descripción | Requerido |
|---|---|---|---|
| String | Correo asociado a credencial de Megatime | Sí | |
| password | String | Contraseña asociado a credencial de Megatime | Sí |
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| key | String | Llave de acceso a API |
La API espera que todas las llamadas estén autenticadas con la Api key en el Authorization header:
Authorization: SECRET_API_KEY
Obtener Pauta
import requests
url = "datasuite.megatime.cl/v2/spots?media=1&date=10-03-2021&brands=1,2,3,4,5&companies=1,2,3,4,5&industries=1,2,3,4,5&sub_industries=1,2,3,4,5&products=1,2,3,4,5&categories=1,2,3,4,5&qualities=1,2,3,4,5&creative_agencies=1,2,3,4,5&media_agencies=1,2,3,4,5&supports=1,2,3,4,5&group=1"
payload={}
headers = {
'Authorization': 'SECRET_API_KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
curl --location --request GET 'datasuite.megatime.cl/v2/spots?media=1&date=10-03-2021&brands=1,2,3,4,5&companies=1,2,3,4,5&industries=1,2,3,4,5&sub_industries=1,2,3,4,5&products=1,2,3,4,5&categories=1,2,3,4,5&qualities=1,2,3,4,5&creative_agencies=1,2,3,4,5&media_agencies=1,2,3,4,5&supports=1,2,3,4,5&group=1' \
--header 'Authorization: SECRET_API_KEY'
var request = require("request");
var options = {
method: "GET",
url: "datasuite.megatime.cl/v2/spots?media=1&date=10-03-2021&brands=1,2,3,4,5&companies=1,2,3,4,5&industries=1,2,3,4,5&sub_industries=1,2,3,4,5&products=1,2,3,4,5&categories=1,2,3,4,5&qualities=1,2,3,4,5&creative_agencies=1,2,3,4,5&media_agencies=1,2,3,4,5&supports=1,2,3,4,5&group=1",
headers: {
Authorization: "SECRET_API_KEY",
},
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"result": [
{
"ID": 123456789,
"media_id": 1,
"media": "TV Abierta",
"date": "02-02-2022",
"hour": 15,
"minute": 31,
"second": 35,
"weekday": "Jueves",
"daypart": "Tarde",
"program_id": 83052,
"program_name": "MEA CULPA CLASICOS",
"schedule_id": 1001,
"schedule_name": "Tarde",
"ad_first_appearance": "10-01-2022",
"support_id": 1007,
"support": "TVN",
"advertisement_id": 597715,
"advertisement": "LIDER,SUPERMERCADO,MUJER,COMPRANDO,PARRILLEANDO",
"product_id": 98833,
"product": "LIDER,SUPERMERCADO",
"brand_id": 14000,
"brand": "LIDER",
"company_id": 47484,
"company": "WALMART CHILE",
"sub_industry_id": 5973,
"sub_industry": "SUPERMERCADO",
"industry_id": 222,
"industry": "SUPER E HIPERMERCADOS",
"category_id": 21,
"category": "COMERCIO DETALLISTA",
"quality_id": 11,
"quality": "VIDEO COLOR",
"duration": 21,
"ad_duration": 21,
"value": 2867059,
"public_value": 1879488,
"universal_id": 0,
"universal_program_id": 83052,
"ad_supplier": "",
"ad_group_location": 7,
"ad_group_spot_location": 14,
"ad_group_quantity": 16,
"failure": "s/f",
"is_sponsor": false,
"program": "MEA CULPA CLASICOS",
"event": "Apoyo",
"event_id": "A",
"press_centimeter": 0,
"press_column": 0,
"press_page": 0,
"press_size": 0,
"press_module": "",
"press_supplement_id": 0,
"press_supplement": "",
"press_section_id": 0,
"press_section": "",
"vp_location_id": 0,
"vp_element_id": 0,
"commune_id": 0,
"commune": "",
"ooh_element": "DESCONOCIDO",
"ooh_station": "",
"ooh_location": "",
"metro_location_id": 0,
"metro_element_id": 0,
"station_id": 0,
"internet_banner_id": 0,
"internet_impressions": 0,
"internet_campaign": "",
"campaign_id": 0,
"internet_device": "",
"internet_impact": "0",
"media_agency_id": 454,
"media_agency": "OMG",
"creative_agency_id": 1,
"creative_agency": "BBDO",
"uuid": "0x6c5de827c6dc28e1e5056e8d5e7f79d9"
}
]
}
Retorna una lista de avisajes para una fecha y medio específico.
Llamada HTTP
GET datasuite.megatime.cl/v2/spots
Parámetros URL
| Nombre | Tipo | Descripción | Requerido |
|---|---|---|---|
| include | Integer | (Por defecto: 0) 0 incluir Avisos y PNTs, 1 solo Avisos, 2 solo PNTs, 3 Todos los eventos | No |
| media | Integer | ID de Medio | Si |
| date | String | Fecha de formato dd-mm-yyyy | Si |
| brands | Array | Lista de ID de Marcas | No |
| companies | Array | Lista de ID de Empresas | No |
| industries | Array | Lista de ID de Rubros | No |
| sub_industries | Array | Lista de ID de Sub-Rubros | No |
| products | Array | Lista de ID de Productos | No |
| categories | Array | Lista de ID de Categorias | No |
| qualities | Array | Lista de ID de Calidades | No |
| creative_agencies | Array | Lista de ID de Agencias Creativas | No |
| media_agencies | Array | Lista de ID de Agencias de Medios | No |
| supports | Array | Lista de ID de Soportes | No |
| group | Integer | ID Grupo | No |
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| result | Array | Lista de objetos tipo Spot |
Nuevos Atributos Spot
Además de todos los campos de V1, V2 incluye:
| Nombre | Tipo | Descripción |
|---|---|---|
| ID | Integer | Identificador único interno del avisaje |
| program_id | Integer | ID del programa (TV/Cable/Radio) |
| program_name | String | Nombre del programa (TV/Cable) |
| schedule_id | Integer | ID del horario (TV/Cable) |
| schedule_name | String | Nombre del horario/franja (TV/Cable) |
| event_id | String | ID del evento (A=Aviso, U=Auspicio) |
| vp_location_id | Integer | ID ubicación vía pública |
| vp_element_id | Integer | ID elemento vía pública |
| commune_id | Integer | ID comuna (vía pública) |
| commune | String | Nombre comuna (vía pública) |
| metro_location_id | Integer | ID ubicación metro |
| metro_element_id | Integer | ID elemento metro |
| station_id | Integer | ID estación (metro) |
| internet_banner_id | Integer | ID banner (internet) |
| campaign_id | Integer | ID campaña (internet) |
Obtener Avisos con actividad
import requests
url = "datasuite.megatime.cl/advertisement?media=1,2,3,4,5,6,7,8&start_date=01-10-2021&end_date=31-10-2021&industries=1,2,3,4,5&brands=1,2,3,4,5&companies=1,2,3,4,5&sub_industries=1,2,3,4,5&products=1,2,3,4,5&group=1"
payload={}
headers = {
'Authorization': 'SECRET_API_KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
curl --location --request GET 'datasuite.megatime.cl/advertisement?media=1,2,3,4,5,6,7,8&start_date=01-10-2021&end_date=31-10-2021&industries=1,2,3,4,5&brands=1,2,3,4,5&companies=1,2,3,4,5&sub_industries=1,2,3,4,5&products=1,2,3,4,5&group=1' \
--header 'Authorization: SECRET_API_KEY'
var request = require("request");
var options = {
method: "GET",
url: "datasuite.megatime.cl/advertisement?media=1,2,3,4,5,6,7,8&start_date=01-10-2021&end_date=31-10-2021&industries=1,2,3,4,5&brands=1,2,3,4,5&companies=1,2,3,4,5&sub_industries=1,2,3,4,5&products=1,2,3,4,5&group=1",
headers: {
Authorization: "SECRET_API_KEY",
},
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"result": [
{
"media_id": 2,
"media": "Prensa",
"id": 1868567,
"description": "ED,BAZAR ED,CYBERMONDAY,YA COMENZO,DEL 04 AL 06 DE OCTUBRE,(ED)",
"first_appearance": "2021-10-04",
"industry": "FERIAS Y EXPOSICIONES",
"industry_id": 202,
"sub_industry": "FERIA COMERCIAL",
"sub_industry_id": 1483,
"company": "MILANO EDITORES",
"company_id": 2712,
"brand": "ED",
"brand_id": 7426,
"product": "ED,BAZAR ED,CYBERMONDAY",
"product_id": 321910,
"spot_uuid": "0xebf0e4909cc81815f05c114998db7f28"
}
]
}
Retorna una lista con todos los Avisos con actividad
Llamada HTTP
GET datasuite.megatime.cl/advertisement
Parámetros URL
| Nombre | Tipo | Descripción | Requerido |
|---|---|---|---|
| media | Array | Lista de ID de Medios | Si |
| start_date | String | Fecha de formato dd-mm-yyyy | Si |
| end_date | String | Fecha de formato dd-mm-yyyy | Si |
| brands | Array | Lista de ID de Marcas | No |
| companies | Array | Lista de ID de Empresas | No |
| industries | Array | Lista de ID de Rubros | No |
| sub_industries | Array | Lista de ID de Sub-Rubros | No |
| products | Array | Lista de ID de Productos | No |
| group | Integer | ID Grupo | No |
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| result | Array | Lista de objetos tipo Aviso |
Atributos Aviso
| Nombre | Tipo | Descripción |
|---|---|---|
| ID | Integer | Identificador de Aviso |
| media | String | Nombre del Medio donde fue encontrado |
| media_id | Integer | ID Medio |
| description | String | Descripción Aviso |
| first_appearance | String | Fecha de primera aparición |
| industry | String | Nombre del Rubro asignado al aviso |
| industry_id | Integer | ID Rubro |
| sub_industry | String | Nombre SubRubro |
| sub_industry_id | Integer | ID SubRubro |
| company | String | Nombre de la Empresa asignada al aviso |
| company_id | Integer | ID Empresa |
| brand | String | Marca asociada al producto |
| brand_id | Integer | ID Marca |
| product | String | Nombre del Producto asignado al aviso |
| product_id | Integer | ID Producto |
| sub_industry_id | Integer | ID Sub-Rubro |
| sub_industry | String | Nombre del Sub-Rubro asignado al Rubro |
| spot_uuid | String | Identificador único del Avisaje |
Obtener Medios
import requests
url = "datasuite.megatime.cl/filters/media"
payload={}
headers = {
'Authorization': 'SECRET_API_KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
curl --location --request GET 'datasuite.megatime.cl/filters/media' \
--header 'Authorization: SECRET_API_KEY'
var request = require("request");
var options = {
method: "GET",
url: "datasuite.megatime.cl/filters/media",
headers: {
Authorization: "SECRET_API_KEY",
},
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"result": [
{
"ID": 1,
"name": "TV Abierta"
}
]
}
Retorna una lista con todos los Medios.
Llamada HTTP
GET datasuite.megatime.cl/filters/media
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| result | Array | Lista de objetos tipo Medio |
Atributos Medio
| Nombre | Tipo | Descripción |
|---|---|---|
| ID | Integer | ID |
| name | String | Nombre |
Obtener Marcas
import requests
url = "datasuite.megatime.cl/filters/brands?start_date=02-04-2022&end_date=08-06-2022&media=1,2,3&industries=1,2,3&sub_industries=1,2,3&companies=1,2,3&categories=1,2,3"
payload={}
headers = {
'Authorization': 'SECRET_API_KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
curl --location --request GET 'datasuite.megatime.cl/filters/brands?start_date=02-04-2022&end_date=08-06-2022&media=1,2,3&industries=1,2,3&sub_industries=1,2,3&companies=1,2,3&categories=1,2,3' \
--header 'Authorization: SECRET_API_KEY'
var request = require("request");
var options = {
method: "GET",
url: "datasuite.megatime.cl/filters/brands?start_date=02-04-2022&end_date=08-06-2022&media=1,2,3&industries=1,2,3&sub_industries=1,2,3&companies=1,2,3&categories=1,2,3",
headers: {
Authorization: "SECRET_API_KEY",
},
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"result": [
{
"ID": 1,
"name": "TARGET,SOFTWARE"
}
]
}
Retorna una lista con todas las marcas
Llamada HTTP
GET datasuite.megatime.cl/filters/brands
Parámetros URL
| Nombre | Tipo | Descripción |
|---|---|---|
| start_date | String | Fecha de formato dd-mm-yyyy |
| end_date | String | Fecha de formato dd-mm-yyyy |
| industries | Array | Lista de ID de Rubros |
| media | Array | Lista de ID de Medios |
| sub_industries | Array | Lista de ID de Sub-Rubros |
| companies | Array | Lista de ID de Empresas |
| categories | Array | Lista de ID de Categorias |
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| result | Array | Lista de objetos tipo Marca |
Atributos Marca
| Nombre | Tipo | Descripción |
|---|---|---|
| ID | Integer | ID |
| name | String | Nombre |
Obtener Empresas
import requests
url = "datasuite.megatime.cl/filters/companies?start_date=01-03-2022&end_date=07-06-2022&media=1,2,3&industries=1,2,3&sub_industries=1,2,3&categories=1,2,3"
payload={}
headers = {
'Authorization': 'SECRET_API_KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
curl --location --request GET 'datasuite.megatime.cl/filters/companies?start_date=01-03-2022&end_date=07-06-2022&media=1,2,3&industries=1,2,3&sub_industries=1,2,3&categories=1,2,3' \
--header 'Authorization: SECRET_API_KEY'
var request = require("request");
var options = {
method: "GET",
url: "datasuite.megatime.cl/filters/companies?start_date=01-03-2022&end_date=07-06-2022&media=1,2,3&industries=1,2,3&sub_industries=1,2,3&categories=1,2,3",
headers: {
Authorization: "SECRET_API_KEY",
},
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"result": [
{
"ID": 28911,
"name": "SALMONES MULTIEXPORT LTDA"
}
]
}
Retorna una lista con todas las Empresas
Llamada HTTP
GET datasuite.megatime.cl/filters/companies
Parámetros URL
| Nombre | Tipo | Descripción |
|---|---|---|
| start_date | String | Fecha de formato dd-mm-yyyy |
| end_date | String | Fecha de formato dd-mm-yyyy |
| industries | Array | Lista de ID de Rubros |
| media | Array | Lista de ID de Medios |
| sub_industries | Array | Lista de ID de Sub-Rubros |
| categories | Array | Lista de ID de Categorias |
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| result | Array | Lista de objetos tipo Empresa |
Atributos Empresa
| Nombre | Tipo | Descripción |
|---|---|---|
| ID | Integer | ID |
| name | String | Nombre |
Obtener Rubros
import requests
url = "datasuite.megatime.cl/filters/industries?start_date=01-04-2022&end_date=07-06-2022&categories=1,2,3&media=1,2,3"
payload={}
headers = {
'Authorization': 'SECRET_API_KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
curl --location --request GET 'datasuite.megatime.cl/filters/industries?start_date=01-04-2022&end_date=07-06-2022&categories=1,2,3&media=1,2,3' \
--header 'Authorization: SECRET_API_KEY'
var request = require("request");
var options = {
method: "GET",
url: "datasuite.megatime.cl/filters/industries?start_date=01-04-2022&end_date=07-06-2022&categories=1,2,3&media=1,2,3",
headers: {
Authorization: "SECRET_API_KEY",
},
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"result": [
{
"ID": 1,
"name": "PRODUCTOS PARA LA AGRICULTURA"
}
]
}
Retorna una lista con todos los Rubros
Llamada HTTP
GET datasuite.megatime.cl/filters/industries
Parámetros URL
| Nombre | Tipo | Descripción |
|---|---|---|
| start_date | String | Fecha de formato dd-mm-yyyy |
| end_date | String | Fecha de formato dd-mm-yyyy |
| media | Array | Lista de ID de Medios |
| categories | Array | Lista de ID de Categorias |
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| result | Array | Lista de objetos tipo Rubro |
Atributos Rubro
| Nombre | Tipo | Descripción |
|---|---|---|
| ID | Integer | ID |
| name | String | Nombre |
Obtener Sub-Rubros
import requests
url = "datasuite.megatime.cl/filters/subindustries?start_date=01-04-2022&end_date=07-06-2022&categories=1,2,3&media=1,2,3&companies=1,2,3"
payload={}
headers = {
'Authorization': 'SECRET_API_KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
curl --location --request GET 'datasuite.megatime.cl/filters/subindustries?start_date=01-04-2022&end_date=07-06-2022&categories=1,2,3&media=1,2,3&companies=1,2,3' \
--header 'Authorization: SECRET_API_KEY'
var request = require("request");
var options = {
method: "GET",
url: "datasuite.megatime.cl/filters/subindustries?start_date=01-04-2022&end_date=07-06-2022&categories=1,2,3&media=1,2,3&companies=1,2,3",
headers: {
Authorization: "SECRET_API_KEY",
},
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"result": [
{
"ID": 1,
"name": "AVENA",
"industry_id": 17
}
]
}
Retorna una lista con todos los Sub-Rubros
Llamada HTTP
GET datasuite.megatime.cl/filters/subindustries
Parámetros URL
| Nombre | Tipo | Descripción |
|---|---|---|
| start_date | String | Fecha de formato dd-mm-yyyy |
| end_date | String | Fecha de formato dd-mm-yyyy |
| media | Array | Lista de ID de Medios |
| categories | Array | Lista de ID de Categorias |
| companies | Arrat | Lista de ID de Empresas |
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| result | Array | Lista de objetos tipo Sub-Rubro |
Atributos Sub-Rubro
| Nombre | Tipo | Descripción |
|---|---|---|
| ID | Integer | ID |
| name | String | Nombre |
| industry_id | String | ID Rubro asociado |
Obtener Productos
import requests
url = "datasuite.megatime.cl/filters/products?brands=1,2,3&media=1,2,3&start_date=01-01-2021&end_date=12-07-2022&companies=1,2,3&sub_industries=1,2,3&categories=1,2,3&industries=1,2,3"
payload={}
headers = {
'Authorization': 'SECRET_API_KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
curl --location --request GET 'datasuite.megatime.cl/filters/products?brands=1,2,3&media=1,2,3&start_date=01-01-2021&end_date=12-07-2022&companies=1,2,3&sub_industries=1,2,3&categories=1,2,3&industries=1,2,3' \
--header 'Authorization: SECRET_API_KEY'
var request = require("request");
var options = {
method: "GET",
url: "datasuite.megatime.cl/filters/products?brands=1,2,3&media=1,2,3&start_date=01-01-2021&end_date=12-07-2022&companies=1,2,3&sub_industries=1,2,3&categories=1,2,3&industries=1,2,3",
headers: {
Authorization: "SECRET_API_KEY",
},
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"result": [
{
"ID": 1,
"name": "DEYCO,CONSERVAS",
"company_id": 70,
"brand_id": 6748,
"sub_industry_id": 10130
}
]
}
Retorna una lista con todos los Productos
Llamada HTTP
GET datasuite.megatime.cl/filters/products
Parámetros URL
| Nombre | Tipo | Descripción |
|---|---|---|
| start_date | String | Fecha de formato dd-mm-yyyy |
| end_date | String | Fecha de formato dd-mm-yyyy |
| industries | Array | Lista de ID de Rubros |
| media | Array | Lista de ID de Medios |
| sub_industries | Array | Lista de ID de Sub-Rubros |
| categories | Array | Lista de ID de Categorias |
| companies | Array | Lista de ID de Empresas |
| brands | Array | Lista de ID de Marcas |
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| result | Array | Lista de objetos tipo Producto |
Atributos Producto
| Nombre | Tipo | Descripción |
|---|---|---|
| ID | Integer | ID |
| name | String | Nombre |
| company_id | Integer | ID Empresa asociada |
| brand_id | Integer | ID Marca asociada |
| sub_industry_id | String | ID Sub-Rubro asociado |
Obtener Categorias
import requests
url = "datasuite.megatime.cl/filters/categories"
payload={}
headers = {
'Authorization': 'SECRET_API_KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
curl --location --request GET 'datasuite.megatime.cl/filters/categories' \
--header 'Authorization: SECRET_API_KEY'
var request = require("request");
var options = {
method: "GET",
url: "datasuite.megatime.cl/filters/categories",
headers: {
Authorization: "SECRET_API_KEY",
},
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"result": [
{
"ID": 1,
"name": "AGROPECUARIO"
}
]
}
Retorna una lista con todas las Categorias
Llamada HTTP
GET datasuite.megatime.cl/filters/categories
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| result | Array | Lista de objetos tipo Catergoria |
Atributos Categoria
| Nombre | Tipo | Descripción |
|---|---|---|
| ID | Integer | ID |
| name | String | Nombre |
Obtener Calidades
import requests
url = "datasuite.megatime.cl/filters/qualities"
payload={}
headers = {
'Authorization': 'SECRET_API_KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
curl --location --request GET 'datasuite.megatime.cl/filters/qualities' \
--header 'Authorization: SECRET_API_KEY'
var request = require("request");
var options = {
method: "GET",
url: "datasuite.megatime.cl/filters/qualities",
headers: {
Authorization: "SECRET_API_KEY",
},
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"result": [
{
"ID": 11,
"name": "VIDEO COLOR",
"short": "VC",
"media_id": 1
}
]
}
Retorna una lista con todas las Calidades
Llamada HTTP
GET datasuite.megatime.cl/filters/qualities
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| result | Array | Lista de objetos tipo Calidad |
Atributos Calidad
| Nombre | Tipo | Descripción |
|---|---|---|
| ID | Integer | ID |
| name | String | Nombre |
| short | String | Abreviación |
| medio_id | String | ID Medio |
Obtener Agencias Creativas
import requests
url = "datasuite.megatime.cl/filters/creativeagencies"
payload={}
headers = {
'Authorization': 'SECRET_API_KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
curl --location --request GET 'datasuite.megatime.cl/filters/creativeagencies' \
--header 'Authorization: SECRET_API_KEY'
var request = require("request");
var options = {
method: "GET",
url: "datasuite.megatime.cl/filters/creativeagencies",
headers: {
Authorization: "SECRET_API_KEY",
},
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"result": [
{
"ID": 1,
"name": "BBDO",
"short": "BBDO"
}
]
}
Retorna una lista con todas las Agencias Creativas
Llamada HTTP
GET datasuite.megatime.cl/filters/creativeagencies
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| result | Array | Lista de objetos tipo Agencia Creativa |
Atributos Agencias Creativa
| Nombre | Tipo | Descripción |
|---|---|---|
| ID | Integer | ID |
| name | String | Nombre |
| short | String | Abreviación |
Obtener Agencias de Medios
import requests
url = "datasuite.megatime.cl/filters/mediaagencies"
payload={}
headers = {
'Authorization': 'SECRET_API_KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
curl --location --request GET 'datasuite.megatime.cl/filters/mediaagencies' \
--header 'Authorization: SECRET_API_KEY'
var request = require("request");
var options = {
method: "GET",
url: "datasuite.megatime.cl/filters/mediaagencies",
headers: {
Authorization: "SECRET_API_KEY",
},
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"result": [
{
"ID": 1,
"name": "BBDO",
"short": "BBDO"
}
]
}
Retorna una lista con todas las Agencias de Medios
Llamada HTTP
GET datasuite.megatime.cl/filters/mediaagencies
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| result | Array | Lista de objetos tipo Agencia de Medios |
Atributos Agencias de Medios
| Nombre | Tipo | Descripción |
|---|---|---|
| ID | Integer | ID |
| name | String | Nombre |
| short | String | Abreviación |
Obtener Soportes
import requests
url = "datasuite.megatime.cl/filters/supports"
payload={}
headers = {
'Authorization': 'SECRET_API_KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
curl --location --request GET 'datasuite.megatime.cl/filters/supports' \
--header 'Authorization: SECRET_API_KEY'
var request = require("request");
var options = {
method: "GET",
url: "datasuite.megatime.cl/filters/supports",
headers: {
Authorization: "SECRET_API_KEY",
},
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"result": [
{
"ID": 1,
"name": "BBDO",
"short": "BBDO",
"media_id": 1
}
]
}
Retorna una lista con todas las Agencias de Medios
Llamada HTTP
GET datasuite.megatime.cl/filters/supports
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| result | Array | Lista de objetos tipo Soportes |
Atributos Agencias de Medios
| Nombre | Tipo | Descripción |
|---|---|---|
| ID | Integer | ID |
| name | String | Nombre |
| short | String | Abreviación |
| media_id | String | ID Medio |
Obtener Grupos personalizados
import requests
url = "datasuite.megatime.cl/filters/groups"
payload={}
headers = {
'Authorization': 'SECRET_API_KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
curl --location --request GET 'datasuite.megatime.cl/filters/groups' \
--header 'Authorization: SECRET_API_KEY'
var request = require("request");
var options = {
method: "GET",
url: "datasuite.megatime.cl/filters/groups",
headers: {
Authorization: "SECRET_API_KEY",
},
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"result": [
{
"ID": 3,
"name": "Bancos",
"obs": ""
}
]
}
Retorna una lista con todos los Grupos personalizados por el cliente
Llamada HTTP
GET datasuite.megatime.cl/filters/groups
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| result | Array | Lista de objetos tipo Grupo |
Atributos Grupo
| Nombre | Tipo | Descripción |
|---|---|---|
| ID | Integer | ID |
| name | String | Nombre |
| obs | String | Observación |
Crear Grupo personalizado
import requests
import json
url = "datasuite.megatime.cl/filters/groups"
payload = json.dumps({
"name": "Test nuevo grupo",
"obs": "Observacion",
"brands": [
24,
42
]
})
headers = {
'Authorization': 'SECRET_API_KEY',
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
curl --location --request POST 'datasuite.megatime.cl/filters/groups' \
--header 'Authorization: SECRET_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
"name": "Test New Group",
"obs": "Observacion",
"brands": [24,42]
}'
var request = require("request");
var options = {
method: "POST",
url: "datasuite.megatime.cl/filters/groups",
headers: {
Authorization: "SECRET_API_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({
name: "Test New Group",
obs: "Observacion",
brands: [24, 42],
}),
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"ID": 64,
"message": "Grupo creado correctamente"
}
Request para crear un nuevo Grupo Personalizado, responde con el ID del nuevo grupo.
Para asignar Clasificadores y Opciones, debe dirigirse a clasificador.megatime.cl
Llamada HTTP
POST datasuite.megatime.cl/filters/groups
Párametros Body
| Nombre | Tipo | Descripción | Requerido |
|---|---|---|---|
| name | String | Nombre de grupo | Si |
| obs | String | Observación | No |
| brands | Array | Lista de IDs de marcas para asignar al nuevo grupo | Si |
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| ID | Integer | ID grupo creado |
| message | String | Mensaje de estado |
Obtener Registro Cargas
import requests
url = "datasuite.megatime.cl/spots/loads?date=17-02-2022T16:41:10:240&media=1,6"
payload={}
headers = {
'Authorization': 'SECRET_API_KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
curl --location --request GET 'datasuite.megatime.cl/spots/loads?date=17-02-2022T16:41:10:240&media=1,6' \
--header 'Authorization: SECRET_API_KEY'
var request = require("request");
var options = {
method: "GET",
url: "datasuite.megatime.cl/spots/loads?date=17-02-2022T16:41:10:240&media=1,6",
headers: {
Authorization: "SECRET_API_KEY",
},
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"result": [
{
"media_id": 1,
"date": "17-03-2022",
"rows": 7345,
"upload_datetime": "18-03-2022T09:08:58:387"
},
{
"media_id": 6,
"date": "22-01-2021",
"rows": 21830,
"upload_datetime": "17-03-2022T22:22:58:750"
}
]
}
Retorna una lista de las últimas publicaciones de registros con fecha y medio
Llamada HTTP
GET datasuite.megatime.cl/spots/loads
Parámetros URL
| Nombre | Requerido | Descripción |
|---|---|---|
| date | No | Filtro de Fecha-Tiempo en formato dd-mm-yyyyThh:mi:ss:mmm. Permite mostrar sólo publicaciones de cargas mayores a la fecha ingresada |
| media | No | Lista de ID de Medios |
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| result | Array | Lista de objetos tipo Carga |
Atributos Carga
| Nombre | Tipo | Descripción |
|---|---|---|
| medio_id | Integer | ID del medio |
| date | String | Fecha del día publicado en formato dd-mm-yyyy |
| rows | Integer | Cantidad de registros en fecha - medio |
| upload_datetime | String | Fecha de publicación de la carga en formato dd-mm-yyyyThh:mi:ss:mmm |
Multimedia
Obtener API Key
iimport requests
import json
url = "cuenta.megatime.cl/api/auth/key"
payload = json.dumps({
"email": "user@example.com",
"password": "**********"
})
headers = {
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.json())
curl --location --request POST 'cuenta.megatime.cl/api/auth/key' \
--header 'Content-Type: application/json' \
--data-raw '{
"email": "user@example.com",
"password": "**********"
}'
var request = require("request");
var options = {
method: "POST",
url: "cuenta.megatime.cl/api/auth/key",
headers: {
"Content-Type": "application/json",
},
body: JSON.stringify({
email: "user@example.com",
password: "**********",
}),
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"key": "71e1db8n090am63ca69606c4slb8b6ta"
}
Retorna key que permite el acceso a la API.
Llamada HTTP
POST cuenta.megatime.cl/api/auth/key
Parámetros Body
| Nombre | Tipo | Descripción | Requerido |
|---|---|---|---|
| String | Correo asociado a credencial de Megatime | Sí | |
| password | String | Contraseña asociado a credencial de Megatime | Sí |
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| key | String | Llave de acceso a API |
La API espera que las llamadas estén autenticadas con la Api key en la url con el parámetro key
?key=SECRET_API_KEY
Obtener Multimedia
Retorna multimedia de un aviso.
Llamada HTTP
import requests
url = "multimedia.megatime.cl/file/spot/0xea3e07b0ef1e6e698af73db5ce37da8d?key=SECRET_API_KEY"
payload={}
headers = {}
response = requests.request("GET", url, headers=headers, data=payload)
print(response)
var request = require("request");
var options = {
method: "GET",
url: "multimedia.megatime.cl/file/spot/0xea3e07b0ef1e6e698af73db5ce37da8d?key=SECRET_API_KEY",
headers: {},
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
curl --location --request GET 'multimedia.megatime.cl/file/spot/0xea3e07b0ef1e6e698af73db5ce37da8d?key=SECRET_API_KEY'
Retorno de multimedia Video, Audio o Imagen
GET multimedia.megatime.cl/file/spot/{uuid}
La variable uuid corresponde al identificador único de cada avisaje.
Parámetros URL
| Nombre | Requerido | Valores | Descripción |
|---|---|---|---|
| thumbnail | No | true ó false (por defecto) |
Retorna thumbnail de multimedia |
Medios soportados
- TV Abierta
- TV Paga
- Prensa
- Revista
- Radio
- Vía Pública
- Metro
Clasificador
Obtener API Key
iimport requests
import json
url = "cuenta.megatime.cl/api/auth/key"
payload = json.dumps({
"email": "user@example.com",
"password": "**********"
})
headers = {
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.json())
curl --location --request POST 'cuenta.megatime.cl/api/auth/key' \
--header 'Content-Type: application/json' \
--data-raw '{
"email": "user@example.com",
"password": "**********"
}'
var request = require("request");
var options = {
method: "POST",
url: "cuenta.megatime.cl/api/auth/key",
headers: {
"Content-Type": "application/json",
},
body: JSON.stringify({
email: "user@example.com",
password: "**********",
}),
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"key": "71e1db8n090am63ca69606c4slb8b6ta"
}
Retorna key que permite el acceso a la API.
Llamada HTTP
POST cuenta.megatime.cl/api/auth/key
Parámetros Body
| Nombre | Tipo | Descripción | Requerido |
|---|---|---|---|
| String | Correo asociado a credencial de Megatime | Sí | |
| password | String | Contraseña asociado a credencial de Megatime | Sí |
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| key | String | Llave de acceso a API |
La API espera que todas las llamadas estén autenticadas con la Api key en el Authorization header:
Authorization: SECRET_API_KEY
Obtener Grupos
import requests
url = "clasificador.megatime.cl/api/groups"
payload={}
headers = {
'Authorization': 'SECRET_API_KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.json())
curl --location --request GET 'clasificador.megatime.cl/api/groups' \
--header 'Authorization: SECRET_API_KEY'
var request = require("request");
var options = {
method: "GET",
url: "clasificador.megatime.cl/api/groups",
headers: {
Authorization: "SECRET_API_KEY",
},
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"data": [
{
"ID": 3,
"name": "Bancos",
"obs": "Los bancos para cliente ...",
"brands": [
{
"ID": 2392,
"name": "BANCO DE CHILE"
},
{
"ID": 2432,
"name": "SANTANDER"
},
{
"ID": 2608,
"name": "BCI"
}
],
"classifiers": [
{
"ID": 2,
"name": "Productos"
},
{
"ID": 17,
"name": "Seguros"
}
]
},
{
"ID": 8,
"name": "Automóviles de lujo",
"obs": "Incluye marcas de ...",
"brands": [
{
"ID": 2985,
"name": "BMW"
},
{
"ID": 9130,
"name": "FERRARI"
},
{
"ID": 83348,
"name": "MASERATI"
}
],
"classifiers": [
{
"ID": 18,
"name": "Rubro"
},
{
"ID": 19,
"name": "Marcas"
}
]
}
]
}
Retorna todos los grupos.
Llamada HTTP
GET clasificador.megatime.cl/api/groups
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| data | Array | Lista de objetos de tipo Grupo |
Atributos Grupo
| Nombre | Tipo | Descripción |
|---|---|---|
| ID | Integer | Identificador del grupo |
| name | String | Nombre del grupo |
| obs | String | Observacion del grupo |
| brands | Array | Lista de objetos de tipo Marca asociados al grupo |
| classifiers | Array | Lista de objetos de tipo Clasificador asociados al grupo |
Atributos Marca
| Nombre | Tipo | Descripción |
|---|---|---|
| ID | Integer | Identificador de la marca |
| name | String | Nombre de la marca |
Atributos Clasificador
| Nombre | Tipo | Descripción |
|---|---|---|
| ID | Integer | Identificador del clasificador |
| name | String | Nombre del clasificador |
Obtener Clasificadores
import requests
url = "clasificador.megatime.cl/api/classifiers"
payload={}
headers = {
'Authorization': 'SECRET_API_KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.json())
curl --location --request GET 'clasificador.megatime.cl/api/classifiers' \
--header 'Authorization: SECRET_API_KEY'
var request = require("request");
var options = {
method: "GET",
url: "clasificador.megatime.cl/api/classifiers",
headers: {
Authorization: "SECRET_API_KEY",
},
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"data": [
{
"ID": 2,
"name": "Productos",
"obs": "Carnes, papel, etc.",
"multipleSelection": true,
"options": [
{
"ID": 12,
"name": "Arroz"
},
{
"ID": 15,
"name": "Café"
},
{
"ID": 6,
"name": "Carnes"
},
{
"ID": 7,
"name": "Papel"
}
]
},
{
"ID": 4,
"name": "Forma de pago",
"obs": "Tarjetas, transferencias, puntos, etc.",
"multipleSelection": true,
"options": [
{
"ID": 19,
"name": "Efectivo"
},
{
"ID": 11,
"name": "Pago App"
}
{
"ID": 9,
"name": "Tarjetas credito"
}
]
}
]
}
Retorna todos los clasificadores.
Llamada HTTP
GET clasificador.megatime.cl/api/classifiers
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| data | Array | Lista de objetos de tipo Clasificador |
Atributos Clasificador
| Nombre | Tipo | Descripción |
|---|---|---|
| ID | Integer | Identificador del clasificador |
| name | String | Nombre del clasificador |
| obs | String | Observación del clasificador |
| multipleSelection | Boolean | Es un clasificador que permite múltiples opciones seleccionadas |
| options | Array | Lista de objetos de tipo Opción asociadas al clasificador |
Atributos Opción
| Nombre | Tipo | Descripción |
|---|---|---|
| ID | Integer | Identificador de la opción |
| name | String | Nombre de la opción |
Obtener Avisos por Grupo
import requests
url = "clasificador.megatime.cl/api/ads/group/10?start_date=13-09-2021&end_date=13-10-2021"
payload={}
headers = {
'Authorization': 'SECRET_API_KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.json())
curl --location --request GET 'clasificador.megatime.cl/api/ads/group/10?start_date=13-09-2021&end_date=13-10-2021' \
--header 'Authorization: SECRET_API_KEY'
var request = require("request");
var options = {
method: "GET",
url: "clasificador.megatime.cl/api/ads/group/10?start_date=13-09-2021&end_date=13-10-2021",
headers: {
Authorization: "SECRET_API_KEY",
},
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"group": "Supermercados",
"start_date": "13-09-2021",
"end_date": "13-10-2021",
"data": [
{
"ID": 270366,
"description": "TOTTUS,PRECIAZOS,SON PRECIOS BAJOS TODOS LOS DIAS POR TODO",
"media": "Radio",
"appeared_date": "19/04/2021",
"industry": "SUPER E HIPERMERCADOS",
"company": "TOTTUS",
"brand": "TOTTUS",
"product": "TOTTUS,PRECIAZOS",
"status": "COMPLETADO",
"options": [
{
"classifier": {
"ID": 4,
"name": "Forma de pago"
},
"values": [
{
"ID": 58,
"name": "Tarjeta de Tienda"
}
]
},
{
"classifier": {
"ID": 21,
"name": "Marcas Supermercados"
},
"values": [
{
"ID": 51,
"name": "Cristal"
},
{
"ID": 52,
"name": "Colun"
}
]
},
{
"classifier": {
"ID": 2,
"name": "Productos"
},
"values": [
{
"ID": 18,
"name": "Alcoholes"
}
]
}
]
},
{
"ID": 585673,
"description": "JUMBO,FELIZ 18,SOBRECOSTILLA-HUACHALOMO $5890-TJ",
"media": "TV Abierta",
"appeared_date": "13/09/2021",
"industry": "SUPER E HIPERMERCADOS",
"company": "JUMBO",
"brand": "JUMBO",
"product": "JUMBO,FELIZ 18",
"status": "PENDIENTE",
"options": [
{
"classifier": {
"ID": 4,
"name": "Forma de pago"
},
"values": []
},
{
"classifier": {
"ID": 21,
"name": "Marcas Supermercados"
},
"values": []
},
{
"classifier": {
"ID": 2,
"name": "Productos"
},
"values": []
}
]
}
]
}
Retorna todos los avisos con sus datos y opciones que tuvieron alguna actividad en cierto periodo en base al Grupo seleccionado.
Llamada HTTP
GET clasificador.megatime.cl/api/ads/group/{groupID}
La variable groupID corresponde al ID del Grupo clasificador el cual contiene los filtros de marcas y clasificadores.
Parámetros URL
| Nombre | Requerido | Descripción |
|---|---|---|
| start_date | Sí | Fecha inicial de la búsqueda en formato dd-mm-yyyy |
| end_date | Sí | Fecha final de la búsqueda en formato dd-mm-yyyy |
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| group | String | Nombre del grupo seleccionado |
| start_date | Date | Fecha inicial de la búsqueda en formato dd-mm-yyyy |
| end_date | Date | Fecha final de la búsqueda en formato dd-mm-yyyy |
| data | String | Lista de objetos de tipo Aviso |
Atributos Aviso por Grupo
| Nombre | Tipo | Descripción |
|---|---|---|
| ID | Integer | Identificador del aviso |
| description | String | Descripción del aviso |
| media | String | Nombre de los medios en donde aparece el aviso |
| appeared_date | Date | Fecha donde aparece el aviso por primera vez |
| industry | String | Nombre del Rubro asignado al aviso |
| company | String | Nombre de la Empresa asignada al aviso |
| brand | String | Nombre de la Marca asignada al aviso |
| product | String | Nombre del Producto asignado al aviso |
| status | String | Estado del aviso según el grupo elegido |
| options | Array | Lista de objetos de tipo Opción-Clasificador que muestra opciones asignadas al aviso según cada clasificador del grupo seleccionado |
Atributos Opción-Clasificador
| Nombre | Tipo | Descripción |
|---|---|---|
| classifier | Objeto | Objeto que representa clasificador del grupo con ID y name |
| values | Array | Listado de objetos de tipo Opción que representa las opciones asginadas al aviso |
Atributos Opción
| Nombre | Tipo | Descripción |
|---|---|---|
| ID | Integer | Identificador de la opción |
| name | String | Nombre de la opción |
Estados del Aviso
| Nombre | Descripción |
|---|---|
| Pendiente | No tiene asginada ninguna opción |
| Incompleto | Tiene asignada algunas opciones |
| Completado | Tiene asginada todas las opciones |
| No Aplica | Todas sus opciones son 'No Aplica' |
Radio Regional
Obtener API Key Usuario
import requests
import json
url = "https://cuenta.megatime.cl/api/auth/key"
payload = json.dumps({
"email": "user@example.com",
"password": "**********"
})
headers = {
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.json())
curl --location --request POST 'https://cuenta.megatime.cl/api/auth/key' \
--header 'Content-Type: application/json' \
--data-raw '{
"email": "user@example.com",
"password": "**********"
}'
var request = require("request");
var options = {
method: "POST",
url: "https://cuenta.megatime.cl/api/auth/key",
headers: {
"Content-Type": "application/json",
},
body: JSON.stringify({
email: "user@example.com",
password: "**********",
}),
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"key": "71e1db8n090am63ca69606c4slb8b6ta"
}
Retorna key del usuario, para tener acceso a las consultas de radios regionales.
Llamada HTTP
POST https://cuenta.megatime.cl/api/auth/key
Parámetros Body
| Nombre | Tipo | Descripción | Requerido |
|---|---|---|---|
| String | Correo asociado a credencial de Megatime | Sí | |
| password | String | Contraseña asociada a credencial de Megatime | Sí |
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| key | String | Llave de acceso a API |
La API espera que todas las llamadas estén autenticadas con la Api key en el Authorization header:
Authorization: SECRET_API_KEY
Crear Campaña
import requests
import json
url = "radioregional.megatime.cl/api/campaign"
payload = json.dumps({
"name": "ExampleCampaña",
"company": "Example Empresa",
"media_agency": "Example Ag medio",
"creative_agency": "Example Ag creativa",
"start_date": "18-01-2022",
"end_date": "20-01-2022"
})
headers = {
'Authorization': 'SECRET_API_KEY',
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
curl --location --request POST 'radioregional.megatime.cl/api/campaign' \
--header 'Authorization: SECRET_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
"name": "ExampleCampaña",
"company": "Example Empresa",
"media_agency": "Example Ag medio",
"creative_agency": "Example Ag creativa",
"start_date": "18-01-2022",
"end_date": "20-01-2022"
}'
var request = require("request");
var options = {
method: "POST",
url: "radioregional.megatime.cl/api/campaign",
headers: {
Authorization: "SECRET_API_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({
name: "ExampleCampaña",
company: "Example Empresa",
media_agency: "Example Ag medio",
creative_agency: "Example Ag creativa",
start_date: "18-01-2022",
end_date: "20-01-2022",
}),
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"campaign_id": 3334,
"message": "Campaña ingresada correctamente."
}
Crea una nueva campaña.
Llamada HTTP
POST https://radioregional.megatime.cl/api/campaign
Parametros Body
| Nombre | Tipo | Descripción | Requerido |
|---|---|---|---|
| name | String | Nombre de la campaña a crear | Si |
| company | String | Nombre de la empresa | Si |
| media_agency | String | Nombre de la agencia de medios | Si |
| creative_agency | String | Nombre de la agencia creativa | Si |
| start_date | String | Fecha de inicio en formato dd-mm-yyyy | No |
| end_date | String | Fecha de termino en formato dd-mm-yyyy | No |
| external_id | Integer | Identifiador opcional, para seguimiento interno del cliente | No |
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| campaign_id | Integer | Identificador de la nueva campaña generada |
| message | String | Mensaje de estado |
La API espera que todas las llamadas estén autenticadas con la Api key en el Authorization header:
Authorization: SECRET_API_KEY
Editar Campaña
import requests
import json
url = "radioregional.megatime.cl/api/campaign/3333"
payload = json.dumps({
"name": "Example Name",
"company":"Example Name",
"media_agency":"Example Name",
"creative_agency":"Example Name",
"start_date": "18-01-2022",
"end_date": "20-01-2022"
})
headers = {
'Authorization': 'SECRET_API_KEY',
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
curl --location --request POST 'radioregional.megatime.cl/api/campaign/3333' \
--header 'Authorization: SECRET_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
"name": "Example Name",
"company":"Example Name",
"media_agency":"Example Name",
"creative_agency":"Example Name",
"start_date": "18-01-2022",
"end_date": "20-01-2022"
}'
var request = require("request");
var options = {
method: "POST",
url: "radioregional.megatime.cl/api/campaign/3333",
headers: {
Authorization: "SECRET_API_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({
name: "Example Name",
company: "Example Name",
media_agency: "Example Name",
creative_agency: "Example Name",
start_date: "18-01-2022",
end_date: "20-01-2022",
}),
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"campaign_id": 9987,
"message": "Cambios guardados correctamente."
}
Edita una campaña.
Llamada HTTP
POST https://radioregional.megatime.cl/api/campaign/{campaign_id}
Parametros URL
| Nombre | Tipo | Descripción | Requerido |
|---|---|---|---|
| campaign_id | Integer | Identificador de campaña | Si |
Parametros Body
| Nombre | Tipo | Descripción | Requerido |
|---|---|---|---|
| name | String | Nombre del plan a crear | Si |
| company | String | Nombre de la empresa asociada | Si |
| external_id | Integer | Identificador interno para seguimiento del cliente | Si |
| media_agency | String | Nombre de la agencia de medios | Si |
| creative_agency | String | Nombre de la agencia creativa | Si |
| start_date | String | Fecha de inicio en formato dd-mm-yyyy | Si |
| end_date | String | Fecha de termino en formato dd-mm-yyyy | Si |
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| campaign_id | Integer | Identificador de la nueva campaña generada |
| message | String | Mensaje de estado |
La API espera que todas las llamadas estén autenticadas con la Api key en el Authorization header:
Authorization: SECRET_API_KEY
Obtener resumen de Campaña
import requests
url = "radioregional.megatime.cl/api/campaign/3554"
payload={}
headers = {
'Authorization': 'SECRET_API_KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
curl --location --request GET 'radioregional.megatime.cl/api/campagin/3554' \
--header 'Authorization: SECRET_API_KEY'
var request = require("request");
var options = {
method: "GET",
url: "radioregional.megatime.cl/api/campaign/3554",
headers: {
Authorization: "SECRET_API_KEY",
},
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"id": 3554,
"external_id": 0,
"name": "Example ",
"company": "Example",
"media_agency": "GROUPM (MEDIA)",
"creative_agency": "DIRECTOS",
"start_date": "03-01-2022",
"end_date": "31-01-2022",
"radios": [
{
"radio_id": 3453,
"name": "VALPARAISO",
"dates": [
{
"day": "20220103",
"quantity": 3,
"completed": 0,
"quantity_found": 0
},
{
"day": "20220104",
"quantity": 3,
"completed": 0,
"quantity_found": 0
}
]
}
],
"audios": [
{
"index": 0,
"id": 3126,
"name": "example_name.mp3",
"source": "https://radioregional.megatime.cl/api/audios/3126",
"createAt": "04-01-2022 17:50"
},
{
"index": 1,
"id": 3127,
"name": "example_name.mp3",
"source": "https://radioregional.megatime.cl/api/audios/3127",
"createAt": "04-01-2022 17:50"
}
],
"ok": true
}
Retorna el resumen de una campaña, mostrando asi la verificacion para cada radio segun pauta esperada. Incluye informacion de sus audios inyectados.
Llamada HTTP
GET https://radioregional.megatime.cl/api/campaign/{campaign_ID}
Parametros URL
| Nombre | Tipo | Descripción | Requerido |
|---|---|---|---|
| campaign_id | Integer | Identificador de campaña | Si |
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| id | Integer | Identificador de la campaña |
| external_id | Integer | Identificador externo creado por el usuario |
| name | String | Nombre de la campaña |
| company | String | Nombre de la empresa |
| media_agency | String | Nombre de la agencia de medios |
| creative_agency | String | Nombre de la agencia creativa |
| start_date | String | Fecha de inicio de la campaña en formato dd-mm-yyyy |
| end_date | String | Fecha de termino de la campaña en formato dd-mm-yyyy |
| radios | Array | Lista de objetos de tipo radios |
| audios | Array | Lista de objetos de tipo audios |
| ok | Boolean | Verificador de respuesta |
Atributos Radios
| Nombre | Tipo | Descripción |
|---|---|---|
| radio_id | Integer | Identificador de la radio |
| name | String | Nombre de la radio |
| dates | Array | Lista de objetos de tipo dates |
Atributos Dates
| Nombre | Tipo | Descripción |
|---|---|---|
| day | String | Fecha en la que se contabilizo los avisajes en formato YYYYMMDD |
| quantity | Integer | Cantidad de avisajes esperados en esa fecha |
| completed | Integer | Verificador de avisajes, si es "1" fue completado en su totalidad, si es "0" no fue completado |
| quantity_found | Integer | Cantidad de avisajes detectados |
Atributos Audios
| Nombre | Tipo | Descripción |
|---|---|---|
| index | Integer | Identificador del audio dentro de la campaña |
| id | Integer | Identificador del audio |
| name | String | Nombre original del audio |
| source | String | Link para acceso al audio |
| createAt | String | Fecha en la que se subió el audio en formato YYYY-MM-DD HH-MM-DD |
La API espera que todas las llamadas estén autenticadas con la Api key en el Authorization header:
Authorization: SECRET_API_KEY
Obtener Campañas
import requests
url = "radioregional.megatime.cl/api/campaign/search/?start_date=12-11-2021&end_date=12-01-2022"
payload={}
headers = {
'Authorization': 'SECRET_API_KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
curl --location --request GET 'radioregional.megatime.cl/api/campaign/search/?start_date=12-11-2021&end_date=12-01-2022' \
--header 'Authorization: SECRET_API_KEY'
var request = require("request");
var options = {
method: "GET",
url: "radioregional.megatime.cl/api/campaign/search/?start_date=12-11-2021&end_date=12-01-2022",
headers: {
Authorization: "SECRET_API_KEY",
},
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"campaigns": [
{
"campaign_id": 4456,
"campaign": "BANCO ESTADO CUENTA RUT MIGRACION ENERO",
"company": "BANCO ESTADO",
"media_agency": "GROUPM (MEDIA)",
"creative_agency": "DIRECTOS",
"creation_date": "2022-01-19 13:00:26",
"start_date": "19-01-2022",
"end_date": "31-01-2022",
"external_id": 0,
"audios": [
{
"audio_id": 7556,
"audio": "example_name.mp3",
"campaign_id": 9668,
}
]
},
{
"campaign_id": 4457,
"campaign": "BANCO CHILE DRONES",
"company": "BANCO CHILE",
"media_agency": "OMG",
"creative_agency": "DIRECTOS",
"creation_date": "2022-01-19 12:58:07",
"start_date": "17-01-2022",
"end_date": "22-01-2022",
"external_id": 0,
"audios": [
{
"audio_id": 77476,
"audio": "example_name.mp3",
"campaign_id": 5567,
}
]
}
}
Retorna una lista de campañas en base a un rango de fecha.
Llamada HTTP
GET https://radioregional.megatime.cl/api/campaign/search?start_date={dd-mm-yyyy}&end_date={DD-MM- YYYY}
Parametros URL
| Nombre | Tipo | Descripción | Requerido |
|---|---|---|---|
| start_date | String | Fecha de inicio de la campaña en formato dd-mm-yyyy | Si |
| end_date | String | Fecha de termino de la campaña en formato dd-mm-yyyy | Si |
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Integer | Verificador de respuesta |
| campaigns | Array | Lista de objetos de tipo campaigns |
Atributos Campaigns
| Nombre | Tipo | Descripción |
|---|---|---|
| campaign_id | Integer | Identificador de la campaña |
| external_id | Integer | Identificador externo de la campaña |
| campaign | String | Nombre de la campaña |
| company | String | Nombre de la empresa |
| media_agency | String | Nombre de la agencias de medios |
| creative_agency | String | Nombre de la agencia creativa |
| start_date | String | Fecha de inicio de la campaña en formato dd-mm-yyyy |
| end_date | String | Fecha de termino de la campaña en formato dd-mm-yyyy |
| external_id | Integer | Identificador externo |
| audios | Array | Lista de objetos de tipo audios |
Atributos Audios
| Nombre | Tipo | Descripción |
|---|---|---|
| audio_id | Integer | Identificador del audio |
| audio | String | Nombre del audio |
| campaign_id | Integer | Identificador de la campaña |
La API espera que todas las llamadas estén autenticadas con la Api key en el Authorization header:
Authorization: SECRET_API_KEY
Inyectar audio a una Campaña
import requests
url = "https://radioregional.megatime.cl/api/campaign/upload/audio/3333"
payload={}
files=[
('audio',('file_example_MP3_700KB.mp3',open('/{path_audio}/file_example_MP3_700KB.mp3','rb'),'audio/mpeg'))
]
headers = {
'Authorization': '62cc57e4e86381c3c25433338882673'
}
response = requests.request("POST", url, headers=headers, data=payload, files=files)
print(response.text)
curl --location --request POST 'https://radioregional.megatime.cl/api/campaign/upload/audio/3333' \
--header 'Authorization: SECRET_API_KEY' \
--form 'audio=@"/{path_audio}/file_example_MP3_700KB.mp3"'
var request = require("request");
var fs = require("fs");
var options = {
method: "POST",
url: "https://radioregional.megatime.cl/api/campaign/upload/audio/33333",
headers: {
Authorization: "SECRET_API_KEY",
},
formData: {
audio: {
value: fs.createReadStream("/{path_audio}/file_example_MP3_700KB.mp3"),
options: {
filename: "file_example_MP3_700KB.mp3",
contentType: null,
},
},
},
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"campaign_id": 3333,
"message": "Cambios guardados correctamente."
}
Subir audio a una campaña.
Llamada HTTP
POST https://radioregional.megatime.cl/api/campaign/upload/audio/{campaign_id}
Parametros URL
| Nombre | Tipo | Descripción |
|---|---|---|
| campaign_id | Integer | Identificador de la campaña |
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| campaign_id | Integer | Identificador de la nueva campaña generada |
| message | String | Mensaje de estado |
La API espera que todas las llamadas estén autenticadas con la Api key en el Authorization header:
Authorization: SECRET_API_KEY
Inyectar Pauta a Campaña
import requests
import json
url = "radioregional.megatime.cl/api/campaign/{campaign_id}/details"
payload = json.dumps({
"details": [
{
"radio_id": 6446,
"dates": [
{
"day": "18-01-2022",
"quantity": 3
},
{
"day": "19-01-2022",
"quantity": 4
},
{
"day": "20-01-2022",
"quantity": 5
}
]
},
{
"radio_id": 9644,
"dates": [
{
"day": "18-01-2022",
"quantity": 3
},
{
"day": "19-01-2022",
"quantity": 4
},
{
"day": "20-01-2022",
"quantity": 5
}
]
}
]
})
headers = {
'Authorization': '62cc57e4e86381c3c254a2b4b6464545',
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
curl --location --request POST 'radioregional.megatime.cl/api/campaign/{campaign_id}/details' \
--header 'Authorization: 62cc57e4e86381c3c254a2b4b8882673' \
--header 'Content-Type: application/json' \
--data-raw '{
"details": [
{
"radio_id": 9449,
"dates": [
{
"day": "18-01-2022",
"quantity": 3
},
{
"day": "19-01-2022",
"quantity": 4
},
{
"day": "20-01-2022",
"quantity": 5
}
]
},
{
"radio_id": 9445,
"dates": [
{
"day": "18-01-2022",
"quantity": 3
},
{
"day": "19-01-2022",
"quantity": 4
},
{
"day": "20-01-2022",
"quantity": 5
}
]
}]
}'
var request = require("request");
var options = {
method: "POST",
url: "radioregional.megatime.cl/api/campaign/{campaign_id}/details",
headers: {
Authorization: "62cc57e4e86381c3c254a2b4b",
"Content-Type": "application/json",
},
body: JSON.stringify({
details: [
{
radio_id: 7208,
dates: [
{
day: "18-01-2022",
quantity: 3,
},
{
day: "19-01-2022",
quantity: 4,
},
{
day: "20-01-2022",
quantity: 5,
},
],
},
{
radio_id: 4434,
dates: [
{
day: "18-01-2022",
quantity: 3,
},
{
day: "19-01-2022",
quantity: 4,
},
{
day: "20-01-2022",
quantity: 5,
},
],
},
],
}),
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"message": "Pautas ingresadas correctamente"
}
Inyecta pauta a una campaña creada previamente.
Llamada HTTP
POST https://radioregional.megatime.cl/api/campaign/{campaign_id}/details
Parametros URL
| Nombre | Tipo | Descripcion |
|---|---|---|
| campaign_id | Integer | Identificador de la campaña |
Parametros Body
| Nombre | Tipo | Descripción |
|---|---|---|
| details | Array | Lista de objetos de tipo details |
Atributos Details
| Nombre | Tipo | Descripción |
|---|---|---|
| radio_id | Integer | Identificador de la radio |
| dates | Array | Lista de objetos de tipo dates |
Atributos Dates
| Nombre | Tipo | Descripción |
|---|---|---|
| day | String | Fecha en la que se contabilizo los avisajes en formato YYYYMMDD |
| quantity | Integer | Cantidad de avisajes esperados en esa fecha |
La API espera que todas las llamadas estén autenticadas con la Api key en el Authorization header:
Authorization: SECRET_API_KEY
Obtener Avisajes
import requests
url = "https://radioregional.megatime.cl/api/spots?start_date=30-09-2021&end_date=27-12-2021&campaign_id={campaign_id}"
payload={}
headers = {
'Authorization': 'SECRET_API_KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
curl --location --request GET 'https://radioregional.megatime.cl/api/spots?start_date=30-09-2021&end_date=27-12-2021&campaign_id={campaign_id}' \
--header 'Authorization: SECRET_API_KEY'
var request = require("request");
var options = {
method: "GET",
url: "https://radioregional.megatime.cl/api/spots?start_date=30-09-2021&end_date=27-12-2021&campaign_id={campaign_id}",
headers: {
Authorization: "SECRET_API_KEY",
},
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"start_date": "30-11-2021",
"end_date": "27-12-2021",
"spots": [
{
"ID": 111111,
"audio_id": 1111,
"audio": "example.mp3",
"date": "19-02-2022",
"hour": 29,
"minute": 57,
"second": 17,
"duration": 30,
"radio_id": 7062,
"radio": "MADEROANTOFAGASTA",
"company": "HUGHESNET",
"company_id": 73004,
"product": "HUGHESNET,INTERNET SATELITAL",
"advertisement": "HUGHESNET,INTERNET SATELITAL,CON HUGHESNET DONDE VEAS EL CIE",
"product_id": 306312,
"category": "INTERNET",
"category_id": 29,
"brand": "HUGHESNET",
"brand_id": 120705,
"industry": "PROVEEDORES",
"industry_id": 404,
"sub_industry": "PROVEEDOR DE ACCESO",
"sub_industry_id": 6313,
"campaign_id": 2118
},
{
"ID": 11111,
"audio_id": 1111,
"audio": "example.mp3",
"date": "19-02-2022",
"hour": 23,
"minute": 1,
"second": 37,
"duration": 24,
"radio_id": 7160,
"radio": "MADEROANTOFAGASTA",
"company": "MOVISTAR",
"company_id": 1870,
"product": "MOVISTAR,EMPRESAS,FIBRA",
"advertisement": "MOVISTAR,EMPRESAS,PLAN FIBRA 600 MEGAS SIMETRICO POR SOLO",
"product_id": 320249,
"category": "SERVICIOS AL CONSUMIDOR",
"category_id": 29,
"brand": "MOVISTAR",
"brand_id": 81824,
"industry": "TELEFONIA",
"industry_id": 405,
"sub_industry": "SERVICIO DE TELEFONIA MOVIL",
"sub_industry_id": 6271,
"campaign_id": 2238
}
]
}
Obtener los avisajes de una campaña en especifico, o de todos las campañas de un cliente en un rango de tiempo especifico.
Llamada HTTP
GET https://radioregional.megatime.cl/api/spots?start_date={dd-mm-yyyy}&end_date={dd-mm-yyyy}&campaign_id={campaign_id}
Parametros URL
| Nombre | Tipo | Descripción | Requerido |
|---|---|---|---|
| start_date | String | Fecha de inicio en formato dd-mm-yyyy | Si |
| end_date | String | Fecha de termino en formato dd-mm-yyyy | Si |
| campaign_id | Integer | Identificador de la campaña | No |
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| start_date | String | Fecha de inicio en formato dd-mm-yyyy |
| end_date | String | Fecha de inicio en formato dd-mm-yyyy |
| spots | Array | Lista de objetos de tipo spots |
Atributos Spots
| Nombre | Tipo | Descripción |
|---|---|---|
| id | Integer | Identificador de la campaña |
| audio_id | Integer | Identificador del audio |
| date | String | Fecha del avisaje en formato dd-mm-yyyy |
| hour | Integer | Hora del avisaje en formato 24Horas |
| minute | Integer | Minuto del avisaje |
| second | Integer | Segundo del avisaje |
| duration | Integer | Duracion del avisaje en segundos |
| radio_id | Integer | Identificador de la radio |
| radio | String | Nombre de la radio |
| company | String | Nombre de la empresa |
| company_id | Integer | Identificador de la empresa |
| product | String | Nombre del producto |
| advertisement | String | Descripcion del producto |
| product_id | Integer | Identificador del producto |
| category | String | Nombre de la categoria |
| category_id | Integer | Identificador de la categoria |
| brand | String | Nombre de la marca |
| brand_id | Integer | Identificador de la marca |
| industry | String | Nombre del rubro |
| industry_id | Integer | Identificador del rubro |
| sub_industry | String | Nombre del sub-rubro |
| sub_industry_id | Integer | Identificador del sub-rubro |
| campaign_id | Integer | Identificador de la campaña |
La API espera que todas las llamadas estén autenticadas con la Api key en el Authorization header:
Authorization: SECRET_API_KEY
Obtener URL audio testigo
import requests
url = "https://radioregional.megatime.cl/api/audios/witness/3345"
payload={}
headers = {
'Authorization': 'SECRET_API_KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
curl --location --request GET 'https://radioregional.megatime.cl/api/audios/witness/3345' \
--header 'Authorization: SECRET_API_KEY'
var request = require('request');
var options = {
'method': 'GET',
'url': 'https://radioregional.megatime.cl/api/audios/witness/3345',
'headers': {
'Authorization': 'SECRET_API_KEY'
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"audio_url": "https://s3.amazonaws.com/radioregional.megatime.cl/testigos/20220314/045/20220314152447_045_277620.mp3"
}
Obtener el url de un audio testigo.
Llamada HTTP
GET https://radioregional.megatime.cl/api/audios/witness/{spot_id}
Parametros URL
| Nombre | Tipo | Descripción |
|---|---|---|
| spot_id | Integer | Identificador del avisaje |
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| audio_url | String | URL de audio inyectado |
La API espera que todas las llamadas estén autenticadas con la Api key en el Authorization header:
Authorization: SECRET_API_KEY
Obtener URL audio inyectado
import requests
url = "https://radioregional.megatime.cl/api/audios/file/3345"
payload={}
headers = {
'Authorization': 'SECRET_API_KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
curl --location --request GET 'https://radioregional.megatime.cl/api/audios/file/3345' \
--header 'Authorization: SECRET_API_KEY'
var request = require("request");
var options = {
method: "GET",
url: "https://radioregional.megatime.cl/api/audios/file/3345",
headers: {
Authorization: "SECRET_API_KEY",
},
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"audio_url": "https://s3.amazonaws.com/radioregional.megatime.cl/user-audios/audio_1111.mp3"
}
Obtener un audio inyectado según su ID.
Llamada HTTP
GET https://radioregional.megatime.cl/api/audios/file/{audio_id}
Parametros URL
| Nombre | Tipo | Descripción |
|---|---|---|
| audio_id | Integer | Identificador del audio |
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| audio_url | String | URL de audio inyectado |
La API espera que todas las llamadas estén autenticadas con la Api key en el Authorization header:
Authorization: SECRET_API_KEY
Obtener Agen. Creativas (RR)
import requests
import json
url = "radioregional.megatime.cl/api/finder/creative_agencies"
payload = json.dumps({
"name": "example"
})
headers = {
'Authorization': 'SECRET_API_KEY',
'Content-Type': 'application/json'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
curl --location --request GET 'radioregional.megatime.cl/api/finder/creative_agencies' \
--header 'Authorization: SECRET_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
"name":"example"
}'
var request = require("request");
var options = {
method: "GET",
url: "radioregional.megatime.cl/api/finder/creative_agencies",
headers: {
Authorization: "SECRET_API_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({
name: "example",
}),
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"agencies": [
{
"id": 345,
"name": "SUTIL NAZCA SAATCHI Y SAATCHI"
},
{
"id": 879,
"name": "XYZ JAAPOH PUBLICIDAD"
}
]
}
Retorna las agencias creativas y su respectivo id. Se puede adjuntar una 'frase' para filtrar los resultados.
Llamada HTTP
GET https://radioregional.megatime.cl/api/finder/creative_agencies
Parametros Body
| Nombre | Tipo | Descripción | Requerido |
|---|---|---|---|
| name | String | Cadena de texto para filtrar por nombre | No |
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| agencies | Array | Lista de objetos de tipo Agencies |
Atributos Agencia_creativas
| Nombre | Tipo | Descripción |
|---|---|---|
| ID | Integer | Identificador de la agencia creativa |
| name | String | Nombre de la agencia creativa |
La API espera que todas las llamadas estén autenticadas con la Api key en el Authorization header:
Authorization: SECRET_API_KEY
Obtener Agen. de medios (RR)
import requests
import json
url = "radioregional.megatime.cl/api/finder/media_agencies"
payload = json.dumps({
"name": "example"
})
headers = {
'Authorization': 'SECRET_API_KEY',
'Content-Type': 'application/json'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
curl --location --request GET 'radioregional.megatime.cl/api/finder/media_agencies' \
--header 'Authorization: SECRET_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
"name": "example"
}'
var request = require("request");
var options = {
method: "GET",
url: "radioregional.megatime.cl/api/finder/media_agencies",
headers: {
Authorization: "SECRET_API_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({
name: "`example`",
}),
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"agencies": [
{
"id": 675,
"name": "12 PUBLICIDAD (MEDIA)"
},
{
"id": 978,
"name": "A.P. PUBLICIDAD (MEDIA)"
}
]
}
Retorna las agencias de medios y su respectivo id. Se debe adjuntar una 'frase' para filtrar los resultados.
Llamada HTTP
GET https://radioregional.megatime.cl/api/finder/media_agencies
Parametros Body
| Nombre | Tipo | Descripción | Requerido |
|---|---|---|---|
| name | String | Cadena de texto para filtrar por nombre | No |
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| agencies | Array | Lista de objetos de tipo Agencies |
Atributos Agencias de medios
| Nombre | Tipo | Descripción |
|---|---|---|
| ID | Integer | Identificador de la agencia de medio |
| name | String | Nombre de la agencia de medio |
La API espera que todas las llamadas estén autenticadas con la Api key en el Authorization header:
Authorization: SECRET_API_KEY
Obtener Empresas (RR)
import requests
import json
url = "radioregional.megatime.cl/api/finder/companies"
payload = json.dumps({
"name": "example"
})
headers = {
'Authorization': 'SECRET_API_KEY',
'Content-Type': 'application/json'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
curl --location --request GET 'radioregional.megatime.cl/api/finder/companies' \
--header 'Authorization: SECRET_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
"name": "example"
}'
var request = require("request");
var options = {
method: "GET",
url: "radioregional.megatime.cl/api/finder/companies",
headers: {
Authorization: "SECRET_API_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({
name: "example",
}),
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"companies": [
{
"id": 45672,
"name": "AARATI,JOYAS"
},
{
"id": 12387,
"name": "ACEROLAIS,JOYAS"
},
{
"id": 976453,
"name": "ACUARIO JOYAS"
}
]
}
Retorna las empresas y su respectivo id. Se debe adjuntar una 'frase' para filtrar los resultados.
Llamada HTTP
GET https://radioregional.megatime.cl/api/finder/companies
Parametros Body
| Nombre | Tipo | Descripción | Requerido |
|---|---|---|---|
| name | String | Cadena de texto para filtrar por nombre | No |
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| companies | Array | Lista de objetos de tipo Companies |
Atributos Empresas
| Nombre | Tipo | Descripción |
|---|---|---|
| ID | Integer | Identificador de la empresa |
| name | String | Nombre de la empresa |
La API espera que todas las llamadas estén autenticadas con la Api key en el Authorization header:
Authorization: SECRET_API_KEY
Obtener Radios (RR)
import requests
url = "radioregional.megatime.cl/api/finder/radios"
payload={}
headers = {
'Authorization': 'SECRET_API_KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
curl --location --request GET 'radioregional.megatime.cl/api/finder/radios' \
--header 'Authorization: SECRET_API_KEY'
var request = require("request");
var options = {
method: "GET",
url: "radioregional.megatime.cl/api/finder/radios",
headers: {
Authorization: "SECRET_API_KEY",
},
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"radios": [
{
"id": 3453,
"nombre": "ACONCAGUA"
},
{
"id": 9867,
"nombre": "AGUA MARINA"
}
]
}
Retorna las radios y su respectivo id.
Llamada HTTP
GET https://radioregional.megatime.cl/api/finder/radios
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| radios | Array | Lista de objetos de tipo Radio |
Atributos Radio
| Nombre | Tipo | Descripción |
|---|---|---|
| ID | Integer | Identificador de la radio |
| name | String | Nombre de la radio |
La API espera que todas las llamadas estén autenticadas con la Api key en el Authorization header:
Authorization: SECRET_API_KEY
Comercializador
Obtener API Key
iimport requests
import json
url = "cuenta.megatime.cl/api/auth/key"
payload = json.dumps({
"email": "user@example.com",
"password": "**********"
})
headers = {
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.json())
curl --location --request POST 'cuenta.megatime.cl/api/auth/key' \
--header 'Content-Type: application/json' \
--data-raw '{
"email": "user@example.com",
"password": "**********"
}'
var request = require("request");
var options = {
method: "POST",
url: "cuenta.megatime.cl/api/auth/key",
headers: {
"Content-Type": "application/json",
},
body: JSON.stringify({
email: "user@example.com",
password: "**********",
}),
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"key": "71e1db8n090am63ca69606c4slb8b6ta"
}
Retorna key que permite el acceso a la API.
Llamada HTTP
POST cuenta.megatime.cl/api/auth/key
Parámetros Body
| Nombre | Tipo | Descripción | Requerido |
|---|---|---|---|
| String | Correo asociado a credencial de Megatime | Sí | |
| password | String | Contraseña asociado a credencial de Megatime | Sí |
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| key | String | Llave de acceso a API |
La API espera que todas las llamadas estén autenticadas con la Api key en el Authorization header:
Authorization: SECRET_API_KEY
Inserción Spots
Insertar spots para su posterior asignación del comercializador en data Megatime
curl --location --request POST 'comercializador.megatime.cl/api/spots' \
--header 'Authorization: SECRET_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
"data": [{
"date_supplier": "2022-01-23",
"time_supplier": "25:56:49",
"date": "2022-01-23",
"time": "25:56:58",
"support_id": 6013,
"advertisement_id": 598610,
"is_match": true
}, {
"date_supplier": "2022-03-03",
"time_supplier": "18:12:35",
"date": "2022-03-03",
"time": "18:12:44",
"support_id": 6001,
"advertisement_id": 601035,
"is_match": true
}]
}'
import requests
import json
url = "comercializador.megatime.cl/api/spots"
payload = json.dumps({
"data": [
{
"date_supplier": "2022-01-23",
"time_supplier": "25:56:49",
"date": "2022-01-23",
"time": "25:56:58",
"support_id": 6013,
"advertisement_id": 598610,
"is_match": True
},
{
"date_supplier": "2022-03-03",
"time_supplier": "18:12:35",
"date": "2022-03-03",
"time": "18:12:44",
"support_id": 6001,
"advertisement_id": 601035,
"is_match": True
}
]
})
headers = {
'Authorization': 'SECRET_API_KEY',
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
var request = require("request");
var options = {
method: "POST",
url: "comercializador.megatime.cl/api/spots",
headers: {
Authorization: "SECRET_API_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({
data: [
{
date_supplier: "2022-01-23",
time_supplier: "25:56:49",
date: "2022-01-23",
time: "25:56:58",
support_id: 6013,
advertisement_id: 598610,
is_match: true,
},
{
date_supplier: "2022-03-03",
time_supplier: "18:12:35",
date: "2022-03-03",
time: "18:12:44",
support_id: 6001,
advertisement_id: 601035,
is_match: true,
},
],
}),
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ejemplo de retorno en formato JSON:
{
"ok": true,
"message": "2 spots inserted"
}
Llamada HTTP
POST https://comercializador.megatime.cl/api/spots
Parametros Body
| Nombre | Tipo | Descripción | Requerido |
|---|---|---|---|
| data | Array | Lista de objetos tipo Spot |
Si |
Atributos Spot
| Nombre | Tipo | Descripción | Requerido |
|---|---|---|---|
| date_supplier | String | Fecha exhibición del spot por Comercializador en formato YYYY-MM-DD | Si |
| time_supplier | String | Tiempo exhibición del spot por Comercializador en formato HH:MM:SS | Si |
| date | String | Fecha exhibición del spot publicado por Megatime en formato YYYY-MM-DD. Debe ir con valor null en caso de no match | No |
| time | String | Tiempo exhibición del spot publicado por Megatime en formato HH:MM:SS. Debe ir con valor null en caso de no match | No |
| support_id | Integer | ID del soporte / canal de exhibición | Si |
| advertisement_id | Integer | ID del aviso exhibido | Si |
| is_match | Boolean | Indicador si spot inyectado contiene correlación con spot megatime | Si |
Atributos Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| ok | Boolean | Verificador de respuesta |
| message | String | Mensaje de estado indicando cuantos spots se insertaron en caso de éxito |
Errores
Nuestras API REST utilizan los siguientes códigos de error:
| Código | Nombre | Descripción |
|---|---|---|
| 400 | Bad Request | Tu consulta es inválida. |
| 401 | Unauthorized | Tu API key es inválida. |
| 403 | Forbidden | La data consultada se encuentra oculta sólo para administradores. |
| 404 | Not Found | La data especificada a consultar no se encuentra. |
| 429 | Too Many Requests | Estás haciendo muchas consultas seguidas. |
| 500 | Internal Server Error | Tuvimos un problema con nuestros servidores. Por favor intenta más tarde. |
| 503 | Service Unavailable | Nos encontramos temporalmente fuera de servicio. Por favor intenta más tarde. |