# About Phiture
http://phiture.com is a Berlin-based mobile growth consultancy working with the teams behind leading apps. Using the company’s industry-acclaimed Mobile Growth Stack as a strategic framework, Phiture team offers 4 key services: App Store Optimization, Apple Search Ads, User Retention services and Growth Consulting.
# Apple Searchads API Library in Python
In order to facilitate the usage of the Apple Search Ads API Phiture's Engineers
have built a library in Python which allows users to manage campaigns, ad groups,
keywords and creative sets. This library only requires intermediate Python skills
and therefore makes it possible not only for Engineers but also for Data Analysts
and Apple Search Ads Consultants to work with it.
While the library is extensive it is not complete and users are encouraged to commit suggestions.
Read the docs on github.
# Example Usage:
Setup for v4 of the library
create a certs directory inside of your project folder, or create a different certs directory and specify it using the certificates_dir_path argument.
api = SearchAdsAPI(2134535, "public.pem","private.key",
client_id="SEARCHADS.07875add-f6cd-4111-9c38-b84501d557c8",
team_id="SEARCHADS.07879add-d6cd-4111-9c38-b84501d527c8",
key_id="78a167b1-e423-4ab4-bcd1-8be75a4d7b7e", verbose=True)
### Campaign Methods
- Create a new campaign
res = api.create_campaign(1433439534, ['AU'], "test", 1, 1, "EUR")
## Changelog
version 0.1.1 Added granularity level reports
version 0.7.1 fixed some issues with granularity
version 1.1.1 added support for the v4 of the Apple Search Ads API
version 1.2.1 refresh access_tokn only when needed
version 1.5.1 handles API error with Exception
version 1.5.3 fixed token update issue
version 1.6.1 added new product page, reporting, and Ad endpoints. Deprecated creatives endpoints
version 1.6.3 includes new bug fixes
version 1.7.1 added impression share reports and new find methods along product pages to match Searchads API version 4.7
version 1.7.6 fixed an issue with token update
version 1.7.7 fixed an issue update_campaign
version 1.7.8 updated the dependencies
version 1.7.9 always use the latest requests package
version 1.7.10 always use the latest cryptography package
version 1.7.11 added support for use cert and key as strings
version 1.7.13 added support for the v5 of the Apple Search Ads API
version 1.7.14 fixed an issue with the timezone for Search Terms + Search Terms within Ad Groups (must be ORTZ - organization time zone)
Raw data
{
"_id": null,
"home_page": "https://github.com/phiture/searchads_api",
"name": "searchads-api",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "python, searchads, library, apple",
"author": "Abdul Majeed Alkattan",
"author_email": "alkattan@phiture.com",
"download_url": "https://files.pythonhosted.org/packages/5b/09/231a44952176c08e80947accd672d953e3c0f47a2a2841978ae5865581eb/searchads_api-1.7.14.tar.gz",
"platform": null,
"description": "\n\n# About Phiture\n\nhttp://phiture.com is a Berlin-based mobile growth consultancy working with the teams behind leading apps. Using the company\u2019s industry-acclaimed Mobile Growth Stack as a strategic framework, Phiture team offers 4 key services: App Store Optimization, Apple Search Ads, User Retention services and Growth Consulting.\n\n\n# Apple Searchads API Library in Python\n\nIn order to facilitate the usage of the Apple Search Ads API Phiture's Engineers \nhave built a library in Python which allows users to manage campaigns, ad groups, \nkeywords and creative sets. This library only requires intermediate Python skills \nand therefore makes it possible not only for Engineers but also for Data Analysts \nand Apple Search Ads Consultants to work with it. \nWhile the library is extensive it is not complete and users are encouraged to commit suggestions.\n\nRead the docs on github.\n\n# Example Usage:\n\nSetup for v4 of the library\n\ncreate a certs directory inside of your project folder, or create a different certs directory and specify it using the certificates_dir_path argument.\n\n api = SearchAdsAPI(2134535, \"public.pem\",\"private.key\", \n client_id=\"SEARCHADS.07875add-f6cd-4111-9c38-b84501d557c8\",\n team_id=\"SEARCHADS.07879add-d6cd-4111-9c38-b84501d527c8\",\n key_id=\"78a167b1-e423-4ab4-bcd1-8be75a4d7b7e\", verbose=True)\n\n### Campaign Methods\n\n- Create a new campaign\n\n res = api.create_campaign(1433439534, ['AU'], \"test\", 1, 1, \"EUR\")\n\n## Changelog\n\nversion 0.1.1 Added granularity level reports\n\nversion 0.7.1 fixed some issues with granularity\n\nversion 1.1.1 added support for the v4 of the Apple Search Ads API\n\nversion 1.2.1 refresh access_tokn only when needed\n\nversion 1.5.1 handles API error with Exception\n\nversion 1.5.3 fixed token update issue\n\nversion 1.6.1 added new product page, reporting, and Ad endpoints. Deprecated creatives endpoints\n\nversion 1.6.3 includes new bug fixes\n\nversion 1.7.1 added impression share reports and new find methods along product pages to match Searchads API version 4.7\n\nversion 1.7.6 fixed an issue with token update\n\nversion 1.7.7 fixed an issue update_campaign\n\nversion 1.7.8 updated the dependencies\n\nversion 1.7.9 always use the latest requests package\n\nversion 1.7.10 always use the latest cryptography package\n\nversion 1.7.11 added support for use cert and key as strings\n\nversion 1.7.13 added support for the v5 of the Apple Search Ads API\n\nversion 1.7.14 fixed an issue with the timezone for Search Terms + Search Terms within Ad Groups (must be ORTZ - organization time zone)\n \n",
"bugtrack_url": null,
"license": null,
"summary": "Apple Searchads API non-official python library",
"version": "1.7.14",
"project_urls": {
"Homepage": "https://github.com/phiture/searchads_api"
},
"split_keywords": [
"python",
" searchads",
" library",
" apple"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "0400ea8d884ff99aab3783168eb97ddc883f2777d42aa37fad302d9d74856f87",
"md5": "b89434a3848f4c7f3ca02619b760411e",
"sha256": "8a4c8eb60515e576529cfe61596958a0e99d288763305780637a8f1d44094f2b"
},
"downloads": -1,
"filename": "searchads_api-1.7.14-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b89434a3848f4c7f3ca02619b760411e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 13978,
"upload_time": "2024-07-24T10:47:04",
"upload_time_iso_8601": "2024-07-24T10:47:04.308859Z",
"url": "https://files.pythonhosted.org/packages/04/00/ea8d884ff99aab3783168eb97ddc883f2777d42aa37fad302d9d74856f87/searchads_api-1.7.14-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "5b09231a44952176c08e80947accd672d953e3c0f47a2a2841978ae5865581eb",
"md5": "e60d3b437fc72c822e036155a6115786",
"sha256": "96ec283b6b4b56577767878812e63910906983384c01e7d708ef5101b683d43b"
},
"downloads": -1,
"filename": "searchads_api-1.7.14.tar.gz",
"has_sig": false,
"md5_digest": "e60d3b437fc72c822e036155a6115786",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 17221,
"upload_time": "2024-07-24T10:47:05",
"upload_time_iso_8601": "2024-07-24T10:47:05.461621Z",
"url": "https://files.pythonhosted.org/packages/5b/09/231a44952176c08e80947accd672d953e3c0f47a2a2841978ae5865581eb/searchads_api-1.7.14.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-24 10:47:05",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "phiture",
"github_project": "searchads_api",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "searchads-api"
}
JSON
