{"id":21292019,"url":"https://github.com/johnnythetank/aping-plugin-bandsintown","last_synced_at":"2026-05-15T22:02:16.885Z","repository":{"id":57182148,"uuid":"48797264","full_name":"JohnnyTheTank/apiNG-plugin-bandsintown","owner":"JohnnyTheTank","description":"Bandintown Plugin for apiNG","archived":false,"fork":false,"pushed_at":"2016-10-01T07:56:56.000Z","size":26,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-21T16:11:43.063Z","etag":null,"topics":["angular","api","aping","aping-plugin","bandsintown","events","music","wall"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JohnnyTheTank.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-12-30T11:15:34.000Z","updated_at":"2016-10-26T12:01:07.000Z","dependencies_parsed_at":"2022-09-03T06:21:49.752Z","dependency_job_id":null,"html_url":"https://github.com/JohnnyTheTank/apiNG-plugin-bandsintown","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JohnnyTheTank%2FapiNG-plugin-bandsintown","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JohnnyTheTank%2FapiNG-plugin-bandsintown/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JohnnyTheTank%2FapiNG-plugin-bandsintown/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JohnnyTheTank%2FapiNG-plugin-bandsintown/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JohnnyTheTank","download_url":"https://codeload.github.com/JohnnyTheTank/apiNG-plugin-bandsintown/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243762228,"owners_count":20343972,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["angular","api","aping","aping-plugin","bandsintown","events","music","wall"],"created_at":"2024-11-21T13:47:13.924Z","updated_at":"2025-10-15T08:01:37.489Z","avatar_url":"https://github.com/JohnnyTheTank.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"[logo]: http://aping.io/logo/320/aping-plugin.png \"apiNG Plugin\"\n![apiNG][logo]\n\n[![Join the chat at https://gitter.im/JohnnyTheTank/apiNG](https://img.shields.io/badge/GITTER-join%20chat-green.svg)](https://gitter.im/JohnnyTheTank/apiNG?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge\u0026utm_content=badge)\n[![npm version](https://badge.fury.io/js/aping-plugin-bandsintown.svg)](https://badge.fury.io/js/aping-plugin-bandsintown)\n[![Bower version](https://badge.fury.io/bo/apiNG-plugin-bandsintown.svg)](https://badge.fury.io/bo/apiNG-plugin-bandsintown)\n\n**_apiNG-plugin-bandsintown_** is a [BandsInTown v2 API](http://bandsintown.com/api/requests) plugin for [**apiNG**](https://github.com/JohnnyTheTank/apiNG).\n\n# Information\n* **Supported apiNG models: `event`**\n* This plugin supports the [`get-native-data` parameter](https://aping.readme.io/docs/advanced#parameters)\n* This plugin needs an [api key](#2-api-key) :warning:\n* Used promise library: [angular-bandsintown-api-factory](https://github.com/JohnnyTheTank/angular-bandsintown-api-factory) _(included in distribution files)_\n\n# Documentation\n1. [INSTALLATION](#1-installation)\n    1. Get file\n    2. Include file\n    3. Add dependency\n    4. Add plugin\n2. [API KEY](#2-api-key)\n3. [USAGE](#3-usage)\n    1. Models\n    2. Requests\n\n## 1. INSTALLATION\n\n### I. Get file\nInstall via either [bower](http://bower.io/), [npm](https://www.npmjs.com/), CDN (jsDelivr) or downloaded files:\n\n* `bower install apiNG-plugin-bandsintown --save`\n* `npm install aping-plugin-bandsintown --save`\n* use [CDN file](https://www.jsdelivr.com/projects/aping.plugin-bandsintown)\n* download [apiNG-plugin-bandsintown.zip](https://github.com/JohnnyTheTank/apiNG-plugin-bandsintown/zipball/master)\n\n### II. Include file\nInclude `aping-plugin-bandsintown.min.js` in your apiNG application\n\n```html\n\u003c!-- when using bower --\u003e\n\u003cscript src=\"bower_components/apiNG-plugin-bandsintown/dist/aping-plugin-bandsintown.min.js\"\u003e\u003c/script\u003e\n\n\u003c!-- when using npm --\u003e\n\u003cscript src=\"node_modules/aping-plugin-bandsintown/dist/aping-plugin-bandsintown.min.js\"\u003e\u003c/script\u003e\n\n\u003c!-- when using cdn file --\u003e\n\u003cscript src=\"//cdn.jsdelivr.net/aping.plugin-bandsintown/latest/aping-plugin-bandsintown.min.js\"\u003e\u003c/script\u003e\n\n\u003c!-- when using downloaded files --\u003e\n\u003cscript src=\"aping-plugin-bandsintown.min.js\"\u003e\u003c/script\u003e\n```\n\n### III. Add dependency\nAdd the module `jtt_aping_bandsintown` as a dependency to your app module:\n```js\nangular.module('app', ['jtt_aping', 'jtt_aping_bandsintown']);\n```\n\n### IV. Add plugin\nAdd the plugin's directive `aping-bandsintown=\"[]\"` to your apiNG directive and [configure your requests](#ii-requests)\n```html\n\u003caping\n    template-url=\"templates/event.html\"\n    model=\"event\"\n    items=\"20\"\n    aping-bandsintown=\"[{'artist':'Prinz Pi'}]\"\u003e\n\u003c/aping\u003e\n```\n\n## 2. API KEY\n[Official BandsInTown Authentication Docs:](http://bandsintown.com/api/authentication)\n\u003e The application ID can be anything, but should be a word that describes your application or company.\n\nCreate and open `js/apiNG/aping-config.js` in your application folder. It should be look like this snippet:\n```js\nangular.module('jtt_aping').config(['$provide', function ($provide) {\n    $provide.value(\"apingDefaultSettings\", {\n        apingApiKeys : {\n            bandsintown: [\n                {'app_id':'\u003cYOUR_BANDSINTOWN_APP_ID\u003e'}\n            ],\n            //...\n        }\n    });\n}]);\n```\n\n:warning: Replace `\u003cYOUR_BANDSINTOWN_APP_ID\u003e` with a word that describes your application or company\n\n## 3. USAGE\n\n### I. Models\nSupported apiNG models\n\n|  model   | content |\n|----------|---------|\n| `event` | **concerts, tours, shows** |\n\n\n### II. Requests\nEvery **apiNG plugin** expects an array of **requests** as html attribute.\n\n#### Requests by Artist\n|  parameter  | sample | default | description | optional |\n|----------|---------|---------|---------|---------|\n| **`artist`** | `Metallica` |  | Artist name (url escaped*), `mbid_\u003cid\u003e` (MusicBrainz ID), `fbid_\u003cid\u003e` (Facebook Page ID)  | no |\n| **`artist_id`** | `mbid_65f4f0c5-ef9e-490c-aee3-909e7ae6b2ab` |  | (fallback) artist id, `mbid_\u003cid\u003e` (MusicBrainz ID), `fbid_\u003cid\u003e` (Facebook Page ID) | yes |\n| **`showAvatar`**  | `true` | `false` | Use `true` for show artists image |  yes  |\n| **`items`**  | `20` | | Items per request (`0`-`n`) |  yes  |\n| **`date`**  | `all` | `upcoming` | valid values: `yyyy-mm-dd`, `upcoming`, `all` |  yes  |\n| **`start_date`**  | `2016-01-31` |  | Start date. format: `yyyy-mm-dd`. Needs `end_date` |  yes  |\n| **`end_date`**  | `2016-04-15` |  | End date. format: `yyyy-mm-dd`. Needs `start_date` |  yes  |\n| **`location`**  | `munich,germany` |  | Location to search `city,state` (US or CA), `city,country` |  yes  |\n| **`lat`** | `-13.163333` |  | Latitude of the location. Needs `lng` | yes |\n| **`lng`** | `-72.545556` |  | Longitude of the location. Needs `lat` | yes |\n| **`distance`** | `10` | `25`  | Number (miles) of radius from location (or coordinates) | yes |\n| **`recommended`** | `true` | `false` | Returns recommended events for a single artist matching search criteria | yes |\n| **`exclude`** | `true` | `false` | If true, the response will only include matching events for artists similar to the specified artist. if false, the response may also include matching events for the specified artist. | yes |\n\nSample requests:\n* `[{'artist':'Prinz Pi', 'showAvatar':true}]`\n* `[{'artist':'Prinz Pi', 'location':'munich,germany', 'date':'all', 'recommended':true}]`\n\n\n# Licence\nMIT\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjohnnythetank%2Faping-plugin-bandsintown","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjohnnythetank%2Faping-plugin-bandsintown","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjohnnythetank%2Faping-plugin-bandsintown/lists"}