Skip to content

Vonng/go-itunes-search

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

16 Commits
app
app
ย 
ย 
bin
bin
ย 
ย 
daemon
daemon
ย 
ย 
.gitignore
.gitignore
ย 
ย 
README.md
README.md
ย 
ย 
api.go
api.go
ย 
ย 
api_test.go
api_test.go
ย 
ย 
const.go
const.go
ย 
ย 
entry.go
entry.go
ย 
ย 

Repository files navigation

iTunes Search API for Golang

go-itunes-search is a golang wrapper for iTunes Search API , also provides a binary tool for quick search.

Reference

See iTunes Search API Document for more details.

Install

SDK:

go get github.com/Vonng/go-itunes-search

Binary Util

cd $GOPATH/src/github.com/Vonng/go-itunes-search/bin && make install

Binary Util Usage

Simple & handy tools for iTunes App Search & Lookup, source code : bin/itunes.go

Usage:

Usage of itunes: -b string	bundleID for lookup eg:com.tencent.xin -c string	restrict to country. default:CN (default "CN") -d	fetch extra details. default:disabled -i string	id for lookup. eg:414478124 -l	show result in list format -n int	number of result size. 1~200,default:50 (default 10) -s string	searching keyword eg:HelloWorld

Options

  • Available language code could refer to ISO 3166-1 alpha-2 , Specify by -c

  • -d options provides extra info, requires an extra RoundTrip to corresponding iTunes Store.

  • Actually you can fetch basic entry & extra info from two different country.

  • -n will limit result size, default 50, range from 1 to 200. but fixed to 1 when provide id or bundleID

  • -l will tabulate result with iTunesID, BundleID, AppName, Version only, only available on search

  • -s provides searching keywords, you may refer iTunes Search API Document for more detail

  • -i means lookup iTunes entity by iTunesID, which is a serial like 414478124ใ€‚

  • -d means lookup iTunes entity by BundleID, which looks like a domain name: com.MaoTian.XiXiGame

Example

Search keywords

# search keyword `credit` in US Store, return 10 records, list format $ itunes -s hello -c US -n 10 -l 10 result returned. +-----------+--------------------------------------+--------------------------------+-------------+ | ITUNESID | BUNDLEID | NAME | VER | +-----------+--------------------------------------+--------------------------------+-------------+ | 508231856 | com.zello.client.main | Zello Walkie Talkie | 3.40 | | 582654048 | com.sega.sonicdash | Sonic Dash | 3.7.3 | | 293778748 | com.namconetworks.pacmanlite | PAC-MAN | 6.4.4 | | 443904275 | jp.naver.line | LINE | 7.7.0 | | 518908100 | com.sdeurope.itunes.helloKittyCafeUS | Hello Kitty Cafe! | 1.7.2 | | 318447346 | com.HalcyonInnovation.HelloVino | Hello Vino: Wine Assistant | 5.0 | | 949737354 | com.budgestudios.HelloKittyNailSalon | Hello Kitty Nail Salon | 1.1 | | 505780419 | com.sanrio.HelloKittyWorld | Hello Kitty World - Fun Park | 3.11.0 | | | | Game | | | 969589921 | com.budgestudios.HelloKittyLunchBox | Hello Kitty Lunchbox โ€“ Food | 1.3 | | | | Maker | | | 690046600 | com.blackberry.bbm1 | BBM | 300.0.15.81 | +-----------+--------------------------------------+--------------------------------+-------------+

Lookup App by iTunes Track ID (ID)

