getanyapi 0.77.1__tar.gz → 0.78.0__tar.gz

{getanyapi-0.77.1 → getanyapi-0.78.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: getanyapi
-Version: 0.77.1
+Version: 0.78.0
 Summary: Official typed Python SDK for AnyAPI: any API, one wallet, USD, no subscriptions.
 Project-URL: Homepage, https://getanyapi.com
 Project-URL: Documentation, https://getanyapi.com/docs

{getanyapi-0.77.1 → getanyapi-0.78.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "getanyapi"
-version = "0.77.1"
+version = "0.78.0"
 description = "Official typed Python SDK for AnyAPI: any API, one wallet, USD, no subscriptions."
 readme = "README.md"
 requires-python = ">=3.10"

{getanyapi-0.77.1 → getanyapi-0.78.0}/src/getanyapi/__init__.py

@@ -55,7 +55,7 @@ from .types import (
     unwrap,
 )
 
-__version__ = "0.77.1"
+__version__ = "0.78.0"
 
 __all__ = [
     # clients + top-level functions

{getanyapi-0.77.1 → getanyapi-0.78.0}/src/getanyapi/platforms/email.py

@@ -121,7 +121,7 @@ class EmailNamespace:
 
         Find a person's work email address from their name and company domain.
 
-        Price: $0.0154 per request.
+        Price: $0.0308 per request.
 
         Example:
             res = client.email.find(person={"domain": "google.com", "firstName": "Damien", "surname": "Neil"})
@@ -169,7 +169,7 @@ class AsyncEmailNamespace:
 
         Find a person's work email address from their name and company domain.
 
-        Price: $0.0154 per request.
+        Price: $0.0308 per request.
 
         Example:
             res = client.email.find(person={"domain": "google.com", "firstName": "Damien", "surname": "Neil"})

{getanyapi-0.77.1 → getanyapi-0.78.0}/src/getanyapi/platforms/google.py

@@ -788,7 +788,7 @@ class GoogleNamespace:
         further, or use google.search_100 for up to 100 ranked results in one call,
         which is cheaper past roughly 20 results.
 
-        Price: $0.0005 per request.
+        Price: $0.0004 per request.
 
         Example:
             res = client.google.search(gl="us", hl="en", limit=10, query="best coffee maker")
@@ -1053,7 +1053,7 @@ class AsyncGoogleNamespace:
         further, or use google.search_100 for up to 100 ranked results in one call,
         which is cheaper past roughly 20 results.
 
-        Price: $0.0005 per request.
+        Price: $0.0004 per request.
 
         Example:
             res = client.google.search(gl="us", hl="en", limit=10, query="best coffee maker")

{getanyapi-0.77.1 → getanyapi-0.78.0}/src/getanyapi/platforms/tiktok.py

@@ -2613,7 +2613,7 @@ class TiktokNamespace:
         Search TikTok's public Ads Library by keyword or advertiser (advertiser,
         title, audience band, run dates, library link, and video).
 
-        Price: $0.0012 per request.
+        Price: $0.0005 per request.
 
         Example:
             res = client.tiktok.ad_library_search(query="spotify")
@@ -3701,7 +3701,7 @@ class AsyncTiktokNamespace:
         Search TikTok's public Ads Library by keyword or advertiser (advertiser,
         title, audience band, run dates, library link, and video).
 
-        Price: $0.0012 per request.
+        Price: $0.0005 per request.
 
         Example:
             res = client.tiktok.ad_library_search(query="spotify")

{getanyapi-0.77.1 → getanyapi-0.78.0}/src/getanyapi/platforms/twitter.py

@@ -195,6 +195,8 @@ class TwitterSearchUsersInput(TypedDict, total=False):
     """Optional; omit it and routing is unchanged, with the cheapest source serving. Prefer sources whose typical response time (median over the trailing 30 days, as published on this endpoint's lane health) is under this many milliseconds; among those, the cheapest serves. This can raise your price: when the cheapest source misses the target, a faster and dearer one serves, and you are quoted and charged its price. If no source is that fast the request is still served, by whichever source offers the best speed for its price - it is never refused for being slow. Sources we have not timed are tried last. This is a preference, not a guarantee: the median describes past requests and is not a ceiling on this one, and it excludes any wait this request itself asks for. On a paginated walk it applies to the first page only: later pages stay with the source that page chose, at the price it was quoted. Minimum: 1."""
     query: Required[str]
     """Keyword to match against X (Twitter) handles, display names, and profile bios. This is the People tab of X search: pass a topic ('ai agents'), a name ('Elon Musk'), or a handle ('openai') and get back accounts, not posts. Use twitter.search for posts."""
+    requireFields: NotRequired[list[Literal["canDm", "listedCount", "location"]]]
+    """Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `location`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. A named field can still be absent on a profile that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge. On a paginated walk it applies to the first page only; later pages stay with the source that page chose, at the price it was quoted."""
     source: NotRequired[list[str]]
     """Optional. Source ids to prefer, in order, taken from this endpoint's `lanes[].source.id` in /catalog or /apis. Omit it and the cheapest source serves, with automatic failover. Listed sources are tried first in the order given, then the others, unless `allowFallbacks` is false. A single source with `allowFallbacks` false is served only by that source at its price, quoted and charged exactly, with no failover. The price is that of the dearest source that may serve. An id that does not serve this endpoint is rejected as invalid input with no charge; a listed source that is not serving right now is refused with no charge, so omit `source` to be served by another. On a paginated walk, later pages must include the source that served page one, or omit `source`."""
 
@@ -933,7 +935,7 @@ class TwitterSearchUsersUser(BaseModel):
     can_dm: bool | None = Field(
         default=None,
         alias="canDm",
-        description="Whether the account accepts direct messages.",
+        description="Whether the account accepts direct messages; null when the serving source does not return it. Name it in requireFields to be served by a source that does.",
     )
     cover_url: str | None = Field(
         default=None,
@@ -952,10 +954,10 @@ class TwitterSearchUsersUser(BaseModel):
     listed_count: int | None = Field(
         default=None,
         alias="listedCount",
-        description="Number of public lists the account appears on.",
+        description="Number of public lists the account appears on; null when the serving source does not return it. Name it in requireFields to be served by a source that does.",
     )
-    location: str = Field(
-        description="The account's self-reported location (may be empty)."
+    location: str | None = Field(
+        description="The account's self-reported location (may be empty); null when the serving source does not return locations. Name it in requireFields to be served by a source that does."
     )
     name: str = Field(
         description="The account's display name. Populated whenever the provider has data for the entity."

{getanyapi-0.77.1 → getanyapi-0.78.0}/src/getanyapi/platforms/youtube.py

@@ -1852,7 +1852,7 @@ class YoutubeNamespace:
         List the comments on a YouTube video or Short by URL with cursor pagination
         (text, author, likes, reply count).
 
-        Price: $0.0012 per request.
+        Price: $0.0008 per request.
 
         Example:
             res = client.youtube.video_comments(url="https://www.youtube.com/watch?v=dQw4w9WgXcQ")
@@ -2492,7 +2492,7 @@ class AsyncYoutubeNamespace:
         List the comments on a YouTube video or Short by URL with cursor pagination
         (text, author, likes, reply count).
 
-        Price: $0.0012 per request.
+        Price: $0.0008 per request.
 
         Example:
             res = client.youtube.video_comments(url="https://www.youtube.com/watch?v=dQw4w9WgXcQ")