apinoa 0.1.0__tar.gz

apinoa-0.1.0/.gitignore

@@ -0,0 +1,5 @@
+__pycache__/
+*.pyc
+.venv/
+dist/
+.pytest_cache/

apinoa-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 apinoa
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

apinoa-0.1.0/PKG-INFO

@@ -0,0 +1,146 @@
+Metadata-Version: 2.5
+Name: apinoa
+Version: 0.1.0
+Summary: Official Python SDK for the apinoa API: marketplace, social and image-translation data through one API.
+Project-URL: Homepage, https://apinoa.com
+Project-URL: Documentation, https://apinoa.com/docs
+Project-URL: Repository, https://github.com/apinoahq/apinoa-python
+Project-URL: Issues, https://github.com/apinoahq/apinoa-python/issues
+Author: apinoa
+License-Expression: MIT
+License-File: LICENSE
+Keywords: aliexpress,amazon,api,apinoa,instagram,reddit,scraping,sdk,shopify,tiktok,walmart,youtube
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Requires-Dist: httpx>=0.21.2
+Requires-Dist: pydantic-core>=2.18.2; python_version >= '3.9'
+Requires-Dist: pydantic>=1.9.2
+Requires-Dist: typing-extensions>=4.0.0
+Description-Content-Type: text/markdown
+
+# apinoa
+
+The official Python SDK for [apinoa](https://apinoa.com): product data from Amazon, Walmart, Shopify,
+TikTok Shop and AliExpress, social data from TikTok, YouTube, Instagram, Threads, X, Reddit and LinkedIn,
+and image translation, through one API.
+
+```sh
+pip install apinoa
+```
+
+Requires Python 3.9 or later.
+
+## Usage
+
+Create a key under **Dashboard > API keys** at [apinoa.com](https://apinoa.com), then:
+
+```python
+from apinoa import Apinoa
+
+client = Apinoa()  # reads APINOA_API_KEY; or Apinoa(api_key="...")
+
+res = client.amazon.search(query="wool socks", price_max=30)
+for item in res.data.items:
+    print(item.title, item.price.amount if item.price else None)
+```
+
+Keep the key on your server: it spends your balance.
+
+Every call is `client.<platform>.<operation>(...)`, spelled the way the URL is, in snake_case:
+`/v1/amazon/image-search` is `client.amazon.image_search(...)`, and the parameter `priceMax` is
+`price_max`. Every answer is `{ success, data, request_id }`; fields beyond the documented ones are kept
+on the object.
+
+### Marketplaces
+
+Every marketplace answers in one commerce schema: a `Product` from Amazon reads like one from Shopify.
+
+```python
+product = client.walmart.product(id="5089499913")
+reviews = client.shopify.reviews(id="allbirds.com/products/mens-tree-runners")
+tree = client.amazon.categories()
+```
+
+### Social platforms
+
+Every platform answers in one social schema (`Account`, `Post`, `Comment`, `Group`), with what only one
+platform has under `ext`.
+
+```python
+creator = client.tiktok.profile(username="khaby.lame")
+page = client.reddit.posts(community="python")
+next_page = client.reddit.posts(cursor=page.data.cursor)  # the next page: the cursor alone
+```
+
+### Image translation
+
+```python
+with open("product.jpg", "rb") as f:
+    image = f.read()
+
+translated = b"".join(
+    client.image_translate.translate(source_language="zh-CN", target_language="ko", request=image)
+)
+with open("translated.jpg", "wb") as f:
+    f.write(translated)
+```
+
+## Async
+
+`AsyncApinoa` has the same methods, awaitable:
+
+```python
+import asyncio
+from apinoa import AsyncApinoa
+
+async def main() -> None:
+    client = AsyncApinoa()
+    res = await client.youtube.profile(username="@mkbhd")
+    print(res.data.display_name)
+
+asyncio.run(main())
+```
+
+## Errors
+
+A failed call raises a subclass of `apinoa.core.ApiError` named after its status (`BadRequestError`,
+`PaymentRequiredError`, `NotFoundError`, `TooManyRequestsError`, …). `err.body.error.code` is the stable
+code to branch on; every code is listed at [apinoa.com/docs/errors](https://apinoa.com/docs/errors). A
+failed call is not billed.
+
+```python
+from apinoa import NotFoundError, PaymentRequiredError
+
+try:
+    client.amazon.product(id="B000000000")
+except NotFoundError:
+    print("no such product")
+except PaymentRequiredError:
+    print("top up your balance")
+```
+
+## Retries and timeouts
+
+`429`, `408` and `5xx` answers are retried twice with exponential backoff, honouring `Retry-After`. The
+default timeout is 300 seconds, because image translation under load can take minutes. Both can be set
+per client or per call:
+
+```python
+client = Apinoa(max_retries=4, timeout=60)
+client.tiktok.posts(username="nasa", request_options={"max_retries": 0, "timeout_in_seconds": 10})
+```
+
+## Reference
+
+Every method and parameter: [reference.md](./reference.md). The API itself:
+[apinoa.com/docs](https://apinoa.com/docs). The OpenAPI document this SDK is generated from:
+[apinoa.com/openapi.json](https://apinoa.com/openapi.json).
+
+## License
+
+MIT

apinoa-0.1.0/README.md

@@ -0,0 +1,121 @@
+# apinoa
+
+The official Python SDK for [apinoa](https://apinoa.com): product data from Amazon, Walmart, Shopify,
+TikTok Shop and AliExpress, social data from TikTok, YouTube, Instagram, Threads, X, Reddit and LinkedIn,
+and image translation, through one API.
+
+```sh
+pip install apinoa
+```
+
+Requires Python 3.9 or later.
+
+## Usage
+
+Create a key under **Dashboard > API keys** at [apinoa.com](https://apinoa.com), then:
+
+```python
+from apinoa import Apinoa
+
+client = Apinoa()  # reads APINOA_API_KEY; or Apinoa(api_key="...")
+
+res = client.amazon.search(query="wool socks", price_max=30)
+for item in res.data.items:
+    print(item.title, item.price.amount if item.price else None)
+```
+
+Keep the key on your server: it spends your balance.
+
+Every call is `client.<platform>.<operation>(...)`, spelled the way the URL is, in snake_case:
+`/v1/amazon/image-search` is `client.amazon.image_search(...)`, and the parameter `priceMax` is
+`price_max`. Every answer is `{ success, data, request_id }`; fields beyond the documented ones are kept
+on the object.
+
+### Marketplaces
+
+Every marketplace answers in one commerce schema: a `Product` from Amazon reads like one from Shopify.
+
+```python
+product = client.walmart.product(id="5089499913")
+reviews = client.shopify.reviews(id="allbirds.com/products/mens-tree-runners")
+tree = client.amazon.categories()
+```
+
+### Social platforms
+
+Every platform answers in one social schema (`Account`, `Post`, `Comment`, `Group`), with what only one
+platform has under `ext`.
+
+```python
+creator = client.tiktok.profile(username="khaby.lame")
+page = client.reddit.posts(community="python")
+next_page = client.reddit.posts(cursor=page.data.cursor)  # the next page: the cursor alone
+```
+
+### Image translation
+
+```python
+with open("product.jpg", "rb") as f:
+    image = f.read()
+
+translated = b"".join(
+    client.image_translate.translate(source_language="zh-CN", target_language="ko", request=image)
+)
+with open("translated.jpg", "wb") as f:
+    f.write(translated)
+```
+
+## Async
+
+`AsyncApinoa` has the same methods, awaitable:
+
+```python
+import asyncio
+from apinoa import AsyncApinoa
+
+async def main() -> None:
+    client = AsyncApinoa()
+    res = await client.youtube.profile(username="@mkbhd")
+    print(res.data.display_name)
+
+asyncio.run(main())
+```
+
+## Errors
+
+A failed call raises a subclass of `apinoa.core.ApiError` named after its status (`BadRequestError`,
+`PaymentRequiredError`, `NotFoundError`, `TooManyRequestsError`, …). `err.body.error.code` is the stable
+code to branch on; every code is listed at [apinoa.com/docs/errors](https://apinoa.com/docs/errors). A
+failed call is not billed.
+
+```python
+from apinoa import NotFoundError, PaymentRequiredError
+
+try:
+    client.amazon.product(id="B000000000")
+except NotFoundError:
+    print("no such product")
+except PaymentRequiredError:
+    print("top up your balance")
+```
+
+## Retries and timeouts
+
+`429`, `408` and `5xx` answers are retried twice with exponential backoff, honouring `Retry-After`. The
+default timeout is 300 seconds, because image translation under load can take minutes. Both can be set
+per client or per call:
+
+```python
+client = Apinoa(max_retries=4, timeout=60)
+client.tiktok.posts(username="nasa", request_options={"max_retries": 0, "timeout_in_seconds": 10})
+```
+
+## Reference
+
+Every method and parameter: [reference.md](./reference.md). The API itself:
+[apinoa.com/docs](https://apinoa.com/docs). The OpenAPI document this SDK is generated from:
+[apinoa.com/openapi.json](https://apinoa.com/openapi.json).
+
+## License
+
+MIT

apinoa-0.1.0/pyproject.toml

@@ -0,0 +1,48 @@
+[project]
+name = "apinoa"
+version = "0.1.0"
+description = "Official Python SDK for the apinoa API: marketplace, social and image-translation data through one API."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.9"
+authors = [{ name = "apinoa" }]
+keywords = ["apinoa", "amazon", "walmart", "shopify", "aliexpress", "tiktok", "reddit", "youtube", "instagram", "scraping", "api", "sdk"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Typing :: Typed",
+]
+dependencies = [
+  "httpx>=0.21.2",
+  "pydantic>=1.9.2",
+  "pydantic-core>=2.18.2; python_version >= '3.9'",
+  "typing_extensions>=4.0.0",
+]
+
+[project.urls]
+Homepage = "https://apinoa.com"
+Documentation = "https://apinoa.com/docs"
+Repository = "https://github.com/apinoahq/apinoa-python"
+Issues = "https://github.com/apinoahq/apinoa-python/issues"
+
+[dependency-groups]
+dev = ["pytest>=8", "pytest-asyncio>=0.24"]
+
+[build-system]
+requires = ["hatchling>=1.27"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/apinoa"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/apinoa", "README.md", "LICENSE", "reference.md", "tests"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "--ignore=tests/live"
+asyncio_mode = "auto"