@crawlora-org/sdk 1.20.0-sdk.1 → 1.22.0-sdk.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## v1.22.0-sdk.1
+
+- Regenerated from the public API contract (784 to 787 operations). Adds Threads search, cursor-paginated profile posts, and public post replies.
+
+## v1.21.0-sdk.1
+
+- Regenerated from the public API contract (782 to 784 operations). Adds credential-free Threads public profile and single-post lookups.
+
+## v1.20.0-sdk.2
+
+- Validate all supported ATS values for jobs dataset provider filters, including iCIMS and Eightfold.
+
 ## v1.20.0-sdk.1
 
 - Regenerated from the public API contract (776 to 782 operations). Adds jobs dataset company detail and nearby search, plus iCIMS and Eightfold board and job operations.

package/docs/operations.md

@@ -2,7 +2,7 @@
 
 Generated from `openapi/public.json`. Deprecated, admin, and internal operations are excluded from this SDK contract.
 
-Total operations: `782`
+Total operations: `787`
 
 | Group | SDK method | Operation ID | HTTP | Params | Auth | Response | Notes |
 | --- | --- | --- | --- | --- | --- | --- | --- |
@@ -148,12 +148,12 @@ Total operations: `782`
 | datasets | `datasets.housingMarketsFacets` | `datasets-housing-markets-facets` | `GET /datasets/housing-markets/facets` | `facet` (query string required)<br>`q` (query string)<br>`region_type` (query string)<br>`state_code` (query string)<br>`property_type` (query string)<br>`parent_metro_code` (query string)<br>`zip_code` (query string)<br>`period` (query string)<br>`latest` (query boolean)<br>`min_median_sale_price` (query number)<br>`max_median_sale_price` (query number)<br>`min_median_list_price` (query number)<br>`max_median_list_price` (query number)<br>`min_price_to_income` (query number)<br>`max_price_to_income` (query number)<br>`min_salary_to_buy` (query number)<br>`max_salary_to_buy` (query number)<br>`min_median_dom` (query number)<br>`max_median_dom` (query number)<br>`min_inventory` (query number)<br>`max_inventory` (query number)<br>`min_homes_sold` (query number) | `ApiKeyAuth` | `DatasetsHousingMarketsFacetsResponse` |  |
 | datasets | `datasets.housingMarketsItem` | `datasets-housing-markets-item` | `GET /datasets/housing-markets/items/{region_type}/{table_id}` | `region_type` (path string required)<br>`table_id` (path number required)<br>`period` (query string)<br>`property_type` (query string)<br>`history` (query boolean) | `ApiKeyAuth` | `DatasetsHousingMarketsItemResponse` |  |
 | datasets | `datasets.housingMarketsSearch` | `datasets-housing-markets-search` | `GET /datasets/housing-markets/search` | `q` (query string)<br>`region_type` (query string)<br>`state_code` (query string)<br>`property_type` (query string)<br>`parent_metro_code` (query string)<br>`zip_code` (query string)<br>`period` (query string)<br>`latest` (query boolean)<br>`min_median_sale_price` (query number)<br>`max_median_sale_price` (query number)<br>`min_median_list_price` (query number)<br>`max_median_list_price` (query number)<br>`min_price_to_income` (query number)<br>`max_price_to_income` (query number)<br>`min_salary_to_buy` (query number)<br>`max_salary_to_buy` (query number)<br>`min_median_dom` (query number)<br>`max_median_dom` (query number)<br>`min_inventory` (query number)<br>`max_inventory` (query number)<br>`min_homes_sold` (query number)<br>`sort` (query string)<br>`page` (query number)<br>`page_size` (query number) | `ApiKeyAuth` | `DatasetsHousingMarketsSearchResponse` |  |
-| datasets | `datasets.jobsCompanies` | `datasets-jobs-companies` | `GET /datasets/jobs/companies` | `q` (query string)<br>`provider` (query string)<br>`status` (query string)<br>`min_open_roles` (query number)<br>`sort` (query string)<br>`page` (query number)<br>`page_size` (query number) | `ApiKeyAuth` | `DatasetsJobsCompaniesResponse` |  |
+| datasets | `datasets.jobsCompanies` | `datasets-jobs-companies` | `GET /datasets/jobs/companies` | `q` (query string)<br>`provider` (query "greenhouse" \| "lever" \| "ashby" \| "workday" \| "smartrecruiters" \| "workable" \| "recruitee" \| "rippling" \| "personio" \| "teamtailor" \| "oracle" \| "ukg" \| "icims" \| "eightfold")<br>`status` (query string)<br>`min_open_roles` (query number)<br>`sort` (query string)<br>`page` (query number)<br>`page_size` (query number) | `ApiKeyAuth` | `DatasetsJobsCompaniesResponse` |  |
 | datasets | `datasets.jobsCompanyItem` | `datasets-jobs-company-item` | `GET /datasets/jobs/companies/{id}` | `id` (path string required) | `ApiKeyAuth` | `DatasetsJobsCompanyItemResponse` |  |
 | datasets | `datasets.jobsFacets` | `datasets-jobs-facets` | `GET /datasets/jobs/facets` | `size` (query number) | `ApiKeyAuth` | `DatasetsJobsFacetsResponse` |  |
 | datasets | `datasets.jobsItem` | `datasets-jobs-item` | `GET /datasets/jobs/items/{id}` | `id` (path string required) | `ApiKeyAuth` | `DatasetsJobsItemResponse` |  |
