blitz-api-py 4.3.0__tar.gz → 4.4.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.
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/CHANGELOG.md +7 -0
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/PKG-INFO +32 -3
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/README.md +31 -2
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/_exceptions.py +6 -4
- blitz_api_py-4.4.0/src/blitz_api/_version.py +1 -0
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/resources/_async/search.py +2 -1
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/resources/_sync/search.py +2 -1
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/types/__init__.py +6 -0
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/types/_models.py +3 -2
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/types/filters.py +70 -12
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/types/shared.py +3 -0
- blitz_api_py-4.3.0/src/blitz_api/_version.py +0 -1
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/.gitignore +0 -0
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/LICENSE +0 -0
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/pyproject.toml +0 -0
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/__init__.py +0 -0
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/_base_client.py +0 -0
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/_client.py +0 -0
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/_client_async.py +0 -0
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/_client_sync.py +0 -0
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/_compat.py +0 -0
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/_constants.py +0 -0
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/_pagination_async.py +0 -0
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/_pagination_base.py +0 -0
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/_pagination_sync.py +0 -0
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/_rate_limit.py +0 -0
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/_rate_limit_async.py +0 -0
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/_rate_limit_sync.py +0 -0
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/py.typed +0 -0
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/resources/__init__.py +0 -0
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/resources/_async/__init__.py +0 -0
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/resources/_async/account.py +0 -0
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/resources/_async/changelog.py +0 -0
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/resources/_async/company.py +0 -0
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/resources/_async/enrichment.py +0 -0
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/resources/_async/jobs.py +0 -0
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/resources/_async/utils.py +0 -0
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/resources/_sync/__init__.py +0 -0
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/resources/_sync/account.py +0 -0
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/resources/_sync/changelog.py +0 -0
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/resources/_sync/company.py +0 -0
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/resources/_sync/enrichment.py +0 -0
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/resources/_sync/jobs.py +0 -0
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/resources/_sync/utils.py +0 -0
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/types/account.py +0 -0
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/types/changelog.py +0 -0
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/types/company.py +0 -0
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/types/enrichment.py +0 -0
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/types/enums.py +0 -0
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/types/jobs.py +0 -0
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/types/search.py +0 -0
- {blitz_api_py-4.3.0 → blitz_api_py-4.4.0}/src/blitz_api/types/utils.py +0 -0
|
@@ -1,5 +1,12 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## [4.4.0](https://github.com/api-blitz/blitz-api-py/compare/v4.3.0...v4.4.0) (2026-11-18)
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
### Features
|
|
7
|
+
|
|
8
|
+
* add geo exclude filters, people job_description, jobs company.mx and revenue_range ([#42](https://github.com/api-blitz/blitz-api-py/issues/42)) ([bf2814f](https://github.com/api-blitz/blitz-api-py/commit/bf2814f6ce77baa2b13f5aa3364a6912994139a3))
|
|
9
|
+
|
|
3
10
|
## [4.3.0](https://github.com/api-blitz/blitz-api-py/compare/v4.2.0...v4.3.0) (2026-11-18)
|
|
4
11
|
|
|
5
12
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.5
|
|
2
2
|
Name: blitz-api-py
|
|
3
|
-
Version: 4.
|
|
3
|
+
Version: 4.4.0
|
|
4
4
|
Summary: Typed Python SDK for the Blitz API — B2B data, search, and enrichment.
|
|
5
5
|
Project-URL: Homepage, https://blitz-api.ai
|
|
6
6
|
Project-URL: Documentation, https://docs.blitz-api.ai
|
|
@@ -280,6 +280,34 @@ Where the flags go depends on the route, and the API rejects a flag in the wrong
|
|
|
280
280
|
| `search.employee_finder` | top-level argument | — |
|
|
281
281
|
| `enrichment.company_distribution_by_country` / `_by_department` | top-level argument | — |
|
|
282
282
|
|
|
283
|
+
### Countries, continents and sales regions
|
|
284
|
+
|
|
285
|
+
`country_code`, `continent` and `sales_region` take `include` and `exclude` lists in
|
|
286
|
+
`people["location"]`, in `company["hq"]` and in the `location` of a waterfall tier. `exclude`
|
|
287
|
+
never drops a record with no value on file, and a plain list is still accepted and read as
|
|
288
|
+
`include`. A country code has two letters, in any letter case, and `UK` is read as `GB`. A
|
|
289
|
+
value of any other length is a `422`, except `WORLD` in the codes to keep, which means every
|
|
290
|
+
country.
|
|
291
|
+
|
|
292
|
+
```python
|
|
293
|
+
# People in Europe, outside France and Germany, whose job description mentions outbound.
|
|
294
|
+
page = client.search.people(
|
|
295
|
+
company={"hq": {"sales_region": {"exclude": ["APAC"]}}},
|
|
296
|
+
people={
|
|
297
|
+
"job_description": {"include": ["outbound prospecting"], "exclude": ["internship"]},
|
|
298
|
+
"location": {
|
|
299
|
+
"continent": {"include": ["Europe"]},
|
|
300
|
+
"country_code": {"exclude": ["FR", "DE"]},
|
|
301
|
+
},
|
|
302
|
+
},
|
|
303
|
+
)
|
|
304
|
+
```
|
|
305
|
+
|
|
306
|
+
`people["job_description"]` on `search.people` and `company.tam_by_people` matches phrases
|
|
307
|
+
against the description of the job (`include` up to 50 phrases, `exclude` up to 20), and
|
|
308
|
+
`company["mx"]` also filters `jobs.search` and `company.tam_by_jobs`. Each company carries
|
|
309
|
+
`revenue_range`, the label of its yearly revenue band (`None` when the band is unknown).
|
|
310
|
+
|
|
283
311
|
`search.employee_finder` also takes `job_title` and `job_description`, each a dict with
|
|
284
312
|
`include` and `exclude` lists of phrases. They are matched against the person's current job
|
|
285
313
|
at the company, the same job as `job_level`, `job_function` and `is_recent_hire`. Wrap a
|
|
@@ -384,8 +412,9 @@ for page in client.search.people(people={"job_level": ["VP"]}).iter_pages(max_pa
|
|
|
384
412
|
print(page.fair_usage.records_used if page.fair_usage else None)
|
|
385
413
|
```
|
|
386
414
|
|
|
387
|
-
|
|
388
|
-
|
|
415
|
+
Every `APIStatusError` carries the block of the error body in `err.fair_usage` (`None`
|
|
416
|
+
when the body has none). On an error only `request_id` and `records_used` are always set.
|
|
417
|
+
On an `InsufficientRecordsError` (`402`) it also says when the balance resets:
|
|
389
418
|
|
|
390
419
|
```python
|
|
391
420
|
except InsufficientRecordsError as err:
|
|
@@ -249,6 +249,34 @@ Where the flags go depends on the route, and the API rejects a flag in the wrong
|
|
|
249
249
|
| `search.employee_finder` | top-level argument | — |
|
|
250
250
|
| `enrichment.company_distribution_by_country` / `_by_department` | top-level argument | — |
|
|
251
251
|
|
|
252
|
+
### Countries, continents and sales regions
|
|
253
|
+
|
|
254
|
+
`country_code`, `continent` and `sales_region` take `include` and `exclude` lists in
|
|
255
|
+
`people["location"]`, in `company["hq"]` and in the `location` of a waterfall tier. `exclude`
|
|
256
|
+
never drops a record with no value on file, and a plain list is still accepted and read as
|
|
257
|
+
`include`. A country code has two letters, in any letter case, and `UK` is read as `GB`. A
|
|
258
|
+
value of any other length is a `422`, except `WORLD` in the codes to keep, which means every
|
|
259
|
+
country.
|
|
260
|
+
|
|
261
|
+
```python
|
|
262
|
+
# People in Europe, outside France and Germany, whose job description mentions outbound.
|
|
263
|
+
page = client.search.people(
|
|
264
|
+
company={"hq": {"sales_region": {"exclude": ["APAC"]}}},
|
|
265
|
+
people={
|
|
266
|
+
"job_description": {"include": ["outbound prospecting"], "exclude": ["internship"]},
|
|
267
|
+
"location": {
|
|
268
|
+
"continent": {"include": ["Europe"]},
|
|
269
|
+
"country_code": {"exclude": ["FR", "DE"]},
|
|
270
|
+
},
|
|
271
|
+
},
|
|
272
|
+
)
|
|
273
|
+
```
|
|
274
|
+
|
|
275
|
+
`people["job_description"]` on `search.people` and `company.tam_by_people` matches phrases
|
|
276
|
+
against the description of the job (`include` up to 50 phrases, `exclude` up to 20), and
|
|
277
|
+
`company["mx"]` also filters `jobs.search` and `company.tam_by_jobs`. Each company carries
|
|
278
|
+
`revenue_range`, the label of its yearly revenue band (`None` when the band is unknown).
|
|
279
|
+
|
|
252
280
|
`search.employee_finder` also takes `job_title` and `job_description`, each a dict with
|
|
253
281
|
`include` and `exclude` lists of phrases. They are matched against the person's current job
|
|
254
282
|
at the company, the same job as `job_level`, `job_function` and `is_recent_hire`. Wrap a
|
|
@@ -353,8 +381,9 @@ for page in client.search.people(people={"job_level": ["VP"]}).iter_pages(max_pa
|
|
|
353
381
|
print(page.fair_usage.records_used if page.fair_usage else None)
|
|
354
382
|
```
|
|
355
383
|
|
|
356
|
-
|
|
357
|
-
|
|
384
|
+
Every `APIStatusError` carries the block of the error body in `err.fair_usage` (`None`
|
|
385
|
+
when the body has none). On an error only `request_id` and `records_used` are always set.
|
|
386
|
+
On an `InsufficientRecordsError` (`402`) it also says when the balance resets:
|
|
358
387
|
|
|
359
388
|
```python
|
|
360
389
|
except InsufficientRecordsError as err:
|
|
@@ -31,9 +31,10 @@ if TYPE_CHECKING:
|
|
|
31
31
|
def _parse_fair_usage(body: Any) -> FairUsage | None:
|
|
32
32
|
"""Pull the ``fair_usage`` block out of an error body, if the API sent one.
|
|
33
33
|
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
34
|
+
Since 2026-11-17 the API attaches it to every JSON error body (before, only to
|
|
35
|
+
``402``), with ``records_used`` and ``request_id`` always set. A caller who runs out of
|
|
36
|
+
records can read ``next_reset_at`` off the exception. Never raises: a malformed block
|
|
37
|
+
just yields ``None`` rather than masking the original API error.
|
|
37
38
|
"""
|
|
38
39
|
if not isinstance(body, dict):
|
|
39
40
|
return None
|
|
@@ -98,7 +99,8 @@ class APIStatusError(BlitzError):
|
|
|
98
99
|
message: A human-readable message extracted from the body when present.
|
|
99
100
|
request_id: The value of the ``x-request-id`` response header, if any.
|
|
100
101
|
fair_usage: The :class:`~blitz_api.types.FairUsage` block from the body, when
|
|
101
|
-
the API sent one (it does
|
|
102
|
+
the API sent one (it does in every JSON error body); ``None`` otherwise. On an
|
|
103
|
+
error only ``records_used`` and ``request_id`` are always set.
|
|
102
104
|
response: The underlying :class:`httpx.Response`.
|
|
103
105
|
"""
|
|
104
106
|
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
__version__ = "4.4.0" # x-release-please-version
|
|
@@ -111,7 +111,8 @@ class AsyncSearchResource:
|
|
|
111
111
|
job with no start date never matches).
|
|
112
112
|
|
|
113
113
|
Each list is capped at 50 entries, except ``job_description["exclude"]`` (20); a
|
|
114
|
-
longer one is a ``422``. ``country_code``
|
|
114
|
+
longer one is a ``422``. ``country_code`` takes two-letter ISO 3166-1 codes in any
|
|
115
|
+
letter case (``UK`` is read as ``GB``; a value of any other length is a ``422``). It
|
|
115
116
|
defaults to ``["WORLD"]`` server-side: a list holding ``"WORLD"`` drops the country
|
|
116
117
|
filter. ``min_connections_count`` runs 0-500 (``0`` = no lower bound).
|
|
117
118
|
|
|
@@ -113,7 +113,8 @@ class SearchResource:
|
|
|
113
113
|
job with no start date never matches).
|
|
114
114
|
|
|
115
115
|
Each list is capped at 50 entries, except ``job_description["exclude"]`` (20); a
|
|
116
|
-
longer one is a ``422``. ``country_code``
|
|
116
|
+
longer one is a ``422``. ``country_code`` takes two-letter ISO 3166-1 codes in any
|
|
117
|
+
letter case (``UK`` is read as ``GB``; a value of any other length is a ``422``). It
|
|
117
118
|
defaults to ``["WORLD"]`` server-side: a list holding ``"WORLD"`` drops the country
|
|
118
119
|
filter. ``min_connections_count`` runs 0-500 (``0`` = no lower bound).
|
|
119
120
|
|
|
@@ -47,6 +47,8 @@ from .filters import (
|
|
|
47
47
|
CompanyHQFilter,
|
|
48
48
|
CompanySizeFilter,
|
|
49
49
|
CompanyTypeFilter,
|
|
50
|
+
ContinentFilter,
|
|
51
|
+
CountryCodeFilter,
|
|
50
52
|
DatePostedFilter,
|
|
51
53
|
EmploymentTypeFilter,
|
|
52
54
|
IndustryFilter,
|
|
@@ -64,6 +66,7 @@ from .filters import (
|
|
|
64
66
|
PeopleJobTitleFilter,
|
|
65
67
|
PeopleLocationFilter,
|
|
66
68
|
RangeFilter,
|
|
69
|
+
SalesRegionFilter,
|
|
67
70
|
SearchPeopleFilter,
|
|
68
71
|
SeniorityFilter,
|
|
69
72
|
TamJobFilter,
|
|
@@ -120,6 +123,9 @@ __all__ = [
|
|
|
120
123
|
"MxProviderFilter",
|
|
121
124
|
"MxFilter",
|
|
122
125
|
"RangeFilter",
|
|
126
|
+
"CountryCodeFilter",
|
|
127
|
+
"ContinentFilter",
|
|
128
|
+
"SalesRegionFilter",
|
|
123
129
|
"CompanyHQFilter",
|
|
124
130
|
"CompanyFilter",
|
|
125
131
|
"PeopleJobTitleFilter",
|
|
@@ -46,8 +46,9 @@ class FairUsageRateLimit(BlitzModel):
|
|
|
46
46
|
class FairUsage(BlitzModel):
|
|
47
47
|
"""Record usage, rate limit, and tracing data for a single request.
|
|
48
48
|
|
|
49
|
-
Returned by every ``/v2`` endpoint on success, and
|
|
50
|
-
|
|
49
|
+
Returned by every ``/v2`` endpoint on success, and since 2026-11-17 in every JSON error
|
|
50
|
+
body (:attr:`~blitz_api.APIStatusError.fair_usage`). On an error only ``records_used``
|
|
51
|
+
and ``request_id`` are always set; the other fields can be ``None``.
|
|
51
52
|
"""
|
|
52
53
|
|
|
53
54
|
#: Records this request consumed, after reconciliation against the results
|
|
@@ -129,14 +129,59 @@ class RangeFilter(TypedDict, total=False):
|
|
|
129
129
|
max: float
|
|
130
130
|
|
|
131
131
|
|
|
132
|
+
class CountryCodeFilter(TypedDict, total=False):
|
|
133
|
+
"""Include/exclude filter over country codes, in ``people.location``, ``company.hq`` and
|
|
134
|
+
the ``location`` of a waterfall tier.
|
|
135
|
+
|
|
136
|
+
A code is a two-letter ISO 3166-1 code such as ``"US"`` or ``"GB"``. Letter case does not
|
|
137
|
+
matter and ``"UK"`` is read as ``"GB"``. Since 2026-11-17 a value of any other length,
|
|
138
|
+
such as ``"USA"``, is rejected with a ``422`` (before, it was accepted and matched
|
|
139
|
+
nothing).
|
|
140
|
+
|
|
141
|
+
``"WORLD"`` is the one exception: in ``include`` it means every country, so the country
|
|
142
|
+
filter is off, also when the list holds other codes. ``exclude`` does not accept it.
|
|
143
|
+
|
|
144
|
+
``include`` never matches a record with no country on file, and ``exclude`` never drops
|
|
145
|
+
one.
|
|
146
|
+
"""
|
|
147
|
+
|
|
148
|
+
include: list[str]
|
|
149
|
+
exclude: list[str]
|
|
150
|
+
|
|
151
|
+
|
|
152
|
+
class ContinentFilter(TypedDict, total=False):
|
|
153
|
+
"""Include/exclude filter over continents. ``exclude`` never drops a record with no
|
|
154
|
+
continent on file.
|
|
155
|
+
"""
|
|
156
|
+
|
|
157
|
+
include: list[ContinentValue]
|
|
158
|
+
exclude: list[ContinentValue]
|
|
159
|
+
|
|
160
|
+
|
|
161
|
+
class SalesRegionFilter(TypedDict, total=False):
|
|
162
|
+
"""Include/exclude filter over sales regions. ``exclude`` never drops a record with no
|
|
163
|
+
sales region on file.
|
|
164
|
+
"""
|
|
165
|
+
|
|
166
|
+
include: list[SalesRegionValue]
|
|
167
|
+
exclude: list[SalesRegionValue]
|
|
168
|
+
|
|
169
|
+
|
|
132
170
|
class CompanyHQFilter(TypedDict, total=False):
|
|
133
|
-
"""Headquarters-location filter for company search.
|
|
171
|
+
"""Headquarters-location filter for company search. A company must match every field
|
|
172
|
+
you set.
|
|
173
|
+
|
|
174
|
+
``country_code``, ``continent`` and ``sales_region`` take a dict with ``include`` and
|
|
175
|
+
``exclude`` lists (since 2026-11-17). A plain list is the legacy form, still accepted: it
|
|
176
|
+
is read as ``include``. On ``search.people`` and ``company.tam_by_people`` the excludes
|
|
177
|
+
apply to the same job as your other company filters.
|
|
178
|
+
"""
|
|
134
179
|
|
|
135
180
|
city: KeywordFilter
|
|
136
181
|
state: KeywordFilter
|
|
137
|
-
country_code: list[str]
|
|
138
|
-
continent: list[ContinentValue]
|
|
139
|
-
sales_region: list[SalesRegionValue]
|
|
182
|
+
country_code: CountryCodeFilter | list[str]
|
|
183
|
+
continent: ContinentFilter | list[ContinentValue]
|
|
184
|
+
sales_region: SalesRegionFilter | list[SalesRegionValue]
|
|
140
185
|
|
|
141
186
|
|
|
142
187
|
class CompanyFilter(TypedDict, total=False):
|
|
@@ -203,13 +248,17 @@ class PeopleJobTitleFilter(TypedDict, total=False):
|
|
|
203
248
|
class PeopleLocationFilter(TypedDict, total=False):
|
|
204
249
|
"""Location filter for the people side of a people search, and for each waterfall tier
|
|
205
250
|
(:class:`CascadeTier`). A person must match every field you set.
|
|
251
|
+
|
|
252
|
+
``country_code``, ``continent`` and ``sales_region`` take a dict with ``include`` and
|
|
253
|
+
``exclude`` lists (since 2026-11-17). A plain list is the legacy form, still accepted: it
|
|
254
|
+
is read as ``include``.
|
|
206
255
|
"""
|
|
207
256
|
|
|
208
257
|
city: KeywordFilter
|
|
209
|
-
#
|
|
210
|
-
country_code: list[str]
|
|
211
|
-
continent: list[ContinentValue]
|
|
212
|
-
sales_region: list[SalesRegionValue]
|
|
258
|
+
# Two-letter codes such as ``"FR"`` or ``"GB"``, any case. See :class:`CountryCodeFilter`.
|
|
259
|
+
country_code: CountryCodeFilter | list[str]
|
|
260
|
+
continent: ContinentFilter | list[ContinentValue]
|
|
261
|
+
sales_region: SalesRegionFilter | list[SalesRegionValue]
|
|
213
262
|
|
|
214
263
|
|
|
215
264
|
class PeopleEducationFilter(KeywordFilter, total=False):
|
|
@@ -245,6 +294,13 @@ class PeopleFilter(TypedDict, total=False):
|
|
|
245
294
|
"""
|
|
246
295
|
|
|
247
296
|
job_title: PeopleJobTitleFilter
|
|
297
|
+
# Phrases matched against the description of a job. Every word of a phrase must appear,
|
|
298
|
+
# in any order, and several phrases are OR-ed; only the first 10,000 characters of a
|
|
299
|
+
# description are searched. It applies to the same job as the job title and company
|
|
300
|
+
# filters. ``[brackets]`` give no exact match here. ``exclude`` drops a job whose
|
|
301
|
+
# description has every word of a phrase, and never drops a job with no description.
|
|
302
|
+
# ``include`` takes up to 50 phrases, ``exclude`` up to 20.
|
|
303
|
+
job_description: KeywordFilter
|
|
248
304
|
job_function: list[JobFunctionValue]
|
|
249
305
|
job_level: list[JobLevelValue]
|
|
250
306
|
# Smallest LinkedIn connection count (0-500, ``0`` = no lower bound); above 500 is a ``422``.
|
|
@@ -351,7 +407,7 @@ class JobLocationFilter(TypedDict, total=False):
|
|
|
351
407
|
"""Location filter for a job posting (the job's location, not the company HQ)."""
|
|
352
408
|
|
|
353
409
|
city: KeywordFilter
|
|
354
|
-
country_code: KeywordFilter # ISO
|
|
410
|
+
country_code: KeywordFilter # Two-letter ISO 3166-1 codes, any case; ``UK`` reads as ``GB``.
|
|
355
411
|
|
|
356
412
|
|
|
357
413
|
class DatePostedFilter(TypedDict):
|
|
@@ -429,12 +485,12 @@ class JobCompanyHQFilter(TypedDict, total=False):
|
|
|
429
485
|
|
|
430
486
|
city: KeywordFilter
|
|
431
487
|
state: KeywordFilter
|
|
432
|
-
country_code: KeywordFilter # ISO
|
|
488
|
+
country_code: KeywordFilter # Two-letter ISO 3166-1 codes, any case; ``UK`` reads as ``GB``.
|
|
433
489
|
|
|
434
490
|
|
|
435
491
|
class JobCompanyFilter(TypedDict, total=False):
|
|
436
|
-
"""Company-level firmographic criteria for ``jobs.search
|
|
437
|
-
enriched company record behind each posting.
|
|
492
|
+
"""Company-level firmographic criteria for ``jobs.search`` and ``company.tam_by_jobs``,
|
|
493
|
+
matched against the enriched company record behind each posting.
|
|
438
494
|
"""
|
|
439
495
|
|
|
440
496
|
# ``True`` = only staffing/recruitment agencies, ``False`` = exclude confirmed
|
|
@@ -445,3 +501,5 @@ class JobCompanyFilter(TypedDict, total=False):
|
|
|
445
501
|
size: CompanySizeFilter
|
|
446
502
|
keywords: KeywordFilter
|
|
447
503
|
hq: JobCompanyHQFilter
|
|
504
|
+
# Mail provider of the company, from the MX records of its domains.
|
|
505
|
+
mx: MxFilter
|
|
@@ -167,6 +167,9 @@ class Company(BlitzModel):
|
|
|
167
167
|
industry: str | None = None
|
|
168
168
|
type: str | None = None
|
|
169
169
|
size: str | None = None
|
|
170
|
+
#: Label of the yearly revenue band, such as ``"$10M-$50M"``. ``None`` when the band is
|
|
171
|
+
#: unknown. The ``company.revenue`` filter of ``search.companies`` matches this band.
|
|
172
|
+
revenue_range: str | None = None
|
|
170
173
|
employees_on_linkedin: int | None = None
|
|
171
174
|
followers: int | None = None
|
|
172
175
|
founded_year: int | None = None
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
__version__ = "4.3.0" # x-release-please-version
|
|
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
|