# lookup by iTunesID 414478124 in CHINESE store ,show detail itunes -i 414478124 -c JP -d 
โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ” โ”ƒ [software] 414478124 com.tencent.xin ๅพฎไฟก 6.5.13 โ”ƒ https://itunes.apple.com/cn/app/%E5%BE%AE%E4%BF%A1/id414478124?mt=8&uo=4 โ”ƒ http://is2.mzstatic.com/image/thumb/Purple128/v4/db/c6/be/dbc6beea-e606-8548-9017-d2cfa3e6c300/source/512x512bb.jpg โ”ƒ Price: 0 CNY โ”ฃโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆ โ”ƒ Provider: โ”ƒ	614694882 WeChat https://itunes.apple.com/cn/developer/wechat/id614694882?uo=4 โ”ƒ	Tencent Technology (Shenzhen) Company Limited ยฉ Tencent Inc. http://weixin.qq.com โ”ฃโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆ โ”ƒ Genre: โ”ƒ	6005 [6005 6007] โ”ƒ	Social Networking [็คพไบค ๆ•ˆ็Ž‡] โ”ฃโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆ โ”ƒ Icon60 : http://is2.mzstatic.com/image/thumb/Purple128/v4/db/c6/be/dbc6beea-e606-8548-9017-d2cfa3e6c300/source/60x60bb.jpg โ”ƒ Icon100: http://is2.mzstatic.com/image/thumb/Purple128/v4/db/c6/be/dbc6beea-e606-8548-9017-d2cfa3e6c300/source/100x100bb.jpg โ”ฃโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆ โ”ƒ Environ: โ”ƒ	System : 8.0 โ”ƒ	Features : [iosUniversal] โ”ƒ	Devices : [iPad23G-iPad23G iPad2Wifi-iPad2Wifi iPad611-iPad611 iPad612-iPad612 iPad71-iPad71 iPad72-iPad72 iPad73-iPad73 iPad74-iPad74 iPadAir-iPadAir iPadAir2-iPadAir2 iPadAir2Cellular-iPadAir2Cellular iPadAirCellular-iPadAirCellular iPadFourthGen-iPadFourthGen iPadFourthGen4G-iPadFourthGen4G iPadMini-iPadMini iPadMini3-iPadMini3 iPadMini3Cellular-iPadMini3Cellular iPadMini4-iPadMini4 iPadMini4Cellular-iPadMini4Cellular iPadMini4G-iPadMini4G iPadMiniRetina-iPadMiniRetina iPadMiniRetinaCellular-iPadMiniRetinaCellular iPadPro-iPadPro iPadPro97-iPadPro97 iPadPro97Cellular-iPadPro97Cellular iPadProCellular-iPadProCellular iPadThirdGen-iPadThirdGen iPadThirdGen4G-iPadThirdGen4G iPhone4S-iPhone4S iPhone5-iPhone5 iPhone5c-iPhone5c iPhone5s-iPhone5s iPhone6-iPhone6 iPhone6Plus-iPhone6Plus iPhone6s-iPhone6s iPhone6sPlus-iPhone6sPlus iPhone7-iPhone7 iPhone7Plus-iPhone7Plus iPhoneSE-iPhoneSE iPodTouchFifthGen-iPodTouchFifthGen iPodTouchSixthGen-iPodTouchSixthGen] โ”ƒ	Languages: [AR DE EN ES FR HE HI ID IT JA KO MS PL PT RU TH TR VI ZH ZH ZH] โ”ƒ	Platforms: [iPad iPhone iPod iWatch] โ”ฃโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆ โ”ƒ Rating : 12+ โ”ƒ Reasons: [ๅถๅฐ”/่ฝปๅพฎ็š„่‰ฒๆƒ…ๅ†…ๅฎนๆˆ–่ฃธ้œฒ] โ”ฃโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆ โ”ƒ Size: 207158272 VppDevice: true GameCenter:false โ”ƒ Rating(Current) : 4 / 2435 โ”ƒ Rating(Historic) : 4 / 818418 โ”ƒ Sibling Apps : [] โ”ƒ Related Apps : [] โ”—โ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆ Screenshots:	http://a1.mzstatic.com/us/r30/Purple128/v4/e1/e4/e2/e1e4e2b0-db07-266b-7d81-b3b3486b473d/screen696x696.jpeg	http://a2.mzstatic.com/us/r30/Purple118/v4/c6/38/4a/c6384adf-0f65-79a8-3862-791404cbef28/screen696x696.jpeg	http://a2.mzstatic.com/us/r30/Purple128/v4/d8/56/af/d856afcd-e9cc-9936-d4f8-cd62e6d1c967/sc1024x768.jpeg	http://a3.mzstatic.com/us/r30/Purple118/v4/90/54/7d/90547d63-3c8b-e788-9ca9-2528a7aa6ed1/screen390x390.jpeg	http://a3.mzstatic.com/us/r30/Purple118/v4/c7/7c/27/c77c278b-385c-0208-158e-e7baf2c66031/screen696x696.jpeg	http://a3.mzstatic.com/us/r30/Purple118/v4/e7/ec/75/e7ec75b9-f6da-5083-d923-27809ddd90c8/screen696x696.jpeg	http://a3.mzstatic.com/us/r30/Purple118/v4/eb/bc/34/ebbc346f-033b-1b0b-0381-2f0d97709522/screen390x390.jpeg	http://a3.mzstatic.com/us/r30/Purple128/v4/33/e2/5f/33e25f99-bca3-1747-db6b-378912b45f0c/sc1024x768.jpeg	http://a4.mzstatic.com/us/r30/Purple118/v4/57/81/b9/5781b924-e6e0-02f2-1cbb-98afdd5e0c06/screen390x390.jpeg	http://a4.mzstatic.com/us/r30/Purple118/v4/db/85/fc/db85fc17-dd73-b461-7430-33b501995aef/sc1024x768.jpeg	http://a5.mzstatic.com/us/r30/Purple128/v4/02/9f/17/029f175c-7a83-5b09-9593-07deab91fd77/screen696x696.jpeg	http://a5.mzstatic.com/us/r30/Purple128/v4/03/84/da/0384da46-9b4e-8258-b80d-e618d45d565a/screen390x390.jpeg โ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆ Purchase:	1:ยฅ1.00:ๅŒๆ‹ผไน–ๅทง	2:ยฅ6.00:้‚“่ถ…	3:ยฅ6.00:้‡ŽๅŽŸๆ–ฐไน‹ๅŠฉ	4:ยฅ6.00:ๅฐS	5:ยฅ6.00:Hello Kitty	6:ยฅ6.00:Angelababy	7:ยฅ6.00:ๅ“†ๅ•ฆAๆขฆ	8:ยฅ6.00:ๆŽๅ…‰ๆด™	9:ยฅ6.00:ๅŒ้‡ๆ€งๆ ผ็š„ๅ–ตๅฐ็พŽ	10:ยฅ6.00:็”œ็”œ็งๆˆฟ็Œซ โ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆ Reviews: [ [ "ๅ†ฏ---YQ", "5ๆ˜Ÿ", "ไธ็Ÿฅๆ€Ž็š„ๅฐฑๆฒกๆœ‰ไบ†", "่Šๅคฉๅ‘้€ๅ›พ็‰‡็š„ๆ—ถๅ€™้€‰ๆ‹ฉๅŽŸๅ›พ็š„่ฏไธ่ƒฝๆ˜พ็คบๅ›พ็‰‡็š„ๅคงๅฐ๏ผŒไปฅๅ‰่ฟ˜ๆœ‰็š„็Žฐๅœจๅ่€Œไธ่งไบ†่ฟ™ไธชๅŠŸ่ƒฝ๏ผŒไธชไบบ่ง‰ๅพ—่ฟ™ๆ ทไธๆ˜ฏๅพˆๆ–นไพฟ๏ผŒ่€Œไธ”ๆœ‹ๅ‹ๅœˆๆœ‰ๆ—ถๅ€™่ฟ˜ไผšๅŽ‹็ผฉๅ›พ็‰‡๏ผŒๅ‘ๅ‡บๆฅ็š„้ƒฝ็ณŠๆŽ‰ไบ†๏ผŒๅซไบบๅฎถๆ€Žไนˆๆ„‰ๅฟซ็š„ๅˆ†ไบซ็”Ÿๆดป๏ผŸ๏ผŸ" ], [ "่ฟ™่พนไผšไธไผšๆœ‰ๆฐดๅ†›", "4ๆ˜Ÿ", "่ฏดไธชๅฐ็จ‹ๅบ็š„้—ฎ้ข˜๏ผŒๅธŒๆœ›่ƒฝ่ขซ็œ‹ๅˆฐ", "ๅฐ็จ‹ๅบๆœ‰ไธ€ไธช้—ฎ้ข˜๏ผŒๅฐฑๆ˜ฏๆœ‰ไธ€ไธชๆ˜พ็คบๅœจ่Šๅคฉ้กถ้ƒจ็š„ๅŠŸ่ƒฝใ€‚ไฝ†ๆ˜ฏๅช่ฆๆˆ‘ๅŽๅฐๅ…ณ้—ญๅพฎไฟก๏ผŒๆˆ–่€…้€€ๅ‡บ็™ปๅฝ•๏ผŒๅ†้‡ๆ–ฐๆ‰“ๅผ€๏ผŒๅŽŸๆฅ่ฎพ็ฝฎๅœจ่Šๅคฉ้กถ้ƒจ็š„ๅฐ็จ‹ๅบๅฐฑๆฒกไบ†โ€ฆ้œ€่ฆ้‡ๆ–ฐ่ฎพ็ฝฎ๏ผŒๆˆ‘่ง‰ๅพ—ๅพˆๅฅ‡ๆ€ชๅ•Š๏ผŒๅ› ไธบๅฆ‚ๆžœไฝ ่ฆ่ฎพ็ฝฎ็ฝฎ้กถ๏ผŒ่‚ฏๅฎšๆ˜ฏไฝ ไฝฟ็”จ็Ž‡้žๅธธ้ซ˜็š„โ€ฆ้‚ฃไธบไป€ไนˆ้‡ๆ–ฐๆ‰“ๅผ€ๅฐฑๅˆๆฒกไบ†โ€ฆ็›ฎๅ‰ๆƒ…ๅ†ตๅบ”่ฏฅๅซไธดๆ—ถ็ฝฎ้กถ๏ฝžๅ› ไธบไป–็š„ๅ…ณ้—ญๅนถไธๆ˜ฏๆˆ‘ไธป่ง‚ๆŽงๅˆถ็š„๏ผŒๆœ‰ๆ—ถๅ€™้—ช้€€ไธ€ไธ‹๏ผŒไนŸๆฒกไบ†๏ผŒๆ“ไฝœไฝ“้ชŒไธŠๅฐฑๅพˆ็ƒฆไบ†๏ผŒ้‚ฃๆˆ‘ๅฐฑไธไผšๅŽป็”จๅฐ็จ‹ๅบ็ฝฎ้กถ่ฟ™ไธชๅŠŸ่ƒฝ" ], [ "ๆผณๆตฆๅฐ่”ก", "5ๆ˜Ÿ", "ๅธŒๆœ›่ƒฝๆ”น่ฟ›ๆ”ถ่—็š„ๆŸไบ›ๅŠŸ่ƒฝ", "ๅœจๆ”ถ่—้‡Œ้ขไธ่ƒฝไธ‹่ฝฝMP3ๆ–‡ไปถ๏ผŒๆœ‰ไธ€ไธช็‚นๆญคไธ‹่ฝฝ็š„ๆŒ‰้’ฎไฝ†ๆ‰“ไธๅผ€๏ผŒๆœ‰ๆ—ถๅ€™่ฆๆๅ–ไธ€ไบ›ๆ”ถ่—้‡Œ็š„ๆ–‡ไปถ้ƒฝๆฒกๅŠžๆณ•ไธ‹่ฝฝๅพˆไธๆ–นไพฟ๏ผŒๅธŒๆœ›่ฟ™ไธช้—ฎ้ข˜่ƒฝๅฐฝๅฟซๅพ—ๅˆฐ่งฃๅ†ณ่ฐข่ฐข" ] ] โ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆ Description: ๅพฎไฟกๆ˜ฏไธ€ๆฌพๅ…จๆ–นไฝ็š„ๆ‰‹ๆœบ้€š่ฎฏๅบ”็”จ๏ผŒๅธฎๅŠฉไฝ ่ฝปๆพ่ฟžๆŽฅๅ…จ็ƒๅฅฝๅ‹ใ€‚ๅพฎไฟกๅฏไปฅ(้€š ่ฟ‡SMS/MMS็ฝ‘็ปœ)ๅ‘้€็Ÿญไฟกใ€่ฟ›่กŒ่ง†้ข‘่Šๅคฉใ€ไธŽๅฅฝๅ‹ไธ€่ตท็Žฉๆธธๆˆ๏ผŒไปฅๅŠๅˆ†ไบซ่‡ชๅทฑ็š„ ็”Ÿๆดปๅˆฐๆœ‹ๅ‹ๅœˆ๏ผŒ่ฎฉไฝ ๆ„Ÿๅ—่€ณ็›ฎไธ€ๆ–ฐ็š„็งปๅŠจ็”Ÿๆดปๆ–นๅผใ€‚ ไธบไป€ไนˆ่ฆไฝฟ็”จๅพฎไฟก๏ผš โ€ข ๅคšๅช’ไฝ“ๆถˆๆฏ๏ผšๆ”ฏๆŒๅ‘้€่ง†้ข‘ใ€ๅ›พ็‰‡ใ€ๆ–‡ๆœฌๅ’Œ่ฏญ้Ÿณๆถˆๆฏใ€‚ โ€ข ็พค่Šๅ’Œ้€š่ฏ๏ผš็ป„ๅปบ้ซ˜่พพ500ไบบ็š„็พค่Šๅ’Œ้ซ˜่พพ9ไบบ็š„ๅฎžๆ—ถ่ง†้ข‘่Šๅคฉใ€‚ โ€ข ๅ…่ดน่ฏญ้Ÿณๅ’Œ่ง†้ข‘่Šๅคฉ๏ผšๆไพ›ๅ…จ็ƒๅ…่ดน็š„้ซ˜่ดจ้‡้€š่ฏใ€‚ โ€ข WeChat Out๏ผš่ถ…ไฝŽ่ดน็Ž‡ๆ‹จๆ‰“ๅ…จ็ƒ็š„ๆ‰‹ๆœบๆˆ–ๅ›บๅฎš็”ต่ฏ๏ผˆ็›ฎๅ‰ไป…้™ไบŽ้ƒจๅˆ†ๅœฐๅŒบ๏ผ‰ใ€‚ โ€ข ่กจๆƒ…ๅ•†ๅบ—๏ผšๆตท้‡ๅ…่ดนๅŠจๆ€่กจๆƒ…๏ผŒๅŒ…ๆ‹ฌ็ƒญ้—จๅก้€šไบบ็‰ฉๅ’Œ็”ตๅฝฑ๏ผŒ่ฎฉ่Šๅคฉๅ˜ๅพ—ๆ›ด็”ŸๅŠจๆœ‰่ถฃใ€‚ โ€ข ๆœ‹ๅ‹ๅœˆ๏ผšไธŽๅฅฝๅ‹ๅˆ†ไบซๆฏไธช็ฒพๅฝฉ็žฌ้—ด๏ผŒ่ฎฐๅฝ•่‡ชๅทฑ็š„็”Ÿๆดป็‚นๆปดใ€‚ โ€ข ้š็งไฟๆŠค๏ผšไธฅๆ ผไฟๆŠค็”จๆˆท็š„้š็งๅฎ‰ๅ…จ๏ผŒๆ˜ฏๅ”ฏไธ€ไธ€ๆฌพ้€š่ฟ‡TRUSTe่ฎค่ฏ็š„ๅฎžๆ—ถ้€š่ฎฏๅบ”็”จใ€‚ โ€ข ่ฎค่ฏ†ๆ–ฐๆœ‹ๅ‹๏ผš้€š่ฟ‡โ€œ้›ท่พพๅŠ ๆœ‹ๅ‹โ€ใ€โ€œ้™„่ฟ‘็š„ไบบโ€ๅ’Œโ€œๆ‘‡ไธ€ๆ‘‡โ€่ฎค่ฏ†ๆ–ฐๆœ‹ๅ‹ใ€‚ โ€ข ๅฎžๆ—ถไฝ็ฝฎๅ…ฑไบซ๏ผšไธŽๅฅฝๅ‹ๅˆ†ไบซๅœฐ็†ไฝ็ฝฎ๏ผŒๆ— ้œ€้€š่ฟ‡่ฏญ่จ€ๅ‘Š่ฏ‰ๅฏนๆ–นใ€‚ โ€ข ๅคš่ฏญ่จ€๏ผšๆ”ฏๆŒ่ถ…่ฟ‡20็ง่ฏญ่จ€็•Œ้ข๏ผŒๅนถๆ”ฏๆŒๅคšๅ›ฝ่ฏญ่จ€็š„ๆถˆๆฏ็ฟป่ฏ‘ใ€‚ ยท ๅพฎไฟก่ฟๅŠจ๏ผŒๆ”ฏๆŒๆŽฅๅ…ฅApple Watch ๅŠiPhoneๅฅๅบทๆ•ฐๆฎ๏ผŒๅฏ้€š่ฟ‡โ€œWeRun-WeChatโ€ๅ…ฌไผ—ๅทไธŽๅฅฝๅ‹ไธ€่พƒ้ซ˜ไธ‹ใ€‚ โ€ข ๆ›ดๅคšๅŠŸ่ƒฝ: ๆ”ฏๆŒ่ทจๅนณๅฐใ€่Šๅคฉๅฎคๅข™็บธ่‡ชๅฎšไน‰ใ€ๆถˆๆฏๆ้†’่‡ชๅฎšไน‰ๅ’Œๅ…ฌไผ—ๅทๆœๅŠก็ญ‰ใ€‚ โ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆ Support Sites: { "WeChat ็ฝ‘็ซ™": "http://weixin.qq.com", "ๅพฎไฟก ๆ”ฏๆŒ": "http://weixin.qq.com" } โ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆ ReleaseNotes: ๆœฌๆฌกๆ›ดๆ–ฐ - ็พค่ต„ๆ–™้กตๅฏไปฅๆŸฅ็œ‹ๆœ€่ฟ‘ๆ”ถๅˆฐ็š„ๅฐ็จ‹ๅบใ€‚ ๆœ€่ฟ‘ๆ›ดๆ–ฐ - ๅฏไปฅๅฏน่ง†้ข‘่ฟ›่กŒ็ผ–่พ‘ใ€‚ - ๅฏไปฅ่ฎพ็ฝฎๆŸๆกๆœ‹ๅ‹ๅœˆ็š„ไบ’ๅŠจไธๅ†้€š็Ÿฅใ€‚ โ”โ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆ โ”ƒ Release: 2017-08-07 06:33:21 +0000 UTC โ”ƒ Publish: 2011-01-21 01:32:15 +0000 UTC โ”ƒ Crawled: 2017-08-10 16:27:52.707293359 +0800 CST m=+0.727757043 โ”—โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”