-| datasets | `datasets.jobsNearby` | `datasets-jobs-nearby` | `GET /datasets/jobs/nearby` | `lat` (query number required)<br>`lon` (query number required)<br>`radius_km` (query number)<br>`provider` (query string)<br>`include_closed` (query boolean)<br>`page` (query number)<br>`page_size` (query number) | `ApiKeyAuth` | `DatasetsJobsNearbyResponse` |  |
-| datasets | `datasets.jobsSearch` | `datasets-jobs-search` | `GET /datasets/jobs/search` | `q` (query string)<br>`company` (query string)<br>`provider` (query string)<br>`department` (query string)<br>`location` (query string)<br>`employment_type` (query string)<br>`remote` (query boolean)<br>`include_closed` (query boolean)<br>`sort` (query string)<br>`page` (query number)<br>`page_size` (query number) | `ApiKeyAuth` | `DatasetsJobsSearchResponse` |  |
+| datasets | `datasets.jobsNearby` | `datasets-jobs-nearby` | `GET /datasets/jobs/nearby` | `lat` (query number required)<br>`lon` (query number required)<br>`radius_km` (query number)<br>`provider` (query "greenhouse" \| "lever" \| "ashby" \| "workday" \| "smartrecruiters" \| "workable" \| "recruitee" \| "rippling" \| "personio" \| "teamtailor" \| "oracle" \| "ukg" \| "icims" \| "eightfold")<br>`include_closed` (query boolean)<br>`page` (query number)<br>`page_size` (query number) | `ApiKeyAuth` | `DatasetsJobsNearbyResponse` |  |
+| datasets | `datasets.jobsSearch` | `datasets-jobs-search` | `GET /datasets/jobs/search` | `q` (query string)<br>`company` (query string)<br>`provider` (query "greenhouse" \| "lever" \| "ashby" \| "workday" \| "smartrecruiters" \| "workable" \| "recruitee" \| "rippling" \| "personio" \| "teamtailor" \| "oracle" \| "ukg" \| "icims" \| "eightfold")<br>`department` (query string)<br>`location` (query string)<br>`employment_type` (query string)<br>`remote` (query boolean)<br>`include_closed` (query boolean)<br>`sort` (query string)<br>`page` (query number)<br>`page_size` (query number) | `ApiKeyAuth` | `DatasetsJobsSearchResponse` |  |
 | datasets | `datasets.journalistsFacets` | `datasets-journalists-facets` | `GET /datasets/journalists/facets` | `facet` (query string required)<br>`q` (query string)<br>`outlet` (query string)<br>`vertical` (query string)<br>`topic` (query string)<br>`contact_type` (query string) | `ApiKeyAuth` | `DatasetsJournalistsFacetsResponse` |  |
 | datasets | `datasets.journalistsItem` | `datasets-journalists-item` | `GET /datasets/journalists/items/{outlet}/{slug}` | `outlet` (path string required)<br>`slug` (path string required) | `ApiKeyAuth` | `DatasetsJournalistsItemResponse` |  |
 | datasets | `datasets.journalistsSearch` | `datasets-journalists-search` | `GET /datasets/journalists/search` | `q` (query string)<br>`outlet` (query string)<br>`vertical` (query string)<br>`topic` (query string)<br>`contact_type` (query string)<br>`sort` (query string)<br>`page` (query number)<br>`page_size` (query number) | `ApiKeyAuth` | `DatasetsJournalistsSearchResponse` |  |
@@ -670,6 +670,11 @@ Total operations: `782`
 | tcdb | `tcdb.tagged` | `tcdb-tagged` | `GET /tcdb/tagged` | `id` (query string)<br>`path` (query string)<br>`url` (query string)<br>`sport` (query "Baseball" \| "Basketball" \| "Boxing" \| "Cricket" \| "Football" \| "Gaming" \| "Golf" \| "Hockey" \| "Misc Sports" \| "MMA" \| "Multi-Sport" \| "Non-Sport" \| "Racing" \| "Soccer" \| "Tennis" \| "Wrestling")<br>`page` (query number)<br>`limit` (query number) | `ApiKeyAuth` | `TcdbTaggedResponse` |  |
 | tcdb | `tcdb.team` | `tcdb-team` | `GET /tcdb/team` | `id` (query string)<br>`path` (query string)<br>`url` (query string)<br>`limit` (query number) | `ApiKeyAuth` | `TcdbTeamResponse` |  |
 | tcdb | `tcdb.topSets` | `tcdb-top-sets` | `GET /tcdb/top-sets` | `limit` (query number) | `ApiKeyAuth` | `TcdbTopSetsResponse` |  |
+| threads | `threads.post` | `threads-post` | `GET /threads/post/{username}/{code}` | `username` (path string required)<br>`code` (path string required) | `ApiKeyAuth` | `ThreadsPostResponse` |  |
+| threads | `threads.postReplies` | `threads-post-replies` | `GET /threads/post/{username}/{code}/replies` | `username` (path string required)<br>`code` (path string required) | `ApiKeyAuth` | `ThreadsPostRepliesResponse` |  |
+| threads | `threads.profile` | `threads-profile` | `GET /threads/profile/{username}` | `username` (path string required) | `ApiKeyAuth` | `ThreadsProfileResponse` |  |
+| threads | `threads.profilePosts` | `threads-profile-posts` | `GET /threads/profile/{username}/posts` | `username` (path string required)<br>`cursor` (query string) | `ApiKeyAuth` | `ThreadsProfilePostsResponse` |  |
+| threads | `threads.search` | `threads-search` | `GET /threads/search` | `q` (query string required) | `ApiKeyAuth` | `ThreadsSearchResponse` |  |
 | tiktok | `tiktok.category` | `tiktok-category` | `GET /tiktok/category` | none | `ApiKeyAuth` | `TiktokCategoryResponse` |  |
 | tiktok | `tiktok.videoComments` | `tiktok-video-comments` | `GET /tiktok/comments` | `aweme_id` (query string required)<br>`cursor` (query number) | `ApiKeyAuth` | `TiktokVideoCommentsResponse` |  |
 | tiktok | `tiktok.explore` | `tiktok-explore` | `GET /tiktok/explore/{id}` | `id` (path number required) | `ApiKeyAuth` | `TiktokExploreResponse` |  |

