getanyapi 0.119.7__tar.gz → 0.121.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {getanyapi-0.119.7 → getanyapi-0.121.0}/PKG-INFO +1 -1
- {getanyapi-0.119.7 → getanyapi-0.121.0}/pyproject.toml +1 -1
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/__init__.py +1 -1
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/__init__.py +3 -0
- getanyapi-0.121.0/src/getanyapi/platforms/brave.py +167 -0
- getanyapi-0.121.0/src/getanyapi/platforms/duckduckgo.py +184 -0
- getanyapi-0.121.0/src/getanyapi/platforms/levels.py +178 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/linkedin.py +13 -10
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/twitter.py +2 -2
- {getanyapi-0.119.7 → getanyapi-0.121.0}/.gitignore +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/README.md +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/_account.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/_async_client.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/_client.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/_errors.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/_idempotency.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/_pagination.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/_transport.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/discovery_types.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/ahrefs.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/airbnb.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/alibaba.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/amazon.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/apollo.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/appstore.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/bing.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/bluesky.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/booking.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/capterra.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/chatgpt.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/coinmarketcap.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/company.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/company_enrichment.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/company_identify.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/company_search.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/congress.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/contact_enrichment.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/douyin.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/ebay.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/email.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/email_finding.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/email_verification.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/facebook.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/fiverr.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/g2.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/gemini.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/github.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/glassdoor.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/google.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/google_ads.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/google_finance.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/google_hotels.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/google_shopping.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/hackernews.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/indeed.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/instagram.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/job_search.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/maps.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/mobile_phone.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/naver.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/nextdoor.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/people_search.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/perplexity.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/person.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/person_enrichment.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/pexels.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/pinterest.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/playstore.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/polymarket.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/property_records.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/realtor.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/reddit.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/redfin.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/rednote.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/sec.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/semrush.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/seo.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/similarweb.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/snapchat.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/social.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/spotify.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/substack.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/technographics.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/threads.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/tiktok.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/tiktok_shop.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/tripadvisor.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/trustpilot.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/truthsocial.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/unsplash.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/upwork.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/walmart.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/web.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/weibo.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/yahoo_finance.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/yelp.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/youtube.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/zhihu.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/platforms/zillow.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/py.typed +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/src/getanyapi/types.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/tests/conftest.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/tests/test_account.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/tests/test_client.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/tests/test_durable_requests.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/tests/test_envelope.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/tests/test_errors.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/tests/test_fixture_roundtrip.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/tests/test_fixture_sweep.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/tests/test_not_found_reason.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/tests/test_pagination.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/tests/test_transport.py +0 -0
- {getanyapi-0.119.7 → getanyapi-0.121.0}/uv.lock +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.5
|
|
2
2
|
Name: getanyapi
|
|
3
|
-
Version: 0.
|
|
3
|
+
Version: 0.121.0
|
|
4
4
|
Summary: Official typed Python SDK for AnyAPI: any API, one wallet, USD, no subscriptions.
|
|
5
5
|
Project-URL: Homepage, https://getanyapi.com
|
|
6
6
|
Project-URL: Documentation, https://getanyapi.com/docs
|
|
@@ -18,6 +18,7 @@ REGISTRY: dict[str, tuple[str, str, str]] = {
|
|
|
18
18
|
"bing": ("bing", "BingNamespace", "AsyncBingNamespace"),
|
|
19
19
|
"bluesky": ("bluesky", "BlueskyNamespace", "AsyncBlueskyNamespace"),
|
|
20
20
|
"booking": ("booking", "BookingNamespace", "AsyncBookingNamespace"),
|
|
21
|
+
"brave": ("brave", "BraveNamespace", "AsyncBraveNamespace"),
|
|
21
22
|
"capterra": ("capterra", "CapterraNamespace", "AsyncCapterraNamespace"),
|
|
22
23
|
"chatgpt": ("chatgpt", "ChatgptNamespace", "AsyncChatgptNamespace"),
|
|
23
24
|
"coinmarketcap": (
|
|
@@ -48,6 +49,7 @@ REGISTRY: dict[str, tuple[str, str, str]] = {
|
|
|
48
49
|
"AsyncContactEnrichmentNamespace",
|
|
49
50
|
),
|
|
50
51
|
"douyin": ("douyin", "DouyinNamespace", "AsyncDouyinNamespace"),
|
|
52
|
+
"duckduckgo": ("duckduckgo", "DuckduckgoNamespace", "AsyncDuckduckgoNamespace"),
|
|
51
53
|
"ebay": ("ebay", "EbayNamespace", "AsyncEbayNamespace"),
|
|
52
54
|
"email": ("email", "EmailNamespace", "AsyncEmailNamespace"),
|
|
53
55
|
"email_finding": (
|
|
@@ -87,6 +89,7 @@ REGISTRY: dict[str, tuple[str, str, str]] = {
|
|
|
87
89
|
"indeed": ("indeed", "IndeedNamespace", "AsyncIndeedNamespace"),
|
|
88
90
|
"instagram": ("instagram", "InstagramNamespace", "AsyncInstagramNamespace"),
|
|
89
91
|
"job_search": ("job_search", "JobSearchNamespace", "AsyncJobSearchNamespace"),
|
|
92
|
+
"levels": ("levels", "LevelsNamespace", "AsyncLevelsNamespace"),
|
|
90
93
|
"linkedin": ("linkedin", "LinkedinNamespace", "AsyncLinkedinNamespace"),
|
|
91
94
|
"maps": ("maps", "MapsNamespace", "AsyncMapsNamespace"),
|
|
92
95
|
"mobile_phone": (
|
|
@@ -0,0 +1,167 @@
|
|
|
1
|
+
# Generated - do not edit. Regenerate with: pnpm generate
|
|
2
|
+
"""Generated namespace module for the brave platform."""
|
|
3
|
+
|
|
4
|
+
from __future__ import annotations
|
|
5
|
+
|
|
6
|
+
from typing import Literal, TYPE_CHECKING
|
|
7
|
+
|
|
8
|
+
from pydantic import BaseModel, ConfigDict, Field
|
|
9
|
+
from typing_extensions import NotRequired, Required, TypedDict, Unpack
|
|
10
|
+
|
|
11
|
+
from ..types import RequestOptions, RunResult
|
|
12
|
+
|
|
13
|
+
if TYPE_CHECKING:
|
|
14
|
+
from .._async_client import AsyncAnyAPI
|
|
15
|
+
from .._client import AnyAPI
|
|
16
|
+
|
|
17
|
+
|
|
18
|
+
class BraveSearchInput(TypedDict, total=False):
|
|
19
|
+
"""Input for Brave Search."""
|
|
20
|
+
|
|
21
|
+
allowFallbacks: NotRequired[bool]
|
|
22
|
+
"""Optional, default true. When false, only the sources listed in `source` may serve; the request is refused with no charge if none of them can. When true, the listed sources are tried first and any other source may serve after them, at the normal price. Default: true."""
|
|
23
|
+
country: NotRequired[
|
|
24
|
+
Literal[
|
|
25
|
+
"AR",
|
|
26
|
+
"AU",
|
|
27
|
+
"AT",
|
|
28
|
+
"BE",
|
|
29
|
+
"BR",
|
|
30
|
+
"CA",
|
|
31
|
+
"CL",
|
|
32
|
+
"CN",
|
|
33
|
+
"DK",
|
|
34
|
+
"FI",
|
|
35
|
+
"FR",
|
|
36
|
+
"DE",
|
|
37
|
+
"GR",
|
|
38
|
+
"HK",
|
|
39
|
+
"IN",
|
|
40
|
+
"ID",
|
|
41
|
+
"IT",
|
|
42
|
+
"JP",
|
|
43
|
+
"KR",
|
|
44
|
+
"MY",
|
|
45
|
+
"MX",
|
|
46
|
+
"NL",
|
|
47
|
+
"NZ",
|
|
48
|
+
"NO",
|
|
49
|
+
"PL",
|
|
50
|
+
"PT",
|
|
51
|
+
"PH",
|
|
52
|
+
"RU",
|
|
53
|
+
"SA",
|
|
54
|
+
"SG",
|
|
55
|
+
"ZA",
|
|
56
|
+
"ES",
|
|
57
|
+
"SE",
|
|
58
|
+
"CH",
|
|
59
|
+
"TW",
|
|
60
|
+
"TR",
|
|
61
|
+
"GB",
|
|
62
|
+
"US",
|
|
63
|
+
]
|
|
64
|
+
]
|
|
65
|
+
"""ISO-3166 alpha-2 country Brave searches from, e.g. US, GB, DE. Brave ranks and localizes results for that country. Only the countries Brave offers are accepted; US is served by every source and the others by the sources that can target them. Default: US."""
|
|
66
|
+
ignoreSources: NotRequired[list[str]]
|
|
67
|
+
"""Optional. Source ids to skip for this request, taken from this endpoint's `lanes[].source.id`. The cheapest remaining source serves and the price is that of the dearest remaining source. An id that does not serve this endpoint, or that is also in `source`, is rejected as invalid input with no charge; skipping every source is rejected the same way."""
|
|
68
|
+
limit: NotRequired[int]
|
|
69
|
+
"""Maximum number of organic results to return (1-20, default 20). Brave serves about 20 organic results per page, and some queries carry fewer. Range: 1 to 20. Default: 20."""
|
|
70
|
+
preferLatencyUnderMs: NotRequired[int]
|
|
71
|
+
"""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."""
|
|
72
|
+
query: Required[str]
|
|
73
|
+
"""The Brave search query."""
|
|
74
|
+
source: NotRequired[list[str]]
|
|
75
|
+
"""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`."""
|
|
76
|
+
|
|
77
|
+
|
|
78
|
+
class BraveSearchData(BaseModel):
|
|
79
|
+
items: list[BraveSearchItem] = Field(
|
|
80
|
+
description="Organic results in Brave's ranked order. Ads are not included. Populated whenever the provider has data for the entity."
|
|
81
|
+
)
|
|
82
|
+
query: str = Field(description="The query Brave searched.")
|
|
83
|
+
|
|
84
|
+
|
|
85
|
+
class BraveSearchItem(BaseModel):
|
|
86
|
+
model_config = ConfigDict(extra="allow", populate_by_name=True)
|
|
87
|
+
|
|
88
|
+
display_url: str | None = Field(
|
|
89
|
+
alias="displayUrl",
|
|
90
|
+
description="The URL as Brave displays it under the title, e.g. a host or a breadcrumb path. Its format differs by source. null when the source did not send one.",
|
|
91
|
+
)
|
|
92
|
+
domain: str | None = Field(
|
|
93
|
+
description="Host of the result URL without a leading www., e.g. runnersworld.com."
|
|
94
|
+
)
|
|
95
|
+
position: int = Field(
|
|
96
|
+
description="1-based rank of the result on the page. Populated whenever the provider has data for the entity."
|
|
97
|
+
)
|
|
98
|
+
snippet: str | None = Field(
|
|
99
|
+
default=None,
|
|
100
|
+
description="Text excerpt Brave shows under the result, often led by the page date. Absent on the results where Brave shows none. Populated whenever the provider has data for the entity. Present whenever the upstream returns this record.",
|
|
101
|
+
)
|
|
102
|
+
title: str = Field(
|
|
103
|
+
description="Result title as Brave shows it. Populated whenever the provider has data for the entity."
|
|
104
|
+
)
|
|
105
|
+
url: str = Field(
|
|
106
|
+
description="Destination URL of the result. Populated whenever the provider has data for the entity."
|
|
107
|
+
)
|
|
108
|
+
|
|
109
|
+
|
|
110
|
+
class BraveNamespace:
|
|
111
|
+
"""Typed methods for this platform. Attached lazily to the client."""
|
|
112
|
+
|
|
113
|
+
def __init__(self, client: "AnyAPI") -> None:
|
|
114
|
+
self._client = client
|
|
115
|
+
|
|
116
|
+
def search(
|
|
117
|
+
self,
|
|
118
|
+
*,
|
|
119
|
+
options: RequestOptions | None = None,
|
|
120
|
+
**input: Unpack[BraveSearchInput],
|
|
121
|
+
) -> RunResult[BraveSearchData]:
|
|
122
|
+
"""Brave Search
|
|
123
|
+
|
|
124
|
+
Run a Brave web search and get the ranked organic results (title, URL,
|
|
125
|
+
snippet, position, display URL, domain) as clean JSON. Brave answers from
|
|
126
|
+
its own independent index. Returns up to 20 results per call; pick the
|
|
127
|
+
country Brave searches from.
|
|
128
|
+
|
|
129
|
+
Price: $0.00085 per request.
|
|
130
|
+
|
|
131
|
+
Example:
|
|
132
|
+
res = client.brave.search(country="US", limit=20, query="best running shoes")
|
|
133
|
+
"""
|
|
134
|
+
raw = self._client._run_raw( # pyright: ignore[reportPrivateUsage]
|
|
135
|
+
"brave.search", dict(input), options
|
|
136
|
+
)
|
|
137
|
+
return RunResult[BraveSearchData].model_validate(raw)
|
|
138
|
+
|
|
139
|
+
|
|
140
|
+
class AsyncBraveNamespace:
|
|
141
|
+
"""Typed methods for this platform. Attached lazily to the client."""
|
|
142
|
+
|
|
143
|
+
def __init__(self, client: "AsyncAnyAPI") -> None:
|
|
144
|
+
self._client = client
|
|
145
|
+
|
|
146
|
+
async def search(
|
|
147
|
+
self,
|
|
148
|
+
*,
|
|
149
|
+
options: RequestOptions | None = None,
|
|
150
|
+
**input: Unpack[BraveSearchInput],
|
|
151
|
+
) -> RunResult[BraveSearchData]:
|
|
152
|
+
"""Brave Search
|
|
153
|
+
|
|
154
|
+
Run a Brave web search and get the ranked organic results (title, URL,
|
|
155
|
+
snippet, position, display URL, domain) as clean JSON. Brave answers from
|
|
156
|
+
its own independent index. Returns up to 20 results per call; pick the
|
|
157
|
+
country Brave searches from.
|
|
158
|
+
|
|
159
|
+
Price: $0.00085 per request.
|
|
160
|
+
|
|
161
|
+
Example:
|
|
162
|
+
res = client.brave.search(country="US", limit=20, query="best running shoes")
|
|
163
|
+
"""
|
|
164
|
+
raw = await self._client._arun_raw( # pyright: ignore[reportPrivateUsage]
|
|
165
|
+
"brave.search", dict(input), options
|
|
166
|
+
)
|
|
167
|
+
return RunResult[BraveSearchData].model_validate(raw)
|
|
@@ -0,0 +1,184 @@
|
|
|
1
|
+
# Generated - do not edit. Regenerate with: pnpm generate
|
|
2
|
+
"""Generated namespace module for the duckduckgo platform."""
|
|
3
|
+
|
|
4
|
+
from __future__ import annotations
|
|
5
|
+
|
|
6
|
+
from typing import Literal, TYPE_CHECKING
|
|
7
|
+
|
|
8
|
+
from pydantic import BaseModel, ConfigDict, Field
|
|
9
|
+
from typing_extensions import NotRequired, Required, TypedDict, Unpack
|
|
10
|
+
|
|
11
|
+
from ..types import RequestOptions, RunResult
|
|
12
|
+
|
|
13
|
+
if TYPE_CHECKING:
|
|
14
|
+
from .._async_client import AsyncAnyAPI
|
|
15
|
+
from .._client import AnyAPI
|
|
16
|
+
|
|
17
|
+
|
|
18
|
+
class DuckduckgoSearchInput(TypedDict, total=False):
|
|
19
|
+
"""Input for DuckDuckGo Search."""
|
|
20
|
+
|
|
21
|
+
allowFallbacks: NotRequired[bool]
|
|
22
|
+
"""Optional, default true. When false, only the sources listed in `source` may serve; the request is refused with no charge if none of them can. When true, the listed sources are tried first and any other source may serve after them, at the normal price. Default: true."""
|
|
23
|
+
country: NotRequired[
|
|
24
|
+
Literal[
|
|
25
|
+
"AR",
|
|
26
|
+
"AU",
|
|
27
|
+
"AT",
|
|
28
|
+
"BE",
|
|
29
|
+
"BR",
|
|
30
|
+
"BG",
|
|
31
|
+
"CA",
|
|
32
|
+
"CL",
|
|
33
|
+
"CN",
|
|
34
|
+
"CO",
|
|
35
|
+
"HR",
|
|
36
|
+
"CZ",
|
|
37
|
+
"DK",
|
|
38
|
+
"EE",
|
|
39
|
+
"FI",
|
|
40
|
+
"FR",
|
|
41
|
+
"DE",
|
|
42
|
+
"GR",
|
|
43
|
+
"HK",
|
|
44
|
+
"HU",
|
|
45
|
+
"IS",
|
|
46
|
+
"IN",
|
|
47
|
+
"ID",
|
|
48
|
+
"IE",
|
|
49
|
+
"IL",
|
|
50
|
+
"IT",
|
|
51
|
+
"JP",
|
|
52
|
+
"KR",
|
|
53
|
+
"LV",
|
|
54
|
+
"LT",
|
|
55
|
+
"MY",
|
|
56
|
+
"MX",
|
|
57
|
+
"NL",
|
|
58
|
+
"NZ",
|
|
59
|
+
"NO",
|
|
60
|
+
"PK",
|
|
61
|
+
"PE",
|
|
62
|
+
"PH",
|
|
63
|
+
"PL",
|
|
64
|
+
"PT",
|
|
65
|
+
"RO",
|
|
66
|
+
"RU",
|
|
67
|
+
"SA",
|
|
68
|
+
"SG",
|
|
69
|
+
"SK",
|
|
70
|
+
"SI",
|
|
71
|
+
"ZA",
|
|
72
|
+
"ES",
|
|
73
|
+
"SE",
|
|
74
|
+
"CH",
|
|
75
|
+
"TW",
|
|
76
|
+
"TH",
|
|
77
|
+
"TR",
|
|
78
|
+
"US",
|
|
79
|
+
"UA",
|
|
80
|
+
"GB",
|
|
81
|
+
"VN",
|
|
82
|
+
]
|
|
83
|
+
]
|
|
84
|
+
"""ISO-3166 alpha-2 country DuckDuckGo searches from, e.g. US, GB, DE: DuckDuckGo's region for that country in its main language (Belgium in Dutch, Canada and the US in English, Switzerland in German, Spain in Spanish). Only the countries DuckDuckGo offers are accepted; every country is served by most sources and US, GB and DE by all of them. Default: US."""
|
|
85
|
+
ignoreSources: NotRequired[list[str]]
|
|
86
|
+
"""Optional. Source ids to skip for this request, taken from this endpoint's `lanes[].source.id`. The cheapest remaining source serves and the price is that of the dearest remaining source. An id that does not serve this endpoint, or that is also in `source`, is rejected as invalid input with no charge; skipping every source is rejected the same way."""
|
|
87
|
+
limit: NotRequired[int]
|
|
88
|
+
"""Maximum number of organic results to return (1-10, default 10). DuckDuckGo serves about 10 organic results per page, and some queries carry fewer. Range: 1 to 10. Default: 10."""
|
|
89
|
+
preferLatencyUnderMs: NotRequired[int]
|
|
90
|
+
"""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."""
|
|
91
|
+
query: Required[str]
|
|
92
|
+
"""The DuckDuckGo search query."""
|
|
93
|
+
source: NotRequired[list[str]]
|
|
94
|
+
"""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`."""
|
|
95
|
+
|
|
96
|
+
|
|
97
|
+
class DuckduckgoSearchData(BaseModel):
|
|
98
|
+
items: list[DuckduckgoSearchItem] = Field(
|
|
99
|
+
description="Organic results in DuckDuckGo's ranked order. Ads are not included. Populated whenever the provider has data for the entity."
|
|
100
|
+
)
|
|
101
|
+
query: str = Field(description="The query DuckDuckGo searched.")
|
|
102
|
+
|
|
103
|
+
|
|
104
|
+
class DuckduckgoSearchItem(BaseModel):
|
|
105
|
+
model_config = ConfigDict(extra="allow", populate_by_name=True)
|
|
106
|
+
|
|
107
|
+
display_url: str | None = Field(
|
|
108
|
+
alias="displayUrl",
|
|
109
|
+
description="The URL as DuckDuckGo displays it under the title, e.g. a host or a host and path. Its format differs by source. null when the source did not send one.",
|
|
110
|
+
)
|
|
111
|
+
domain: str | None = Field(
|
|
112
|
+
description="Host of the result URL without a leading www., e.g. runnersworld.com."
|
|
113
|
+
)
|
|
114
|
+
position: int = Field(
|
|
115
|
+
description="1-based rank of the result on the page. Populated whenever the provider has data for the entity."
|
|
116
|
+
)
|
|
117
|
+
snippet: str | None = Field(
|
|
118
|
+
default=None,
|
|
119
|
+
description="Text excerpt DuckDuckGo shows under the result. Populated whenever the provider has data for the entity. Present whenever the upstream returns this record.",
|
|
120
|
+
)
|
|
121
|
+
title: str = Field(
|
|
122
|
+
description="Result title as DuckDuckGo shows it. Populated whenever the provider has data for the entity."
|
|
123
|
+
)
|
|
124
|
+
url: str = Field(
|
|
125
|
+
description="Destination URL of the result. Populated whenever the provider has data for the entity."
|
|
126
|
+
)
|
|
127
|
+
|
|
128
|
+
|
|
129
|
+
class DuckduckgoNamespace:
|
|
130
|
+
"""Typed methods for this platform. Attached lazily to the client."""
|
|
131
|
+
|
|
132
|
+
def __init__(self, client: "AnyAPI") -> None:
|
|
133
|
+
self._client = client
|
|
134
|
+
|
|
135
|
+
def search(
|
|
136
|
+
self,
|
|
137
|
+
*,
|
|
138
|
+
options: RequestOptions | None = None,
|
|
139
|
+
**input: Unpack[DuckduckgoSearchInput],
|
|
140
|
+
) -> RunResult[DuckduckgoSearchData]:
|
|
141
|
+
"""DuckDuckGo Search
|
|
142
|
+
|
|
143
|
+
Run a DuckDuckGo web search and get the ranked organic results (title, URL,
|
|
144
|
+
snippet, position, display URL, domain) as clean JSON, ads left out. Returns
|
|
145
|
+
up to 10 results per call; pick the country DuckDuckGo searches from.
|
|
146
|
+
|
|
147
|
+
Price: $0.00085 per request.
|
|
148
|
+
|
|
149
|
+
Example:
|
|
150
|
+
res = client.duckduckgo.search(country="US", limit=10, query="best running shoes")
|
|
151
|
+
"""
|
|
152
|
+
raw = self._client._run_raw( # pyright: ignore[reportPrivateUsage]
|
|
153
|
+
"duckduckgo.search", dict(input), options
|
|
154
|
+
)
|
|
155
|
+
return RunResult[DuckduckgoSearchData].model_validate(raw)
|
|
156
|
+
|
|
157
|
+
|
|
158
|
+
class AsyncDuckduckgoNamespace:
|
|
159
|
+
"""Typed methods for this platform. Attached lazily to the client."""
|
|
160
|
+
|
|
161
|
+
def __init__(self, client: "AsyncAnyAPI") -> None:
|
|
162
|
+
self._client = client
|
|
163
|
+
|
|
164
|
+
async def search(
|
|
165
|
+
self,
|
|
166
|
+
*,
|
|
167
|
+
options: RequestOptions | None = None,
|
|
168
|
+
**input: Unpack[DuckduckgoSearchInput],
|
|
169
|
+
) -> RunResult[DuckduckgoSearchData]:
|
|
170
|
+
"""DuckDuckGo Search
|
|
171
|
+
|
|
172
|
+
Run a DuckDuckGo web search and get the ranked organic results (title, URL,
|
|
173
|
+
snippet, position, display URL, domain) as clean JSON, ads left out. Returns
|
|
174
|
+
up to 10 results per call; pick the country DuckDuckGo searches from.
|
|
175
|
+
|
|
176
|
+
Price: $0.00085 per request.
|
|
177
|
+
|
|
178
|
+
Example:
|
|
179
|
+
res = client.duckduckgo.search(country="US", limit=10, query="best running shoes")
|
|
180
|
+
"""
|
|
181
|
+
raw = await self._client._arun_raw( # pyright: ignore[reportPrivateUsage]
|
|
182
|
+
"duckduckgo.search", dict(input), options
|
|
183
|
+
)
|
|
184
|
+
return RunResult[DuckduckgoSearchData].model_validate(raw)
|
|
@@ -0,0 +1,178 @@
|
|
|
1
|
+
# Generated - do not edit. Regenerate with: pnpm generate
|
|
2
|
+
"""Generated namespace module for the levels platform."""
|
|
3
|
+
|
|
4
|
+
from __future__ import annotations
|
|
5
|
+
|
|
6
|
+
from typing import Literal, TYPE_CHECKING
|
|
7
|
+
|
|
8
|
+
from pydantic import BaseModel, ConfigDict, Field
|
|
9
|
+
from typing_extensions import NotRequired, Required, TypedDict, Unpack
|
|
10
|
+
|
|
11
|
+
from ..types import RequestOptions, RunResult
|
|
12
|
+
|
|
13
|
+
if TYPE_CHECKING:
|
|
14
|
+
from .._async_client import AsyncAnyAPI
|
|
15
|
+
from .._client import AnyAPI
|
|
16
|
+
|
|
17
|
+
|
|
18
|
+
class LevelsJobsInput(TypedDict, total=False):
|
|
19
|
+
"""Input for Levels.fyi Jobs."""
|
|
20
|
+
|
|
21
|
+
allowFallbacks: NotRequired[bool]
|
|
22
|
+
"""Optional, default true. When false, only the sources listed in `source` may serve; the request is refused with no charge if none of them can. When true, the listed sources are tried first and any other source may serve after them, at the normal price. Default: true."""
|
|
23
|
+
ignoreSources: NotRequired[list[str]]
|
|
24
|
+
"""Optional. Source ids to skip for this request, taken from this endpoint's `lanes[].source.id`. The cheapest remaining source serves and the price is that of the dearest remaining source. An id that does not serve this endpoint, or that is also in `source`, is rejected as invalid input with no charge; skipping every source is rejected the same way."""
|
|
25
|
+
limit: NotRequired[int]
|
|
26
|
+
"""Maximum number of jobs to return (1-20, default 20). Levels.fyi groups jobs by company, up to 3 per company, so several results can come from one employer. Range: 1 to 20. Default: 20."""
|
|
27
|
+
location: NotRequired[str]
|
|
28
|
+
"""Levels.fyi location slug as it appears in Levels.fyi URLs, e.g. united-states. Not a free-text city name; omit it to search everywhere."""
|
|
29
|
+
preferLatencyUnderMs: NotRequired[int]
|
|
30
|
+
"""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."""
|
|
31
|
+
query: Required[str]
|
|
32
|
+
"""Job title, keywords or company name to search, e.g. software engineer or google."""
|
|
33
|
+
sortBy: NotRequired[Literal["relevance", "date", "compensation"]]
|
|
34
|
+
"""Sort order: best match (relevance), most recently posted (date), or highest total compensation (compensation). Default: relevance."""
|
|
35
|
+
source: NotRequired[list[str]]
|
|
36
|
+
"""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`."""
|
|
37
|
+
|
|
38
|
+
|
|
39
|
+
class LevelsJobsData(BaseModel):
|
|
40
|
+
items: list[LevelsJobsItem] = Field(
|
|
41
|
+
description="Jobs in Levels.fyi's order, grouped by company. Populated whenever the provider has data for the entity."
|
|
42
|
+
)
|
|
43
|
+
|
|
44
|
+
|
|
45
|
+
class LevelsJobsItem(BaseModel):
|
|
46
|
+
model_config = ConfigDict(extra="allow", populate_by_name=True)
|
|
47
|
+
|
|
48
|
+
apply_url: str | None = Field(
|
|
49
|
+
default=None,
|
|
50
|
+
alias="applyUrl",
|
|
51
|
+
description="URL that starts the application, usually the employer's own careers page or a job board.",
|
|
52
|
+
)
|
|
53
|
+
company: str | None = Field(
|
|
54
|
+
default=None,
|
|
55
|
+
description="Hiring company name. Populated whenever the provider has data for the entity. Present whenever the upstream returns this record.",
|
|
56
|
+
)
|
|
57
|
+
company_slug: str | None = Field(
|
|
58
|
+
default=None,
|
|
59
|
+
alias="companySlug",
|
|
60
|
+
description="Levels.fyi company slug, e.g. google; null when the source did not send one.",
|
|
61
|
+
)
|
|
62
|
+
created_utc: float | None = Field(
|
|
63
|
+
default=None,
|
|
64
|
+
alias="createdUtc",
|
|
65
|
+
description="When the job was posted. UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. Populated whenever the provider has data for the entity. Present whenever the upstream returns this record.",
|
|
66
|
+
)
|
|
67
|
+
is_sponsored: bool | None = Field(
|
|
68
|
+
default=None,
|
|
69
|
+
alias="isSponsored",
|
|
70
|
+
description="Whether the listing is a paid placement on Levels.fyi.",
|
|
71
|
+
)
|
|
72
|
+
job_id: str = Field(
|
|
73
|
+
alias="jobId",
|
|
74
|
+
description="Levels.fyi job id. Populated whenever the provider has data for the entity.",
|
|
75
|
+
)
|
|
76
|
+
location: str | None = Field(
|
|
77
|
+
default=None,
|
|
78
|
+
description="Job location as Levels.fyi shows it, e.g. San Jose, CA. Populated whenever the provider has data for the entity. Present whenever the upstream returns this record.",
|
|
79
|
+
)
|
|
80
|
+
logo_url: str | None = Field(
|
|
81
|
+
default=None, alias="logoUrl", description="Company logo image URL."
|
|
82
|
+
)
|
|
83
|
+
remote: bool | None = Field(
|
|
84
|
+
default=None,
|
|
85
|
+
description="Whether Levels.fyi marks the job as remote; null when it does not say.",
|
|
86
|
+
)
|
|
87
|
+
salary_currency: str | None = Field(
|
|
88
|
+
default=None,
|
|
89
|
+
alias="salaryCurrency",
|
|
90
|
+
description="ISO 4217 currency of the salary and compensation figures, e.g. USD.",
|
|
91
|
+
)
|
|
92
|
+
salary_max: float | None = Field(
|
|
93
|
+
default=None,
|
|
94
|
+
alias="salaryMax",
|
|
95
|
+
description="High end of the base salary range in salaryCurrency per salaryUnit. null when Levels.fyi shows no salary for the job. Populated whenever the provider has data for the entity. Present whenever the upstream returns this record.",
|
|
96
|
+
)
|
|
97
|
+
salary_min: float | None = Field(
|
|
98
|
+
default=None,
|
|
99
|
+
alias="salaryMin",
|
|
100
|
+
description="Low end of the base salary range in salaryCurrency per salaryUnit. null when Levels.fyi shows no salary for the job. Populated whenever the provider has data for the entity. Present whenever the upstream returns this record.",
|
|
101
|
+
)
|
|
102
|
+
salary_unit: str | None = Field(
|
|
103
|
+
default=None,
|
|
104
|
+
alias="salaryUnit",
|
|
105
|
+
description="Pay period of the salary and compensation figures, e.g. YEAR.",
|
|
106
|
+
)
|
|
107
|
+
title: str = Field(
|
|
108
|
+
description="Job title. Populated whenever the provider has data for the entity."
|
|
109
|
+
)
|
|
110
|
+
total_compensation_max: float | None = Field(
|
|
111
|
+
default=None,
|
|
112
|
+
alias="totalCompensationMax",
|
|
113
|
+
description="High end of the total compensation range (base, stock and bonus). Some ranges are Levels.fyi estimates. null when Levels.fyi shows none.",
|
|
114
|
+
)
|
|
115
|
+
total_compensation_min: float | None = Field(
|
|
116
|
+
default=None,
|
|
117
|
+
alias="totalCompensationMin",
|
|
118
|
+
description="Low end of the total compensation range (base, stock and bonus). Some ranges are Levels.fyi estimates. null when Levels.fyi shows none.",
|
|
119
|
+
)
|
|
120
|
+
url: str = Field(
|
|
121
|
+
description="Levels.fyi job listing URL. Populated whenever the provider has data for the entity."
|
|
122
|
+
)
|
|
123
|
+
|
|
124
|
+
|
|
125
|
+
class LevelsNamespace:
|
|
126
|
+
"""Typed methods for this platform. Attached lazily to the client."""
|
|
127
|
+
|
|
128
|
+
def __init__(self, client: "AnyAPI") -> None:
|
|
129
|
+
self._client = client
|
|
130
|
+
|
|
131
|
+
def jobs(
|
|
132
|
+
self, *, options: RequestOptions | None = None, **input: Unpack[LevelsJobsInput]
|
|
133
|
+
) -> RunResult[LevelsJobsData]:
|
|
134
|
+
"""Levels.fyi Jobs
|
|
135
|
+
|
|
136
|
+
Search Levels.fyi job listings by title or keyword and get each job with its
|
|
137
|
+
salary range and estimated total compensation where Levels.fyi has them,
|
|
138
|
+
plus company, location, posting date and apply link. Returns up to 20 jobs
|
|
139
|
+
per call, grouped by company; filter by location and sort by relevance, date
|
|
140
|
+
or pay.
|
|
141
|
+
|
|
142
|
+
Price: $0.00085 per request.
|
|
143
|
+
|
|
144
|
+
Example:
|
|
145
|
+
res = client.levels.jobs(limit=10, location="united-states", query="software engineer")
|
|
146
|
+
"""
|
|
147
|
+
raw = self._client._run_raw( # pyright: ignore[reportPrivateUsage]
|
|
148
|
+
"levels.jobs", dict(input), options
|
|
149
|
+
)
|
|
150
|
+
return RunResult[LevelsJobsData].model_validate(raw)
|
|
151
|
+
|
|
152
|
+
|
|
153
|
+
class AsyncLevelsNamespace:
|
|
154
|
+
"""Typed methods for this platform. Attached lazily to the client."""
|
|
155
|
+
|
|
156
|
+
def __init__(self, client: "AsyncAnyAPI") -> None:
|
|
157
|
+
self._client = client
|
|
158
|
+
|
|
159
|
+
async def jobs(
|
|
160
|
+
self, *, options: RequestOptions | None = None, **input: Unpack[LevelsJobsInput]
|
|
161
|
+
) -> RunResult[LevelsJobsData]:
|
|
162
|
+
"""Levels.fyi Jobs
|
|
163
|
+
|
|
164
|
+
Search Levels.fyi job listings by title or keyword and get each job with its
|
|
165
|
+
salary range and estimated total compensation where Levels.fyi has them,
|
|
166
|
+
plus company, location, posting date and apply link. Returns up to 20 jobs
|
|
167
|
+
per call, grouped by company; filter by location and sort by relevance, date
|
|
168
|
+
or pay.
|
|
169
|
+
|
|
170
|
+
Price: $0.00085 per request.
|
|
171
|
+
|
|
172
|
+
Example:
|
|
173
|
+
res = client.levels.jobs(limit=10, location="united-states", query="software engineer")
|
|
174
|
+
"""
|
|
175
|
+
raw = await self._client._arun_raw( # pyright: ignore[reportPrivateUsage]
|
|
176
|
+
"levels.jobs", dict(input), options
|
|
177
|
+
)
|
|
178
|
+
return RunResult[LevelsJobsData].model_validate(raw)
|
|
@@ -448,6 +448,8 @@ class LinkedinProfileCommentsInput(TypedDict, total=False):
|
|
|
448
448
|
"""Only return comments posted within this window (default any)."""
|
|
449
449
|
preferLatencyUnderMs: NotRequired[int]
|
|
450
450
|
"""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."""
|
|
451
|
+
requireFields: NotRequired[list[Literal["edited", "isAuthor"]]]
|
|
452
|
+
"""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 `edited` or `isAuthor`, 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 comment that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge."""
|
|
451
453
|
source: NotRequired[list[str]]
|
|
452
454
|
"""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`."""
|
|
453
455
|
url: Required[str]
|
|
@@ -2753,7 +2755,8 @@ class LinkedinProfileCommentsItem(BaseModel):
|
|
|
2753
2755
|
description="UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. Populated whenever the provider has data for the entity. Present whenever the upstream returns this record.",
|
|
2754
2756
|
)
|
|
2755
2757
|
edited: bool | None = Field(
|
|
2756
|
-
default=None,
|
|
2758
|
+
default=None,
|
|
2759
|
+
description="Whether the comment has been edited. Null when the serving source does not report it.",
|
|
2757
2760
|
)
|
|
2758
2761
|
engagement: LinkedinProfileCommentsEngagement | None = Field(
|
|
2759
2762
|
default=None, description="Engagement metrics for the comment."
|
|
@@ -2764,7 +2767,7 @@ class LinkedinProfileCommentsItem(BaseModel):
|
|
|
2764
2767
|
is_author: bool | None = Field(
|
|
2765
2768
|
default=None,
|
|
2766
2769
|
alias="isAuthor",
|
|
2767
|
-
description="Whether the commenter is also the author of the post.",
|
|
2770
|
+
description="Whether the commenter is also the author of the post. Null when the serving source does not report it.",
|
|
2768
2771
|
)
|
|
2769
2772
|
post: LinkedinProfileCommentsPost | None = Field(
|
|
2770
2773
|
default=None,
|
|
@@ -4596,7 +4599,7 @@ class LinkedinNamespace:
|
|
|
4596
4599
|
link, publish date, author, engagement counts with a per-reaction breakdown,
|
|
4597
4600
|
and attached media.
|
|
4598
4601
|
|
|
4599
|
-
Price: $0.
|
|
4602
|
+
Price: $0.0029 per request.
|
|
4600
4603
|
|
|
4601
4604
|
Example:
|
|
4602
4605
|
res = client.linkedin.company_posts(limit=10, url="https://www.linkedin.com/company/stripe")
|
|
@@ -4816,7 +4819,7 @@ class LinkedinNamespace:
|
|
|
4816
4819
|
List comments on a LinkedIn post - full text, commenter name/URL/job title,
|
|
4817
4820
|
timestamps, and engagement.
|
|
4818
4821
|
|
|
4819
|
-
Price: $0.
|
|
4822
|
+
Price: $0.0029 per request.
|
|
4820
4823
|
|
|
4821
4824
|
Example:
|
|
4822
4825
|
res = client.linkedin.post_comments(limit=10, url="https://www.linkedin.com/posts/stripe_philip-kl%C3%B6ckner-in-conversation-with-conor-activity-7477791740645564416-tIbZ")
|
|
@@ -4904,7 +4907,7 @@ class LinkedinNamespace:
|
|
|
4904
4907
|
comment text, its permalink and timestamp, plus the post it was left on and
|
|
4905
4908
|
that post's author and engagement.
|
|
4906
4909
|
|
|
4907
|
-
Price: $0.
|
|
4910
|
+
Price: $0.0029 per request.
|
|
4908
4911
|
|
|
4909
4912
|
Example:
|
|
4910
4913
|
res = client.linkedin.profile_comments(limit=10, url="https://www.linkedin.com/in/jeffweiner08")
|
|
@@ -5013,7 +5016,7 @@ class LinkedinNamespace:
|
|
|
5013
5016
|
List the posts a LinkedIn member has reacted to - the reaction, its
|
|
5014
5017
|
timestamp, and the full post it was made on with author and engagement.
|
|
5015
5018
|
|
|
5016
|
-
Price: $0.
|
|
5019
|
+
Price: $0.0029 per request.
|
|
5017
5020
|
|
|
5018
5021
|
Example:
|
|
5019
5022
|
res = client.linkedin.profile_reactions(limit=10, url="https://www.linkedin.com/in/williamhgates")
|
|
@@ -5410,7 +5413,7 @@ class AsyncLinkedinNamespace:
|
|
|
5410
5413
|
link, publish date, author, engagement counts with a per-reaction breakdown,
|
|
5411
5414
|
and attached media.
|
|
5412
5415
|
|
|
5413
|
-
Price: $0.
|
|
5416
|
+
Price: $0.0029 per request.
|
|
5414
5417
|
|
|
5415
5418
|
Example:
|
|
5416
5419
|
res = client.linkedin.company_posts(limit=10, url="https://www.linkedin.com/company/stripe")
|
|
@@ -5630,7 +5633,7 @@ class AsyncLinkedinNamespace:
|
|
|
5630
5633
|
List comments on a LinkedIn post - full text, commenter name/URL/job title,
|
|
5631
5634
|
timestamps, and engagement.
|
|
5632
5635
|
|
|
5633
|
-
Price: $0.
|
|
5636
|
+
Price: $0.0029 per request.
|
|
5634
5637
|
|
|
5635
5638
|
Example:
|
|
5636
5639
|
res = client.linkedin.post_comments(limit=10, url="https://www.linkedin.com/posts/stripe_philip-kl%C3%B6ckner-in-conversation-with-conor-activity-7477791740645564416-tIbZ")
|
|
@@ -5718,7 +5721,7 @@ class AsyncLinkedinNamespace:
|
|
|
5718
5721
|
comment text, its permalink and timestamp, plus the post it was left on and
|
|
5719
5722
|
that post's author and engagement.
|
|
5720
5723
|
|
|
5721
|
-
Price: $0.
|
|
5724
|
+
Price: $0.0029 per request.
|
|
5722
5725
|
|
|
5723
5726
|
Example:
|
|
5724
5727
|
res = client.linkedin.profile_comments(limit=10, url="https://www.linkedin.com/in/jeffweiner08")
|
|
@@ -5827,7 +5830,7 @@ class AsyncLinkedinNamespace:
|
|
|
5827
5830
|
List the posts a LinkedIn member has reacted to - the reaction, its
|
|
5828
5831
|
timestamp, and the full post it was made on with author and engagement.
|
|
5829
5832
|
|
|
5830
|
-
Price: $0.
|
|
5833
|
+
Price: $0.0029 per request.
|
|
5831
5834
|
|
|
5832
5835
|
Example:
|
|
5833
5836
|
res = client.linkedin.profile_reactions(limit=10, url="https://www.linkedin.com/in/williamhgates")
|
|
@@ -1794,7 +1794,7 @@ class TwitterNamespace:
|
|
|
1794
1794
|
records with follower, following, and post counts plus cursor pagination.
|
|
1795
1795
|
Use twitter.search for posts.
|
|
1796
1796
|
|
|
1797
|
-
Price: $0.
|
|
1797
|
+
Price: $0.00075 per request.
|
|
1798
1798
|
|
|
1799
1799
|
Example:
|
|
1800
1800
|
res = client.twitter.search_users(query="ai agents")
|
|
@@ -2334,7 +2334,7 @@ class AsyncTwitterNamespace:
|
|
|
2334
2334
|
records with follower, following, and post counts plus cursor pagination.
|
|
2335
2335
|
Use twitter.search for posts.
|
|
2336
2336
|
|
|
2337
|
-
Price: $0.
|
|
2337
|
+
Price: $0.00075 per request.
|
|
2338
2338
|
|
|
2339
2339
|
Example:
|
|
2340
2340
|
res = client.twitter.search_users(query="ai agents")
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|