Lookup App by BundleID

# lookup app by bundleID: com.tencent.smoba in default Store(CN) without extra detail itunes -b com.tencent.smoba 
โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ” โ”ƒ [software] 989673964 com.tencent.smoba ็Ž‹่€…่ฃ่€€ 1.20.1.21 โ”ƒ https://itunes.apple.com/cn/app/%E7%8E%8B%E8%80%85%E8%8D%A3%E8%80%80/id989673964?mt=8&uo=4 โ”ƒ http://is1.mzstatic.com/image/thumb/Purple128/v4/a5/bb/e5/a5bbe51f-5ba0-575d-de94-da6f65deb3a2/source/512x512bb.jpg โ”ƒ Price: 0 CNY โ”ฃโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆ โ”ƒ Provider: โ”ƒ	446324237 Tencent Mobile Games https://itunes.apple.com/cn/developer/tencent-mobile-games/id446324237?uo=4 โ”ƒ	Shenzhen Tencent Computer Systems Company Limited โ”ฃโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆโ”ˆ ........(too long)

Package Usage

package provides itunes-search-api wrapper of Golang. with extra support for applications. If you are using PostgreSQL as well, it's very convient to save app data to PG.

import

import . "github.com/Vonng/go-itunes-search"

Search Example

search with keyword Hello & World๏ผŒUS AppStore๏ผŒRestrict media type to Software๏ผŒAt more 5 result.