package/docs/recipes.md

@@ -39,6 +39,16 @@ const posts = await crawlora.reddit.search({ q: "typescript", subreddit: "progra
 const brand = await crawlora.brand.retrieve({ domain: "stripe.com" });
 ```
 
+## Threads Public Lookups
+
+```ts
+const profile = await crawlora.threads.profile({ username: "zuck" });
+const post = await crawlora.threads.post({ username: "zuck", code: "DakyAavlKLZ" });
+const results = await crawlora.threads.search({ q: "openai" });
+const posts = await crawlora.threads.profilePosts({ username: "zuck" });
+const replies = await crawlora.threads.postReplies({ username: "zuck", code: "DakyAavlKLZ" });
+```
+
 ## Software, Reviews, And Market Datasets
 
 Build a Chrome extension competitive-intelligence view without downloading the

package/openapi/public.json

@@ -48370,6 +48370,265 @@
       },
       "type": "object"
     },
+    "threads.Author": {
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "name": {
+          "type": "string"
+        },
+        "username": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "threads.Post": {
+      "properties": {
+        "author": {
+          "$ref": "#/definitions/threads.Author"
+        },
+        "code": {
+          "type": "string"
+        },
+        "image_url": {
+          "type": "string"
+        },
+        "text": {
+          "type": "string"
+        },
+        "url": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "threads.Profile": {
+      "properties": {
+        "avatar_url": {
+          "type": "string"
+        },
+        "biography": {
+          "type": "string"
+        },
+        "followers_count": {
+          "type": "integer"
+        },
+        "name": {
+          "type": "string"
+        },
+        "threads_count": {
+          "type": "integer"
+        },
+        "url": {
+          "type": "string"
+        },
+        "username": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "threads.ProfilePostsResult": {
+      "properties": {
+        "has_more": {
+          "type": "boolean"
+        },
+        "items": {
+          "items": {
+            "$ref": "#/definitions/threads.Thread"
+          },
+          "type": "array"
+        },
+        "next_cursor": {
+          "type": "string"
+        },
+        "username": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "threads.RepliesResult": {
+      "properties": {
+        "code": {
+          "type": "string"
+        },
+        "has_more": {
+          "type": "boolean"
+        },
+        "items": {
+          "items": {
+            "$ref": "#/definitions/threads.Thread"
+          },
+          "type": "array"
+        },
+        "next_cursor": {
+          "type": "string"
+        },
+        "pagination_limited": {
+          "type": "boolean"
+        },
+        "username": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "threads.SearchResult": {
+      "properties": {
+        "has_more": {
+          "type": "boolean"
+        },
+        "items": {
+          "items": {
+            "$ref": "#/definitions/threads.Thread"
+          },
+          "type": "array"
+        },
+        "next_cursor": {
+          "type": "string"
+        },
+        "query": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "threads.Thread": {
+      "properties": {
+        "author": {
+          "$ref": "#/definitions/threads.Author"
+        },
+        "code": {
+          "type": "string"
+        },
+        "created_at": {
+          "type": "string"
+        },
+        "id": {
+          "type": "string"
+        },
+        "image_urls": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "is_reply": {
+          "type": "boolean"
+        },
+        "like_count": {
+          "type": "integer"
+        },
+        "quote_count": {
+          "type": "integer"
+        },
+        "reply_count": {
+          "type": "integer"
+        },
+        "reply_to": {
+          "type": "string"
+        },
+        "repost_count": {
+          "type": "integer"
+        },
+        "text": {
+          "type": "string"
+        },
+        "url": {
+          "type": "string"
+        },
+        "video_urls": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
+    "threads.postResponseDoc": {
+      "properties": {
+        "code": {
+          "example": 200,
+          "type": "integer"
+        },
+        "data": {
+          "$ref": "#/definitions/threads.Post"
+        },
+        "msg": {
+          "example": "OK",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "threads.profilePostsResponseDoc": {
+      "properties": {
+        "code": {
+          "example": 200,
+          "type": "integer"
+        },
+        "data": {
+          "$ref": "#/definitions/threads.ProfilePostsResult"
+        },
+        "msg": {
+          "example": "OK",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "threads.profileResponseDoc": {
+      "properties": {
+        "code": {
+          "example": 200,
+          "type": "integer"
+        },
+        "data": {
+          "$ref": "#/definitions/threads.Profile"
+        },
+        "msg": {
+          "example": "OK",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "threads.repliesResponseDoc": {
+      "properties": {
+        "code": {
+          "example": 200,
+          "type": "integer"
+        },
+        "data": {
+          "$ref": "#/definitions/threads.RepliesResult"
+        },
+        "msg": {
+          "example": "OK",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "threads.searchResponseDoc": {
+      "properties": {
+        "code": {
+          "example": 200,
+          "type": "integer"
+        },
+        "data": {
+          "$ref": "#/definitions/threads.SearchResult"
+        },
+        "msg": {
+          "example": "OK",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
     "tiktok.Category": {
       "properties": {
         "name": {
@@ -55350,6 +55609,10 @@
     },
     "x.Profile": {
       "properties": {
+        "affiliate_label": {
+          "description": "AffiliateLabel is the small highlighted-affiliation badge X shows next\nto the display name (e.g. \"Prime Video\" for an account run on behalf\nof that brand). Distinct from VerifiedType; empty when the account has\nno highlighted affiliation.",
+          "type": "string"
+        },
         "avatar_url": {
           "type": "string"
         },
@@ -71133,7 +71396,7 @@
         "consumes": [
           "application/json"
         ],
-        "description": "Searches the discovered company board registry — which companies are hiring, on which ATS, with how many open roles. status enum: `active`, `empty`, `gone`, `blocked`, `pending`. sort enum: `open_desc`, `company_asc`, `crawled_desc`.",
+        "description": "Searches the discovered company board registry — which companies are hiring, on which ATS, with how many open roles. provider enum: `greenhouse`, `lever`, `ashby`, `workday`, `smartrecruiters`, `workable`, `recruitee`, `rippling`, `personio`, `teamtailor`, `oracle`, `ukg`, `icims`, `eightfold`. status enum: `active`, `empty`, `gone`, `blocked`, `pending`. sort enum: `open_desc`, `company_asc`, `crawled_desc`.",
         "operationId": "datasets-jobs-companies",
         "parameters": [
           {
@@ -71144,6 +71407,22 @@
           },
           {
             "description": "ATS provider filter",
+            "enum": [
+              "greenhouse",
+              "lever",
+              "ashby",
+              "workday",
+              "smartrecruiters",
+              "workable",
+              "recruitee",
+              "rippling",
+              "personio",
+              "teamtailor",
+              "oracle",
+              "ukg",
+              "icims",
+              "eightfold"
+            ],
             "in": "query",
             "name": "provider",
             "type": "string"
@@ -71379,7 +71658,7 @@
         "consumes": [
           "application/json"
         ],
-        "description": "Finds crawled job postings within `radius_km` of a `lat`/`lon`, nearest first. Only geocoded postings participate (the geo-enrich worker back-fills coordinates from each posting's location). Open roles only by default. provider enum matches search.",
+        "description": "Finds crawled job postings within `radius_km` of a `lat`/`lon`, nearest first. Only geocoded postings participate (the geo-enrich worker back-fills coordinates from each posting's location). Open roles only by default. provider enum: `greenhouse`, `lever`, `ashby`, `workday`, `smartrecruiters`, `workable`, `recruitee`, `rippling`, `personio`, `teamtailor`, `oracle`, `ukg`, `icims`, `eightfold`.",
         "operationId": "datasets-jobs-nearby",
         "parameters": [
           {
@@ -71404,6 +71683,22 @@
           },
           {
             "description": "ATS provider filter",
+            "enum": [
+              "greenhouse",
+              "lever",
+              "ashby",
+              "workday",
+              "smartrecruiters",
+              "workable",
+              "recruitee",
+              "rippling",
+              "personio",
+              "teamtailor",
+              "oracle",
+              "ukg",
+              "icims",
+              "eightfold"
+            ],
             "in": "query",
             "name": "provider",
             "type": "string"
@@ -71466,7 +71761,7 @@
         "consumes": [
           "application/json"
         ],
-        "description": "Full-text + faceted search over every job posting crawled from every discovered company ATS board (Greenhouse, Lever, Ashby, Workday, SmartRecruiters, Workable, Recruitee, Rippling, Personio, Teamtailor, Oracle, UKG). Open roles only by default (set include_closed=true for historical/filled roles). provider enum: `greenhouse`, `lever`, `ashby`, `workday`, `smartrecruiters`, `workable`, `recruitee`, `rippling`, `personio`, `teamtailor`, `oracle`, `ukg`. sort enum: `relevance`, `posted_desc`, `company_asc`.",
+        "description": "Full-text + faceted search over every job posting crawled from every discovered company ATS board (Greenhouse, Lever, Ashby, Workday, SmartRecruiters, Workable, Recruitee, Rippling, Personio, Teamtailor, Oracle, UKG, iCIMS, Eightfold). Open roles only by default (set include_closed=true for historical/filled roles). provider enum: `greenhouse`, `lever`, `ashby`, `workday`, `smartrecruiters`, `workable`, `recruitee`, `rippling`, `personio`, `teamtailor`, `oracle`, `ukg`, `icims`, `eightfold`. sort enum: `relevance`, `posted_desc`, `company_asc`.",
         "operationId": "datasets-jobs-search",
         "parameters": [
           {
@@ -71482,7 +71777,23 @@
             "type": "string"
           },
           {
-            "description": "ATS provider filter. Enum: greenhouse, lever, ashby, workday, smartrecruiters, workable, recruitee, rippling, personio, teamtailor, oracle, ukg",
+            "description": "ATS provider filter",
+            "enum": [
+              "greenhouse",
+              "lever",
+              "ashby",
+              "workday",
+              "smartrecruiters",
+              "workable",
+              "recruitee",
+              "rippling",
+              "personio",
+              "teamtailor",
+              "oracle",
+              "ukg",
+              "icims",
+              "eightfold"
+            ],
             "in": "query",
             "name": "provider",
             "type": "string"
@@ -111966,6 +112277,285 @@
         ]
       }
     },
+    "/threads/post/{username}/{code}": {
+      "get": {
+        "description": "Returns the public text, author, canonical URL, and preview image for a Threads post.",
+        "operationId": "threads-post",
+        "parameters": [
+          {
+            "description": "Threads username",
+            "in": "path",
+            "name": "username",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "description": "Threads post code",
+            "in": "path",
+            "name": "code",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "produces": [
+          "application/json"
+        ],
+        "responses": {
+          "200": {
+            "description": "Wrapped post payload",
+            "schema": {
+              "$ref": "#/definitions/threads.postResponseDoc"
+            }
+          },
+          "400": {
+            "description": "Invalid username or post code",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          },
+          "404": {
+            "description": "Post not found",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          },
+          "503": {
+            "description": "Upstream error or parser drift",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          }
+        },
+        "security": [
+          {
+            "ApiKeyAuth": []
+          }
+        ],
+        "summary": "Retrieve a public Threads post",
+        "tags": [
+          "Threads"
+        ]
+      }
+    },
+    "/threads/post/{username}/{code}/replies": {
+      "get": {
+        "description": "Returns the public replies currently exposed to logged-out visitors. The response identifies when Threads reports additional replies but withholds a usable continuation cursor.",
+        "operationId": "threads-post-replies",
+        "parameters": [
+          {
+            "description": "Threads username",
+            "in": "path",
+            "name": "username",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "description": "Threads post code",
+            "in": "path",
+            "name": "code",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "produces": [
+          "application/json"
+        ],
+        "responses": {
+          "200": {
+            "description": "Wrapped replies payload",
+            "schema": {
+              "$ref": "#/definitions/threads.repliesResponseDoc"
+            }
+          },
+          "400": {
+            "description": "Invalid username or post code",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          },
+          "404": {
+            "description": "Post not found",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          },
+          "503": {
+            "description": "Upstream error or parser drift",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          }
+        },
+        "security": [
+          {
+            "ApiKeyAuth": []
+          }
+        ],
+        "summary": "Retrieve public replies to a Threads post",
+        "tags": [
+          "Threads"
+        ]
+      }
+    },
+    "/threads/profile/{username}": {
+      "get": {
+        "description": "Returns public profile metadata for a Threads username, including the visible biography and counts.",
+        "operationId": "threads-profile",
+        "parameters": [
+          {
+            "description": "Threads username",
+            "in": "path",
+            "name": "username",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "produces": [
+          "application/json"
+        ],
+        "responses": {
+          "200": {
+            "description": "Wrapped profile payload",
+            "schema": {
+              "$ref": "#/definitions/threads.profileResponseDoc"
+            }
+          },
+          "400": {
+            "description": "Invalid username",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          },
+          "404": {
+            "description": "Profile not found",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          },
+          "503": {
+            "description": "Upstream error or parser drift",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          }
+        },
+        "security": [
+          {
+            "ApiKeyAuth": []
+          }
+        ],
+        "summary": "Retrieve a public Threads profile",
+        "tags": [
+          "Threads"
+        ]
+      }
+    },
+    "/threads/profile/{username}/posts": {
+      "get": {
+        "description": "Returns public profile posts with an opaque continuation cursor when more posts are available.",
+        "operationId": "threads-profile-posts",
+        "parameters": [
+          {
+            "description": "Threads username",
+            "in": "path",
+            "name": "username",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "description": "Opaque cursor returned by the previous response",
+            "in": "query",
+            "name": "cursor",
+            "type": "string"
+          }
+        ],
+        "produces": [
+          "application/json"
+        ],
+        "responses": {
+          "200": {
+            "description": "Wrapped profile posts payload",
+            "schema": {
+              "$ref": "#/definitions/threads.profilePostsResponseDoc"
+            }
+          },
+          "400": {
+            "description": "Invalid username or cursor",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          },
+          "404": {
+            "description": "Profile not found",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          },
+          "503": {
+            "description": "Upstream error or parser drift",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          }
+        },
+        "security": [
+          {
+            "ApiKeyAuth": []
+          }
+        ],
+        "summary": "Retrieve public posts from a Threads profile",
+        "tags": [
+          "Threads"
+        ]
+      }
+    },
+    "/threads/search": {
+      "get": {
+        "description": "Returns the public first page of Threads search results for a query. Logged-out search does not expose a continuation cursor.",
+        "operationId": "threads-search",
+        "parameters": [
+          {
+            "description": "Search query (1-100 characters)",
+            "in": "query",
+            "name": "q",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "produces": [
+          "application/json"
+        ],
+        "responses": {
+          "200": {
+            "description": "Wrapped search payload",
+            "schema": {
+              "$ref": "#/definitions/threads.searchResponseDoc"
+            }
+          },
+          "400": {
+            "description": "Invalid query",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          },
+          "503": {
+            "description": "Upstream error or parser drift",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          }
+        },
+        "security": [
+          {
+            "ApiKeyAuth": []
+          }
+        ],
+        "summary": "Search public Threads posts",
+        "tags": [
+          "Threads"
+        ]
+      }
+    },
     "/tiktok/category": {
       "get": {
         "consumes": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crawlora-org/sdk",
-  "version": "1.20.0-sdk.1",
+  "version": "1.22.0-sdk.1",
   "description": "JavaScript and TypeScript SDK for the public Crawlora API.",
   "keywords": [
     "crawlora",

package/src/client.js

@@ -1,7 +1,7 @@
 import { operations, groups } from "./operations.js";
 
 const DEFAULT_BASE_URL = "https://api.crawlora.net/api/v1";
-export const VERSION = "1.20.0-sdk.1";
+export const VERSION = "1.22.0-sdk.1";
 const DEFAULT_USER_AGENT = `crawlora-js-sdk/${VERSION}`;
 
 export class CrawloraError extends Error {

package/src/operations.js

@@ -7195,6 +7195,22 @@ export const operations = {
         "type": "string"
       },
       {
+        "enum": [
+          "greenhouse",
+          "lever",
+          "ashby",
+          "workday",
+          "smartrecruiters",
+          "workable",
+          "recruitee",
+          "rippling",
+          "personio",
+          "teamtailor",
+          "oracle",
+          "ukg",
+          "icims",
+          "eightfold"
+        ],
         "in": "query",
         "name": "provider",
         "type": "string"
@@ -7330,6 +7346,22 @@ export const operations = {
         "type": "number"
       },
       {
+        "enum": [
+          "greenhouse",
+          "lever",
+          "ashby",
+          "workday",
+          "smartrecruiters",
+          "workable",
+          "recruitee",
+          "rippling",
+          "personio",
+          "teamtailor",
+          "oracle",
+          "ukg",
+          "icims",
+          "eightfold"
+        ],
         "in": "query",
         "name": "provider",
         "type": "string"
@@ -7381,6 +7413,22 @@ export const operations = {
         "type": "string"
       },
       {
+        "enum": [
+          "greenhouse",
+          "lever",
+          "ashby",
+          "workday",
+          "smartrecruiters",
+          "workable",
+          "recruitee",
+          "rippling",
+          "personio",
+          "teamtailor",
+          "oracle",
+          "ukg",
+          "icims",
+          "eightfold"
+        ],
         "in": "query",
         "name": "provider",
         "type": "string"
@@ -27685,6 +27733,118 @@ export const operations = {
       "ApiKeyAuth"
     ]
   },
+  "threads-post": {
+    "bodyParam": null,
+    "bodyRequired": false,
+    "consumes": [],
+    "formParams": [],
+    "id": "threads-post",
+    "method": "GET",
+    "path": "/threads/post/{username}/{code}",
+    "pathParams": [
+      "username",
+      "code"
+    ],
+    "produces": [
+      "application/json"
+    ],
+    "queryParams": [],
+    "security": [
+      "ApiKeyAuth"
+    ]
+  },
+  "threads-post-replies": {
+    "bodyParam": null,
+    "bodyRequired": false,
+    "consumes": [],
+    "formParams": [],
+    "id": "threads-post-replies",
+    "method": "GET",
+    "path": "/threads/post/{username}/{code}/replies",
+    "pathParams": [
+      "username",
+      "code"
+    ],
+    "produces": [
+      "application/json"
+    ],
+    "queryParams": [],
+    "security": [
+      "ApiKeyAuth"
+    ]
+  },
+  "threads-profile": {
+    "bodyParam": null,
+    "bodyRequired": false,
+    "consumes": [],
+    "formParams": [],
+    "id": "threads-profile",
+    "method": "GET",
+    "path": "/threads/profile/{username}",
+    "pathParams": [
+      "username"
+    ],
+    "produces": [
+      "application/json"
+    ],
+    "queryParams": [],
+    "security": [
+      "ApiKeyAuth"
+    ]
+  },
+  "threads-profile-posts": {
+    "bodyParam": null,
+    "bodyRequired": false,
+    "consumes": [],
+    "cursorParams": [
+      "cursor"
+    ],
+    "formParams": [],
+    "id": "threads-profile-posts",
+    "method": "GET",
+    "paginatable": true,
+    "path": "/threads/profile/{username}/posts",
+    "pathParams": [
+      "username"
+    ],
+    "produces": [
+      "application/json"
+    ],
+    "queryParams": [
+      {
+        "in": "query",
+        "name": "cursor",
+        "type": "string"
+      }
+    ],
+    "security": [
+      "ApiKeyAuth"
+    ]
+  },
+  "threads-search": {
+    "bodyParam": null,
+    "bodyRequired": false,
+    "consumes": [],
+    "formParams": [],
+    "id": "threads-search",
+    "method": "GET",
+    "path": "/threads/search",
+    "pathParams": [],
+    "produces": [
+      "application/json"
+    ],
+    "queryParams": [
+      {
+        "in": "query",
+        "name": "q",
+        "required": true,
+        "type": "string"
+      }
+    ],
+    "security": [
+      "ApiKeyAuth"
+    ]
+  },
   "tiktok-category": {
     "bodyParam": null,
     "bodyRequired": false,
@@ -32226,6 +32386,13 @@ export const groups = {
     "team": "tcdb-team",
     "topSets": "tcdb-top-sets"
   },
+  "threads": {
+    "post": "threads-post",
+    "postReplies": "threads-post-replies",
+    "profile": "threads-profile",
+    "profilePosts": "threads-profile-posts",
+    "search": "threads-search"
+  },
   "tiktok": {
     "category": "tiktok-category",
     "challenge": "tiktok-challenge",
@@ -32377,7 +32544,7 @@ export const groups = {
   }
 };
 
-export const operationCount = 782;
+export const operationCount = 787;
 
 // PascalCase aliases for every operation id, for discoverable, typo-safe
 // dynamic calls: client.request(OperationIds.BingSearch, { q: "coffee" }).
@@ -33041,6 +33208,11 @@ export const OperationIds = Object.freeze({
   "TcdbTagged": "tcdb-tagged",
   "TcdbTeam": "tcdb-team",
   "TcdbTopSets": "tcdb-top-sets",
+  "ThreadsPost": "threads-post",
+  "ThreadsPostReplies": "threads-post-replies",
+  "ThreadsProfile": "threads-profile",
+  "ThreadsProfilePosts": "threads-profile-posts",
+  "ThreadsSearch": "threads-search",
   "TiktokCategory": "tiktok-category",
   "TiktokChallenge": "tiktok-challenge",
   "TiktokChallengeList": "tiktok-challenge-list",

package/src/types.d.ts

@@ -15395,6 +15395,100 @@ export interface ModelTechstackTechnology {
   "version"?: string;
 }
 
+export interface ModelThreadsAuthor {
+  "id"?: string;
+  "name"?: string;
+  "username"?: string;
+}
+
+export interface ModelThreadsPost {
+  "author"?: ModelThreadsAuthor;
+  "code"?: string;
+  "image_url"?: string;
+  "text"?: string;
+  "url"?: string;
+}
+
+export interface ModelThreadsProfile {
+  "avatar_url"?: string;
+  "biography"?: string;
+  "followers_count"?: number;
+  "name"?: string;
+  "threads_count"?: number;
+  "url"?: string;
+  "username"?: string;
+}
+
+export interface ModelThreadsProfilePostsResult {
+  "has_more"?: boolean;
+  "items"?: Array<ModelThreadsThread>;
+  "next_cursor"?: string;
+  "username"?: string;
+}
+
+export interface ModelThreadsRepliesResult {
+  "code"?: string;
+  "has_more"?: boolean;
+  "items"?: Array<ModelThreadsThread>;
+  "next_cursor"?: string;
+  "pagination_limited"?: boolean;
+  "username"?: string;
+}
+
+export interface ModelThreadsSearchResult {
+  "has_more"?: boolean;
+  "items"?: Array<ModelThreadsThread>;
+  "next_cursor"?: string;
+  "query"?: string;
+}
+
+export interface ModelThreadsThread {
+  "author"?: ModelThreadsAuthor;
+  "code"?: string;
+  "created_at"?: string;
+  "id"?: string;
+  "image_urls"?: Array<string>;
+  "is_reply"?: boolean;
+  "like_count"?: number;
+  "quote_count"?: number;
+  "reply_count"?: number;
+  "reply_to"?: string;
+  "repost_count"?: number;
+  "text"?: string;
+  "url"?: string;
+  "video_urls"?: Array<string>;
+}
+
+export interface ModelThreadsPostResponseDoc {
+  "code"?: number;
+  "data"?: ModelThreadsPost;
+  "msg"?: string;
+}
+
+export interface ModelThreadsProfilePostsResponseDoc {
+  "code"?: number;
+  "data"?: ModelThreadsProfilePostsResult;
+  "msg"?: string;
+}
+
+export interface ModelThreadsProfileResponseDoc {
+  "code"?: number;
+  "data"?: ModelThreadsProfile;
+  "msg"?: string;
+}
+
+export interface ModelThreadsRepliesResponseDoc {
+  "code"?: number;
+  "data"?: ModelThreadsRepliesResult;
+  "msg"?: string;
+}
+
+export interface ModelThreadsSearchResponseDoc {
+  "code"?: number;
+  "data"?: ModelThreadsSearchResult;
+  "msg"?: string;
+}
+
 export interface ModelTiktokCategory {
   "name"?: string;
   "type"?: string;
@@ -17358,6 +17452,7 @@ export interface ModelXPostQuote {
 }
 
 export interface ModelXProfile {
+  "affiliate_label"?: string;
   "avatar_url"?: string;
   "banner_url"?: string;
   "bio_urls"?: Array<string>;
@@ -19520,7 +19615,7 @@ export interface DatasetsHousingMarketsSearchParams {
 export type DatasetsJobsCompaniesResponse = CrawloraResponse<ModelDatasetsJobsCompaniesResponseDoc>;
 export interface DatasetsJobsCompaniesParams {
   "q"?: string;
-  "provider"?: string;
+  "provider"?: "greenhouse" | "lever" | "ashby" | "workday" | "smartrecruiters" | "workable" | "recruitee" | "rippling" | "personio" | "teamtailor" | "oracle" | "ukg" | "icims" | "eightfold";
   "status"?: string;
   "min_open_roles"?: number;
   "sort"?: string;
@@ -19548,7 +19643,7 @@ export interface DatasetsJobsNearbyParams {
   "lat": number;
   "lon": number;
   "radius_km"?: number;
-  "provider"?: string;
+  "provider"?: "greenhouse" | "lever" | "ashby" | "workday" | "smartrecruiters" | "workable" | "recruitee" | "rippling" | "personio" | "teamtailor" | "oracle" | "ukg" | "icims" | "eightfold";
   "include_closed"?: boolean;
   "page"?: number;
   "page_size"?: number;
@@ -19558,7 +19653,7 @@ export type DatasetsJobsSearchResponse = CrawloraResponse<ModelDatasetsJobsSearc
 export interface DatasetsJobsSearchParams {
   "q"?: string;
   "company"?: string;
-  "provider"?: string;
+  "provider"?: "greenhouse" | "lever" | "ashby" | "workday" | "smartrecruiters" | "workable" | "recruitee" | "rippling" | "personio" | "teamtailor" | "oracle" | "ukg" | "icims" | "eightfold";
   "department"?: string;
   "location"?: string;
   "employment_type"?: string;
@@ -23456,6 +23551,34 @@ export interface TcdbTopSetsParams {
   "limit"?: number;
 }
 
+export type ThreadsPostResponse = CrawloraResponse<ModelThreadsPostResponseDoc>;
+export interface ThreadsPostParams {
+  "username": string;
+  "code": string;
+}
+
+export type ThreadsPostRepliesResponse = CrawloraResponse<ModelThreadsRepliesResponseDoc>;
+export interface ThreadsPostRepliesParams {
+  "username": string;
+  "code": string;
+}
+
+export type ThreadsProfileResponse = CrawloraResponse<ModelThreadsProfileResponseDoc>;
+export interface ThreadsProfileParams {
+  "username": string;
+}
+
+export type ThreadsProfilePostsResponse = CrawloraResponse<ModelThreadsProfilePostsResponseDoc>;
+export interface ThreadsProfilePostsParams {
+  "username": string;
+  "cursor"?: string;
+}
+
+export type ThreadsSearchResponse = CrawloraResponse<ModelThreadsSearchResponseDoc>;
+export interface ThreadsSearchParams {
+  "q": string;
+}
+
 export type TiktokCategoryResponse = CrawloraResponse<ModelTiktokCategoryResponseDoc>;
 export interface TiktokCategoryParams {
 }
@@ -25043,6 +25166,14 @@ export interface TcdbService {
   topSets<T = TcdbTopSetsResponse>(params?: TcdbTopSetsParams, options?: import('./index.js').CrawloraRequestOptions): Promise<T>;
 }
 
+export interface ThreadsService {
+  post<T = ThreadsPostResponse>(params: ThreadsPostParams, options?: import('./index.js').CrawloraRequestOptions): Promise<T>;
+  postReplies<T = ThreadsPostRepliesResponse>(params: ThreadsPostRepliesParams, options?: import('./index.js').CrawloraRequestOptions): Promise<T>;
+  profile<T = ThreadsProfileResponse>(params: ThreadsProfileParams, options?: import('./index.js').CrawloraRequestOptions): Promise<T>;
+  profilePosts<T = ThreadsProfilePostsResponse>(params: ThreadsProfilePostsParams, options?: import('./index.js').CrawloraRequestOptions): Promise<T>;
+  search<T = ThreadsSearchResponse>(params: ThreadsSearchParams, options?: import('./index.js').CrawloraRequestOptions): Promise<T>;
+}
+
 export interface TiktokService {
   category<T = TiktokCategoryResponse>(params?: TiktokCategoryParams, options?: import('./index.js').CrawloraRequestOptions): Promise<T>;
   videoComments<T = TiktokVideoCommentsResponse>(params: TiktokVideoCommentsParams, options?: import('./index.js').CrawloraRequestOptions): Promise<T>;
@@ -25250,6 +25381,7 @@ export interface CrawloraGeneratedGroups {
   spotify: SpotifyService;
   steam: SteamService;
   tcdb: TcdbService;
+  threads: ThreadsService;
   tiktok: TiktokService;
   tmdb: TmdbService;
   tripAdvisor: TripAdvisorService;
@@ -25927,6 +26059,11 @@ export interface OperationParamsMap {
   "tcdb-tagged": TcdbTaggedParams;
   "tcdb-team": TcdbTeamParams;
   "tcdb-top-sets": TcdbTopSetsParams;
+  "threads-post": ThreadsPostParams;
+  "threads-post-replies": ThreadsPostRepliesParams;
+  "threads-profile": ThreadsProfileParams;
+  "threads-profile-posts": ThreadsProfilePostsParams;
+  "threads-search": ThreadsSearchParams;
   "tiktok-category": TiktokCategoryParams;
   "tiktok-video-comments": TiktokVideoCommentsParams;
   "tiktok-explore": TiktokExploreParams;
@@ -26712,6 +26849,11 @@ export interface OperationResponseMap {
   "tcdb-tagged": TcdbTaggedResponse;
   "tcdb-team": TcdbTeamResponse;
   "tcdb-top-sets": TcdbTopSetsResponse;
+  "threads-post": ThreadsPostResponse;
+  "threads-post-replies": ThreadsPostRepliesResponse;
+  "threads-profile": ThreadsProfileResponse;
+  "threads-profile-posts": ThreadsProfilePostsResponse;
+  "threads-search": ThreadsSearchResponse;
   "tiktok-category": TiktokCategoryResponse;
   "tiktok-video-comments": TiktokVideoCommentsResponse;
   "tiktok-explore": TiktokExploreResponse;
@@ -27497,6 +27639,11 @@ export interface OperationRequiredParamsMap {
   "tcdb-tagged": false;
   "tcdb-team": false;
   "tcdb-top-sets": false;
+  "threads-post": true;
+  "threads-post-replies": true;
+  "threads-profile": true;
+  "threads-profile-posts": true;
+  "threads-search": true;
   "tiktok-category": false;
   "tiktok-video-comments": true;
   "tiktok-explore": true;
@@ -28289,6 +28436,11 @@ export type OperationIdLiteral =
   | "tcdb-tagged"
   | "tcdb-team"
   | "tcdb-top-sets"
+  | "threads-post"
+  | "threads-post-replies"
+  | "threads-profile"
+  | "threads-profile-posts"
+  | "threads-search"
   | "tiktok-category"
   | "tiktok-video-comments"
   | "tiktok-explore"
@@ -29070,6 +29222,11 @@ export declare const OperationIds: Readonly<{
   TcdbTagged: "tcdb-tagged";
   TcdbTeam: "tcdb-team";
   TcdbTopSets: "tcdb-top-sets";
+  ThreadsPost: "threads-post";
+  ThreadsPostReplies: "threads-post-replies";
+  ThreadsProfile: "threads-profile";
+  ThreadsProfilePosts: "threads-profile-posts";
+  ThreadsSearch: "threads-search";
   TiktokCategory: "tiktok-category";
   TiktokChallenge: "tiktok-challenge";
   TiktokChallengeList: "tiktok-challenge-list";