func TestSearch(t *testing.T) { res, _ := Search([]string{"Hello", "World"}). Country(US). App(). Limit(5). Results() for _, r := range res { r.Print()	} }

result is fetched via .Results or .Result๏ผŒthe latter assert only one result is returned so it returns *Entry rather than []Entryใ€‚

Lookup Example

if you know something could used to identify a track, then lookup API may be a better approach. Instead of specifying term, you need something like iTunesID (track_id), BundleID(app only), AMG ID, etcโ€ฆใ€‚And when using lookup API, there could only be one or zero entry being returned. So the API chain may end with Result rather than Results

Here's how it works, these lookups may return same results:

Lookup().ID(414478124).Country(CN).Result() Lookup().BundleID("com.tencent.xin").Result() Lookup().Set(BundleID, "com.tencent.xin").Result()

Other examle

other small examples

SearchOne("ไธ–็•Œ").Country(CN).Entities([]string{Movie,Music}).Results() SearchOne("Love").Media(Music).Entity(MusicArtist).Limit(5).Results() Lookup().ID(529479190).Result() Lookup().Country(GB).ID(529479190).Result() Lookup().BundleID("com.supercell.magic").Result()

check api_test.go for more details & examples.

Entry

Entry is naive mapping to iTunes's response structure. iTunes orgnaize everything just like music track.

type Entry struct {	TrackID int64 `json:"trackId"` // Track	TrackName string `json:"trackName"`	TrackCensoredName string `json:"trackCensoredName"`	TrackViewURL string `json:"trackViewUrl"`	BundleID string `json:"bundleId"` // App bundle	ArtistID int64 `json:"artistId"` // Artist	ArtistName string `json:"artistName"`	ArtistViewURL string `json:"artistViewUrl"`	SellerName string `json:"sellerName"` // Seller	SellerURL string `json:"sellerUrl"`	PrimaryGenreID int64 `json:"primaryGenreId"` // Genre	GenreIDs []string `json:"genreIds"`	PrimaryGenreName string `json:"primaryGenreName"`	Genres []string `json:"genres"`	ArtworkURL60 string `json:"artworkUrl60"` // Icon	ArtworkURL100 string `json:"artworkUrl100"`	ArtworkURL512 string `json:"artworkUrl512"`	Price float64 `json:"price"` // Price	Currency string `json:"currency"`	FormattedPrice string `json:"formattedPrice"`	LanguageCodesISO2A []string `json:"languageCodesISO2A"` // Platform	Features []string `json:"features"`	SupportedDevices []string `json:"supportedDevices"`	MinimumOsVersion string `json:"minimumOsVersion"`	TrackContentRating string `json:"trackContentRating"`	ContentAdvisoryRating string `json:"contentAdvisoryRating"` // Rating	Advisories []string `json:"advisories"`	UserRatingCount int64 `json:"userRatingCount"` // Ranking	AverageUserRating float64 `json:"averageUserRating"`	UserRatingCountForCurrentVersion int64 `json:"userRatingCountForCurrentVersion"`	AverageUserRatingForCurrentVersion float64 `json:"averageUserRatingForCurrentVersion"`	Kind string `json:"kind"` // Type	WrapperType string `json:"wrapperType"`	ScreenshotURLs []string `json:"screenshotUrls"` // Screenshots	IpadScreenshotURLs []string `json:"ipadScreenshotUrls"`	AppletvScreenshotURLs []string `json:"appletvScreenshotUrls"`	IsGameCenterEnabled bool `json:"isGameCenterEnabled"` // Flags	IsVppDeviceBasedLicensingEnabled bool `json:"isVppDeviceBasedLicensingEnabled"`	FileSizeBytes string `json:"fileSizeBytes"` // Attribute	Version string `json:"version"`	Description string `json:"description"`	ReleaseNotes string `json:"releaseNotes"`	ReleaseDate string `json:"releaseDate"`	CurrentVersionReleaseDate string `json:"currentVersionReleaseDate"` }

Entry.Print print itself in human-friendly format.

App

for those user who only interested in Application rather than music. github.com/Vonng/go-itunes-search/app provides a more precise representation of iOS application: App.

App is an enhanced version of Entity.

It provides some additinoal features:

  • more friendly & shorter field names.
  • fetch extra fields like InAppPurchase,Reviews,RelatedApps,SupportedSites, etc...
  • Parser to fetch extra fields from corresponding country's store.
  • ORM Mapping to PostgreSQL table defined in app/app.ddl , can be used by go-pg
  • Pretty print template

While it introduce two more dependency: goquery for parsing iTunes Page, go-pg for Save function.

type App struct { ID int64 `sql:",pk"` Name string URL string Icon string Kind string Version string BundleID string AuthorID int64 AuthorName string AuthorURL string VendorName string VendorURL string Copyright string // reserved GenreID int64 GenreName string Genres []string GenreIDs []int64 Icon60 string Icon100 string Price int64 `sql:",notnull"` Currency string System string Features []string Devices []string Languages []string Platforms []string // reserved Rating string Reasons []string Size int64 CntRating int64 AvgRating float64 CntRatingCurrent int64 AvgRatingCurrent float64 VppDevice bool GameCenter bool Screenshots []string InAppPurchase []string // reserved SiblingApps []int64 // reserved RelatedApps []int64 // reserved SupportSites string // reserved Reviews string // reserved Description string ReleaseNotes string ReleaseTime time.Time PublishTime time.Time CrawledTime time.Time }

Entry2App

Transform Entry to App is simple. Just use App constructor:

func NewApp(entry *Entry) (app *App) func NewDetailedApp(entry *Entry, country string) (app *App)

They both do the trick and guaranteed to success. the Latter will also fetch and parse Extra infos and omit error.

Save

app.Save(Pg)

This will save app to database using orm github.com/go-pg/pg

Parsing Extra App Info

Parsing extra reserved field is simple as :

app.ParseExtras(US)

Following fields may change during parsing, and won't change if parse failed

  • Copyright is fetch from left stack on iTunes page.
  • Screenshots from iTunes page will merge & dedupe with API's results. and do not keep difference of screenshots type: iPad, iPhone, iMessage, AppleTV, etc...
  • Platforms is infered from badge, label, screenshots, device list, etc...
  • InAppPurchase shows selling item represented as a tri-tuple <rank,price,title>
  • SiblingApps list iTunesID of apps provides by same developer shows in the app page
  • RelatedApps list iTunesID of apps recommend by apple in this app's page.
  • SupportSites show at bottom of description. k-v json object with title as key, url as value.
  • Reviews is a quad-tuple represent customer comments: <user,rating,title,content>
  • Remove CensoredName , FormattedPrice
  • Merge TrackContentRating & ContentAdvisoryRating to Rating

Dependency

go get github.com/go-pg/pg go get github.com/Sirupsen/logrus go get github.com/PuerkitoBio/goquery

Other

  • An apple daemon for crawling iTunes store.

License

WTFPL

About

iTunes Search API for Golang

Topics

search go itunes api-wrapper itunes-search

Resources

Readme
Activity

Stars

19 stars

Watchers

1 watching

Forks

6 forks
Report repository

Releases

No releases published

Packages

No packages published

Languages