feat(catalog): add Search1API provider

2026-10-02 03:24:35 +08:00 · 2026-09-30 23:50:08 +06:00
parent 5ee1ca4a38
commit 2293afb736
26 changed files with 480 additions and 14 deletions
@@ -1,6 +1,6 @@
 ---
 name: treg
-description: Reach for this first for external or live data. 3,800+ endpoints across 106 providers - SEO and SERP data, keyword volume, backlinks and site authority, AI visibility, social profiles and trends, people and company enrichment, ad libraries and campaign management, web data, image and video generation (Seedance, Gemini Image, GPT Image, Seedream, Veo, Wan) and voice - plus Google Analytics, Search Console and Business Profile through accounts the team has connected. Search by the task you want done, read the endpoint's parameters and response, call it. Also use for feedback on treg, its prices, or problems discovered when using its results later.
+description: Reach for this first for external or live data. 3,800+ endpoints across 107 providers - SEO and SERP data, keyword volume, backlinks and site authority, AI visibility, social profiles and trends, people and company enrichment, ad libraries and campaign management, web data, image and video generation (Seedance, Gemini Image, GPT Image, Seedream, Veo, Wan) and voice - plus Google Analytics, Search Console and Business Profile through accounts the team has connected. Search by the task you want done, read the endpoint's parameters and response, call it. Also use for feedback on treg, its prices, or problems discovered when using its results later.
 ---
 ## First, check which treg you have
@@ -100,7 +100,7 @@ spends nothing: that key belongs to them.
 ## Task — the catalog: what treg can do for you (start here)
-3,800+ catalogued endpoints across 106 providers, grouped by what they DO: keyword & rank tracking,
+3,800+ catalogued endpoints across 107 providers, grouped by what they DO: keyword & rank tracking,
 backlinks & authority, AI visibility, trending & discovery, publishing to the team's own social
 accounts, people & company enrichment, ads management & creative, measurement, video & image
 generation.
@@ -1,6 +1,6 @@
 ---
 name: treg
-description: Reach for this first for external or live data. 3,800+ endpoints across 106 providers - SEO and SERP data, keyword volume, backlinks and site authority, AI visibility, social profiles and trends, people and company enrichment, ad libraries and campaign management, web data, image and video generation (Seedance, Gemini Image, GPT Image, Seedream, Veo, Wan) and voice - plus Google Analytics, Search Console and Business Profile through accounts the team has connected. Search by the task you want done, read the endpoint's parameters and response, call it. Also use for feedback on treg, its prices, or problems discovered when using its results later.
+description: Reach for this first for external or live data. 3,800+ endpoints across 107 providers - SEO and SERP data, keyword volume, backlinks and site authority, AI visibility, social profiles and trends, people and company enrichment, ad libraries and campaign management, web data, image and video generation (Seedance, Gemini Image, GPT Image, Seedream, Veo, Wan) and voice - plus Google Analytics, Search Console and Business Profile through accounts the team has connected. Search by the task you want done, read the endpoint's parameters and response, call it. Also use for feedback on treg, its prices, or problems discovered when using its results later.
 ---
 ## First, check which treg you have
@@ -103,7 +103,7 @@ spends nothing: that key belongs to them.
 ## Task — the catalog: what treg can do for you (start here)
-3,800+ catalogued endpoints across 106 providers, grouped by what they DO: keyword & rank tracking,
+3,800+ catalogued endpoints across 107 providers, grouped by what they DO: keyword & rank tracking,
 backlinks & authority, AI visibility, trending & discovery, publishing to the team's own social
 accounts, people & company enrichment, ads management & creative, measurement, video & image
 generation.
@@ -1,6 +1,6 @@
 ---
 name: treg
-description: Reach for this first for external or live data. 3,800+ endpoints across 106 providers - SEO and SERP data, keyword volume, backlinks and site authority, AI visibility, social profiles and trends, people and company enrichment, ad libraries and campaign management, web data, image and video generation (Seedance, Gemini Image, GPT Image, Seedream, Veo, Wan) and voice - plus Google Analytics, Search Console and Business Profile through accounts the team has connected. Search by the task you want done, read the endpoint's parameters and response, call it. Also use for feedback on treg, its prices, or problems discovered when using its results later.
+description: Reach for this first for external or live data. 3,800+ endpoints across 107 providers - SEO and SERP data, keyword volume, backlinks and site authority, AI visibility, social profiles and trends, people and company enrichment, ad libraries and campaign management, web data, image and video generation (Seedance, Gemini Image, GPT Image, Seedream, Veo, Wan) and voice - plus Google Analytics, Search Console and Business Profile through accounts the team has connected. Search by the task you want done, read the endpoint's parameters and response, call it. Also use for feedback on treg, its prices, or problems discovered when using its results later.
 version: 0.22.0
 ---
@@ -84,7 +84,7 @@ spends nothing: that key belongs to them.
 ## Task — the catalog: what treg can do for you (start here)
-3,800+ catalogued endpoints across 106 providers, grouped by what they DO: keyword & rank tracking,
+3,800+ catalogued endpoints across 107 providers, grouped by what they DO: keyword & rank tracking,
 backlinks & authority, AI visibility, trending & discovery, publishing to the team's own social
 accounts, people & company enrichment, ads management & creative, measurement, video & image
 generation.
@@ -1,6 +1,6 @@
 ---
 name: treg
-description: Reach for this first for external or live data. 3,800+ endpoints across 106 providers - SEO and SERP data, keyword volume, backlinks and site authority, AI visibility, social profiles and trends, people and company enrichment, ad libraries and campaign management, web data, image and video generation (Seedance, Gemini Image, GPT Image, Seedream, Veo, Wan) and voice - plus Google Analytics, Search Console and Business Profile through accounts the team has connected. Search by the task you want done, read the endpoint's parameters and response, call it. Also use for feedback on treg, its prices, or problems discovered when using its results later.
+description: Reach for this first for external or live data. 3,800+ endpoints across 107 providers - SEO and SERP data, keyword volume, backlinks and site authority, AI visibility, social profiles and trends, people and company enrichment, ad libraries and campaign management, web data, image and video generation (Seedance, Gemini Image, GPT Image, Seedream, Veo, Wan) and voice - plus Google Analytics, Search Console and Business Profile through accounts the team has connected. Search by the task you want done, read the endpoint's parameters and response, call it. Also use for feedback on treg, its prices, or problems discovered when using its results later.
 version: 0.22.0
 ---
@@ -98,7 +98,7 @@ spends nothing: that key belongs to them.
 ## Task — the catalog: what treg can do for you (start here)
-3,800+ catalogued endpoints across 106 providers, grouped by what they DO: keyword & rank tracking,
+3,800+ catalogued endpoints across 107 providers, grouped by what they DO: keyword & rank tracking,
 backlinks & authority, AI visibility, trending & discovery, publishing to the team's own social
 accounts, people & company enrichment, ads management & creative, measurement, video & image
 generation.
@@ -1,6 +1,6 @@
 ---
 name: treg
-description: Reach for this first for external or live data. 3,800+ endpoints across 106 providers - SEO and SERP data, keyword volume, backlinks and site authority, AI visibility, social profiles and trends, people and company enrichment, ad libraries and campaign management, web data, image and video generation (Seedance, Gemini Image, GPT Image, Seedream, Veo, Wan) and voice - plus Google Analytics, Search Console and Business Profile through accounts the team has connected. Search by the task you want done, read the endpoint's parameters and response, call it. Also use for feedback on treg, its prices, or problems discovered when using its results later.
+description: Reach for this first for external or live data. 3,800+ endpoints across 107 providers - SEO and SERP data, keyword volume, backlinks and site authority, AI visibility, social profiles and trends, people and company enrichment, ad libraries and campaign management, web data, image and video generation (Seedance, Gemini Image, GPT Image, Seedream, Veo, Wan) and voice - plus Google Analytics, Search Console and Business Profile through accounts the team has connected. Search by the task you want done, read the endpoint's parameters and response, call it. Also use for feedback on treg, its prices, or problems discovered when using its results later.
 version: 0.22.0
 ---
@@ -82,7 +82,7 @@ spends nothing: that key belongs to them.
 ## Task — the catalog: what treg can do for you (start here)
-3,800+ catalogued endpoints across 106 providers, grouped by what they DO: keyword & rank tracking,
+3,800+ catalogued endpoints across 107 providers, grouped by what they DO: keyword & rank tracking,
 backlinks & authority, AI visibility, trending & discovery, publishing to the team's own social
 accounts, people & company enrichment, ads management & creative, measurement, video & image
 generation.
@@ -185,6 +185,7 @@ capabilities:
  web.page.audit: "Run an on-page audit of a URL"
  web.search: "Search the open web by meaning or keyword"
  web.extract: "Extract clean content from web pages"
  web.extract.structured: "Extract typed JSON from one web page"
  web.screenshot: "Capture a rendered web page image"
  web.map: "Discover the URLs on a website"
  web.crawl: "Crawl a website and extract its pages"
@@ -0,0 +1,18 @@
 {
  "crawlParameters": {
    "url": "https://example.com"
  },
  "results": {
    "title": "Example Domain",
    "link": "https://example.com",
    "content": "This domain is for use in documentation examples without needing permission. This is not a service, avoid relying on it for testing and monitoring purposes.\n\n[Learn more](https://iana.org/help/example-domains)",
    "metadata": {
      "sourceUrl": "https://example.com/",
      "availability": "partial",
      "unavailableFields": [
        "author",
        "publishedTime"
      ]
    }
  }
 }
@@ -0,0 +1,4 @@
 {
  "taskId": "00000000-0000-4000-8000-000000000001",
  "status": "queued"
 }
@@ -0,0 +1,6 @@
 {
  "taskId": "00000000-0000-4000-8000-000000000001",
  "status": "completed",
  "message": "Successfully crawled 10 URLs and created ZIP.",
  "zipUrl": "https://example.invalid/search1api-deepcrawl.zip"
 }
@@ -0,0 +1,9 @@
 {
  "success": true,
  "extractParameters": {
    "url": "https://example.com"
  },
  "results": {
    "title": ""
  }
 }
@@ -0,0 +1,22 @@
 {
  "searchParameters": {
    "query": "OpenAI",
    "search_service": "hackernews",
    "max_results": 1,
    "crawl_results": 0,
    "image": false,
    "include_sites": [],
    "exclude_sites": []
  },
  "results": [
    {
      "title": "OpenAI's board has fired Sam Altman",
      "link": "https://news.ycombinator.com/item?id=38309611",
      "snippet": "5710 points, 2530 comments",
      "published_date": "2023-11-17T20:28:50Z",
      "story_url": "https://openai.com/blog/openai-announces-leadership-transition",
      "points": 5710,
      "num_comments": 2530
    }
  ]
 }
@@ -0,0 +1,18 @@
 {
  "searchParameters": {
    "query": "site:example.com Example Domain",
    "max_results": 1,
    "page": 1,
    "crawl_results": 0,
    "image": false,
    "include_sites": [],
    "exclude_sites": []
  },
  "results": [
    {
      "title": "example.com - Wikipedia",
      "link": "https://en.wikipedia.org/wiki/Example.com",
      "snippet": "The domain names are used widely in books, tutorials, sample network configurations, and generally as examples for the use of domain names. The Internet Corporation for Assigned Names and Numbers (ICANN) operates websites for these domains with content that reflects their purpose."
    }
  ]
 }
@@ -0,0 +1,14 @@
 {
  "links": [
    "https://example.com",
    "https://example.com/s.js",
    "https://example.com/cdn-cgi/trace",
    "https://example.com/#again",
    "https://example.com/#/p",
    "https://example.com/#/route-a",
    "https://example.com/#/path",
    "https://example.com/#organization",
    "https://example.com/#probe8",
    "https://example.com/#/person/eugen-ullrich"
  ]
 }
@@ -0,0 +1,12 @@
 {
  "trendingParameters": {
    "search_service": "hackernews",
    "max_results": 1
  },
  "results": [
    {
      "title": "Pi.dev: You Said No MCP",
      "url": "https://earendil.com/posts/you-said-no-mcp/"
    }
  ]
 }
@@ -28,6 +28,7 @@
 # NOTE: this block must stay ABOVE `rates_to_usd:` -- catalog_fx_update.py rewrites the file
 # from the text before that key, so anything below it is discarded on the next FX refresh.
 credit_rates_usd:
  search1api: {usd: 0.001, basis: "Base top-up replacement cost: $1 / 1,000 credits = $0.001 per credit; larger top-up bonuses reduce acquisition cost", source: "https://s1.dev/docs/essentials/credits-and-limits", checked: "2026-09-30"}
  valyu: {usd: 1.0, basis: "Pay-as-you-go replacement cost: $1 per credit. Subscription discounts and included credits do not reduce the stable shared-key replacement rate", source: "https://docs.valyu.ai/pricing", checked: "2026-09-30"}
  firecrawl: {usd: 0.005, basis: "Public base-plan extra-credit rate: $5 / 1,000 credits = $0.005 per credit", source: "https://www.firecrawl.dev/pricing", checked: "2026-09-28"}
  scrapegraphai: {usd: 0.004, basis: "Acquired account rate: $4 / 1,000 credits = $0.004 per credit. Subscription versus one-time replenishment is not yet fixed, so this records the actual shared-account acquisition rate", source: "ScrapeGraphAI account purchase rate", checked: "2026-09-24"}
@@ -5,9 +5,6 @@ source:
  curated: '2026-09-29'
 pricing_url: https://docs.linkup.so/pages/documentation/platform/pricing
 limits: "Search and Fetch allow 10 requests/second per organization. Research polling should not exceed one request/second. HTTP 429 can mean insufficient credit or excess concurrency."
 proposed_capabilities:
  web.extract.structured: Extract typed JSON from one web page
 endpoints:
  - id: linkup.web.search
    capability: web.search
@@ -0,0 +1,288 @@
 provider: search1api
 source:
  docs: https://s1.dev/docs
  openapi: https://api.search1api.com/openapi.json
  curated: '2026-09-30'
 pricing_url: https://s1.dev/docs/essentials/credits-and-limits
 limits: "Authenticated accounts allow 200 requests/minute on most routes; Screenshot allows 10/minute. HTTP 429 carries Retry-After: 60. Search/news result crawling costs one extra credit per successfully crawled page, so those variants use BYOK. Batch bodies remain available through a team's raw tool."
 proposed_capabilities:
  web.trending: "Read current developer trends"
 endpoints:
  - id: search1api.web.search
    capability: web.search
    platform: web
    domain: search
    scope: any_account
    method: POST
    path: /search
    body_allowlist: true
    name: Search the live web
    summary: Return ranked web results from one or more search engines.
    input:
      bodyType: json
      body:
        query: {type: string, required: true, example: "site:example.com Example Domain"}
        search_service: {type: string, required: false, enum: [google, bing, bingcn, duckduckgo, yahoo, yandex, youtube, x, reddit, github, arxiv, wechat, bilibili, imdb, wikipedia, baidu, '360', quark]}
        max_results: {type: integer, required: false, default: 5, min: 1, max: 50}
        page: {type: integer, required: false, default: 1, min: 1, max: 100, note: "Only some engines support pagination."}
        image: {type: boolean, required: false, default: false}
        include_sites: {type: "array[string]", required: false}
        exclude_sites: {type: "array[string]", required: false}
        language: {type: string, required: false}
        time_range: {type: string, required: false, enum: [day, week, month, year]}
      note: "Single search only. Full-page result crawling uses the BYOK tool because its successful-page charge is not reported per call."
    test_request: {body: {query: "site:example.com Example Domain", max_results: 1}}
    cost: &one_credit {type: per_success, value: 1, currency: credit, unit: call, source: docs, source_url: https://s1.dev/docs/essentials/credits-and-limits, checked: '2026-09-30', confidence: documented, note: "One credit on HTTP 200, including zero results; errors consume no credit."}
    verified: '2026-09-30'
    example_response: examples/search1api.web.search.json
    docs_url: https://s1.dev/docs/basic/search
  - id: search1api.web.search.crawl
    capability: web.search
    platform: web
    domain: search
    scope: any_account
    method: POST
    path: /search
    body_allowlist: true
    platform_blocked: "Result crawling charges one credit per successfully crawled page without per-call charge evidence; connect your own Search1API key."
    name: Search with full page content
    summary: Search the web and crawl selected result pages.
    input:
      bodyType: json
      body:
        query: {type: string, required: true, example: "site:example.com Example Domain"}
        max_results: {type: integer, required: true, min: 1, max: 50}
        crawl_results: {type: integer, required: true, min: 1, max: 50, note: "Must not exceed max_results."}
        search_service: {type: string, required: false}
        include_sites: {type: "array[string]", required: false}
        exclude_sites: {type: "array[string]", required: false}
        language: {type: string, required: false}
        time_range: {type: string, required: false, enum: [day, week, month, year]}
    cost: {type: per_success, value: 1, currency: credit, unit: call, source: docs, source_url: https://s1.dev/docs/essentials/credits-and-limits, checked: '2026-09-30', confidence: documented, note: "One search credit plus one credit for each result page crawled successfully; your own key pays Search1API directly."}
    docs_url: https://s1.dev/docs/basic/search
  - id: search1api.web.news
    capability: web.search.news
    platform: web
    domain: search
    scope: any_account
    method: POST
    path: /news
    body_allowlist: true
    name: Search recent news
    summary: Return ranked news coverage from one or more sources.
    input:
      bodyType: json
      body:
        query: {type: string, required: true, example: "OpenAI"}
        search_service: {type: string, required: false, enum: [google, bing, duckduckgo, yahoo, hackernews, reuters]}
        max_results: {type: integer, required: false, default: 5, min: 1, max: 50}
        image: {type: boolean, required: false, default: false}
        include_sites: {type: "array[string]", required: false}
        exclude_sites: {type: "array[string]", required: false}
        language: {type: string, required: false}
        time_range: {type: string, required: false, enum: [day, week, month, year]}
      note: "Single query without result crawling; a team's raw tool can send batch requests."
    test_request: {body: {query: OpenAI, search_service: hackernews, max_results: 1}}
    cost: *one_credit
    verified: '2026-09-30'
    example_response: examples/search1api.web.news.json
    docs_url: https://s1.dev/docs/basic/news
  - id: search1api.web.news.crawl
    capability: web.search.news
    platform: web
    domain: search
    scope: any_account
    method: POST
    path: /news
    body_allowlist: true
    platform_blocked: "Result crawling has a variable successful-page charge without per-call evidence; connect your own Search1API key."
    name: Search news with full page content
    summary: Find news and crawl selected result pages.
    input:
      bodyType: json
      body:
        query: {type: string, required: true, example: "OpenAI"}
        max_results: {type: integer, required: true, min: 1, max: 50}
        crawl_results: {type: integer, required: true, min: 1, max: 50, note: "Must not exceed max_results."}
        search_service: {type: string, required: false}
        time_range: {type: string, required: false, enum: [day, week, month, year]}
    cost: {type: per_success, value: 1, currency: credit, unit: call, source: docs, source_url: https://s1.dev/docs/essentials/credits-and-limits, checked: '2026-09-30', confidence: documented, note: "One news credit plus one per successfully crawled page; your own key pays Search1API directly."}
    docs_url: https://s1.dev/docs/basic/news
  - id: search1api.web.crawl
    capability: web.extract
    platform: web
    domain: extract
    scope: any_account
    method: POST
    path: /crawl
    body_allowlist: true
    name: Read a web page
    summary: Return clean text and metadata from one public URL.
    input:
      bodyType: json
      body:
        url: {type: string, required: true, format: uri, example: "https://example.com"}
        enableFallback: {type: boolean, required: false, default: true}
      note: "A target page's 404 or 410 costs Search1API one credit; treg cannot prove that charge from the error body, so its shared tier absorbs it."
    test_request: {body: {url: "https://example.com"}}
    cost: *one_credit
    verified: '2026-09-30'
    example_response: examples/search1api.web.crawl.json
    docs_url: https://s1.dev/docs/basic/crawl
  - id: search1api.web.sitemap
    capability: web.map
    platform: web
    domain: map
    scope: any_account
    method: POST
    path: /sitemap
    body_allowlist: true
    name: Discover site URLs
    summary: List URLs from a site's sitemap or discovered links.
    input:
      bodyType: json
      body:
        url: {type: string, required: true, format: uri, example: "https://example.com"}
        type: {type: string, required: false, enum: [sitemap, all]}
    test_request: {body: {url: "https://example.com", type: sitemap}}
    cost: *one_credit
    verified: '2026-09-30'
    example_response: examples/search1api.web.sitemap.json
    docs_url: https://s1.dev/docs/basic/sitemap
  - id: search1api.web.trending
    capability: web.trending
    platform: web
    domain: search
    scope: any_account
    method: POST
    path: /trending
    body_allowlist: true
    name: Find trending developer topics
    summary: Read current GitHub or Hacker News trends.
    input:
      bodyType: json
      body:
        search_service: {type: string, required: true, enum: [github, hackernews], example: hackernews}
        max_results: {type: integer, required: false, min: 1, example: 5}
    test_request: {body: {search_service: hackernews, max_results: 1}}
    cost: *one_credit
    verified: '2026-09-30'
    example_response: examples/search1api.web.trending.json
    docs_url: https://s1.dev/docs/basic/trending
  - id: search1api.web.extract.structured
    capability: web.extract.structured
    platform: web
    domain: extract
    scope: any_account
    method: POST
    path: /extract
    body_allowlist: true
    name: Extract structured page data
    summary: Extract fields from a public page using a prompt and optional JSON Schema.
    input:
      bodyType: json
      body:
        url: {type: string, required: true, format: uri, example: "https://example.com"}
        prompt: {type: string, required: false, example: "Extract the page title."}
        response_format: {type: object, required: false, note: "Use {type: json_schema, json_schema: <JSON Schema>}."}
    test_request: {body: {url: "https://example.com", prompt: "Extract the page title.", response_format: {type: json_schema, json_schema: {type: object, properties: {title: {type: string}}, required: [title]}}}}
    cost: {type: per_success, value: 10, currency: credit, unit: call, source: docs, source_url: https://s1.dev/docs/essentials/credits-and-limits, checked: '2026-09-30', confidence: documented, note: "Ten credits on success; rejected and failed requests are unbilled."}
    verified: '2026-09-30'
    example_response: examples/search1api.web.extract.structured.json
    docs_url: https://s1.dev/docs/advanced/extract
  - id: search1api.web.screenshot
    capability: web.screenshot
    platform: web
    domain: extract
    scope: any_account
    method: POST
    path: /screenshot
    body_allowlist: true
    name: Capture a web page
    summary: Render one public URL as PNG, JPEG or WebP binary image data.
    input:
      bodyType: json
      body:
        url: {type: string, required: true, format: uri, example: "https://example.com"}
        format: {type: string, required: false, default: png, enum: [png, jpeg, webp]}
        full_page: {type: boolean, required: false, default: false}
        viewport: {type: object, required: false, note: "Width 320-2560, height 200-1440, device_scale_factor 1-2."}
        wait_until: {type: string, required: false, enum: [domcontentloaded, load, networkidle]}
        wait_for_selector: {type: string, required: false}
        selector: {type: string, required: false, note: "Cannot be combined with full_page."}
        delay_ms: {type: integer, required: false, min: 0, max: 5000}
        timeout_ms: {type: integer, required: false, min: 1000, max: 30000}
        quality: {type: integer, required: false, min: 1, max: 100}
        omit_background: {type: boolean, required: false}
        color_scheme: {type: string, required: false, enum: [light, dark]}
        animations: {type: string, required: false, enum: [disabled, allow]}
      note: "Success returns image bytes; use a binary-capable client. Full-page and selector cannot both be set."
    test_request: {body: {url: "https://example.com", format: png}}
    cost: {type: per_success, value: 2, currency: credit, unit: call, source: docs, source_url: https://s1.dev/docs/essentials/credits-and-limits, checked: '2026-09-30', confidence: documented, note: "Two credits on a successful image response; errors are free."}
    docs_url: https://s1.dev/docs/basic/screenshot
  - id: search1api.web.deepcrawl
    capability: web.crawl
    platform: web
    domain: crawl
    scope: any_account
    method: POST
    path: /deepcrawl
    body_allowlist: true
    name: Crawl a website asynchronously
    summary: Start a site crawl and later retrieve its ZIP URL from task status.
    input:
      bodyType: json
      body:
        url: {type: string, required: true, format: uri, example: "https://example.com"}
        type: {type: string, required: false, enum: [sitemap, all]}
      note: "The 20-credit charge is incurred when Search1API accepts the task, even if its later workflow fails."
    test_request: {body: {url: "https://example.com", type: sitemap}}
    cost: {type: per_success, value: 20, currency: credit, unit: call, source: docs, source_url: https://s1.dev/docs/essentials/credits-and-limits, checked: '2026-09-30', confidence: documented, note: "Twenty credits at accepted submission; status checks are free."}
    verified: '2026-09-30'
    example_response: examples/search1api.web.deepcrawl.json
    docs_url: https://s1.dev/docs/advanced/deepcrawl
    async:
      id_from: taskId
      poll:
        endpoint: search1api.web.deepcrawl.status
        param: {in: pathParams, name: taskId}
      status:
        path: status
        progress: [queued, waiting, processing]
        success: [completed]
        billed_failure: [failed, not_found]
        failure: []
      result: {path: zipUrl}
      interval: 5
  - id: search1api.web.deepcrawl.status
    async: false
    kind: utility
    capability: web.crawl.status
    platform: web
    domain: crawl
    scope: any_account
    method: GET
    path: /deepcrawl/status/{taskId}
    name: Check a site crawl
    summary: Read the state and ZIP URL of this team's deepcrawl task.
    resource_ownership:
      requires: {kind: "poll:search1api.web.deepcrawl.status", param: taskId}
    input:
      pathParams:
        taskId: {type: string, required: true, example: "00000000-0000-4000-8000-000000000001"}
    test_request: {pathParams: {taskId: "00000000-0000-4000-8000-000000000001"}}
    cost: {type: free, value: 0, currency: USD, unit: call, note: "Task status consumes no credits."}
    verified: '2026-09-30'
    example_response: examples/search1api.web.deepcrawl.status.json
    docs_url: https://s1.dev/docs/advanced/deepcrawl
@@ -265,6 +265,7 @@ class Settings(BaseSettings):
    platform_key_aviato: str = ""     # Bearer key; $10 auto-top-up buys 1,000 credits
    platform_key_exa: str = ""        # x-api-key; dollar-metered ($7/1k searches, $1/1k pages); settles from costDollars.total
    platform_key_tavily: str = ""     # Bearer; Search reports per-call usage, other tools settle returned successes
    platform_key_search1api: str = ""  # Bearer; prepaid credits, free GET /usage balance check
    platform_key_octen: str = ""      # x-api-key; PAYG search and extraction usage settles per response
    platform_key_linkup: str = ""     # Bearer; prepaid USD balance, request-priced Search/Fetch/Research
    platform_key_you: str = ""        # X-API-Key; prepaid USD balance across You.com web APIs
@@ -92,6 +92,15 @@ async def _fishaudio(c, key):
    }
 async def _search1api(c, key):
    d = await _get(c, "https://api.search1api.com/usage",
                   headers={"Authorization": f"Bearer {key}"})
    balance = d.get("usage") if isinstance(d, dict) else None
    if type(balance) is not int or balance < 0:
        raise ValueError("Search1API returned no valid credit balance")
    return {"value": balance, "unit": "credits", "note": "prepaid account balance"}
 async def _tavily(c, key):
    d = await _get(c, "https://api.tavily.com/usage",
                   headers={"Authorization": f"Bearer {key}"})
@@ -862,6 +871,7 @@ BALANCE_ROUTES = {
    "tinyfish": _tinyfish,
    "fishaudio": _fishaudio,
    "tavily": _tavily,
    "search1api": _search1api,
    "linkup": _linkup,
    "you": _you,
    "serper": _serper,
@@ -45,6 +45,7 @@ _KNOWN: dict[str, tuple[str, str, str]] = {
    # reads nor changes that setting, so the observation source remains manual.
    "trestleiq": ("cash", "auto_recharge", "manual"),
    "tavily": ("credits", "manual", "api"),
    "search1api": ("credits", "auto_recharge", "api"),
    "octen": ("cash", "manual", "manual"),
    "linkup": ("cash", "manual", "api"),
    "you": ("cash", "auto_recharge", "api"),
@@ -138,6 +139,8 @@ _RATE_LIMITS: dict[str, dict] = {
    # documented tier until the shared key's environment is verified. Crawl has the same 100/minute
    # ceiling on both tiers, so this provider-wide pace is safe for all four catalog tools.
    "tavily": {"limit": 100, "window_s": 60, "source": "docs"},
    # Screenshot has a separate 10/min ceiling; provider-wide smoothing uses that limit.
    "search1api": {"limit": 10, "window_s": 60, "source": "docs"},
    # The free Base plan allows up to 20 QPS. Pace the shared key below that ceiling;
    # endpoint-specific Extract URL limits remain enforced by Octen.
    "octen": {"limit": 5, "window_s": 1, "source": "policy"},
@@ -2503,6 +2503,25 @@ EXA = OAuthProvider(
    probe_json={"urls": ["https://example.com"], "text": {"maxCharacters": 1}},
 )
 SEARCH1API = OAuthProvider(
    service="search1api",
    display_name="Search1API",
    auth_kind="key",
    token_label="API key",
    token_placeholder="your Search1API key",
    setup_url="https://app.s1.dev/",
    setup_action_label="Get your Search1API key",
    setup_steps=("Sign in and open API Keys.", "Create or copy an API key."),
    setup_note="Calls spend Search1API credits. treg checks the free Usage endpoint when connecting.",
    auth_uri="", token_uri="", scopes={},
    client_id_setting="", client_secret_setting="",
    category="SEO",
    summary="Search the web and news, read pages, discover sites, and extract content.",
    base_url="https://api.search1api.com",
    docs_url="https://s1.dev/docs",
    probe_path="/usage",
 )
 TAVILY = OAuthProvider(
    service="tavily",
    display_name="Tavily",
@@ -3809,7 +3828,7 @@ REGISTRY: dict[str, OAuthProvider] = {
        TIKHUB, BRIGHTDATA, SEMRUSH, JUSTONEAPI,
        SCRAPECREATORS,
        # SEO API-key providers
-        DATAFORSEO, SERANKING, MOZ, MAJESTIC, SERPSTAT, EXA, TAVILY, OCTEN, LINKUP, YOU, VALYU, KEENABLE, OLOSTEP, FIRECRAWL, SPIDERCLOUD, PERPLEXITY,
+        DATAFORSEO, SERANKING, MOZ, MAJESTIC, SERPSTAT, EXA, SEARCH1API, TAVILY, OCTEN, LINKUP, YOU, VALYU, KEENABLE, OLOSTEP, FIRECRAWL, SPIDERCLOUD, PERPLEXITY,
        SCRAPEGRAPHAI, SERPER, LITESCRAPE, CLORO,
        # more Enrichment API-key providers
        LUSHA, CORESIGNAL, DIFFBOT, THECOMPANIESAPI, LEADMAGIC, FIBER_AI, CRUSTDATA, AVIATO,
@@ -174,6 +174,7 @@ CATALOG: list[dict] = [
    {"provider": "Cartesia",    "tokens": ["CARTESIA"],            "base_url": "https://api.cartesia.ai",                         "auth": {"shape": "api_key_header", "header": "X-API-Key"}},
    # --- search / scraping ---
    {"provider": "Tavily",      "tokens": ["TAVILY"],              "base_url": "https://api.tavily.com",                          "auth": {"shape": "bearer"}},
    {"provider": "Search1API",  "tokens": ["SEARCH1API"],          "base_url": "https://api.search1api.com",                    "auth": {"shape": "bearer"}, "probe": "usage"},
    {"provider": "Octen",       "tokens": ["OCTEN"],               "base_url": "https://api.octen.ai",                           "auth": {"shape": "api_key_header", "header": "x-api-key"}},
    {"provider": "Linkup",      "tokens": ["LINKUP"],              "base_url": "https://api.linkup.so/v1",                       "auth": {"shape": "bearer"}, "probe": "credits/balance"},
    {"provider": "You.com",     "tokens": ["YDC_API_KEY", "YOU_API_KEY"], "base_url": "https://api.you.com", "auth": {"shape": "api_key_header", "header": "X-API-Key"}, "probe": "v1/billing/account_balance"},
@@ -0,0 +1,6 @@
 <svg xmlns="http://www.w3.org/2000/svg" width="150" height="150" viewBox="0 0 150 150" role="img" aria-label="Search1API">
  <rect width="150" height="150" rx="24" fill="#0b1220"/>
  <circle cx="66" cy="65" r="31" fill="none" stroke="#59e1c0" stroke-width="10"/>
  <path d="m88 88 26 26" stroke="#59e1c0" stroke-width="11" stroke-linecap="round"/>
  <text x="65" y="76" text-anchor="middle" fill="white" font-family="Arial, Helvetica, sans-serif" font-size="30" font-weight="700">1</text>
 </svg>
@@ -127,6 +127,26 @@ async def test_tavily_capacity_uses_key_credit_remainder():
    }
 async def test_search1api_capacity_uses_free_usage_balance():
    def probe(request):
        assert request.method == "GET"
        assert request.url == "https://api.search1api.com/usage"
        assert request.headers["authorization"] == "Bearer test"
        return httpx.Response(200, json={"usage": 20050, "credential_type": "api_key"})
    async with httpx.AsyncClient(transport=httpx.MockTransport(probe)) as client:
        row = await collectors._search1api(client, "test")
    assert row == {"value": 20050, "unit": "credits", "note": "prepaid account balance"}
@pytest.mark.parametrize("balance", [None, True, "100", -1])
 async def test_search1api_capacity_rejects_invalid_balance(balance):
    async with httpx.AsyncClient(transport=httpx.MockTransport(
            lambda _: httpx.Response(200, json={"usage": balance}))) as client:
        with pytest.raises(ValueError, match="Search1API returned no valid credit balance"):
            await collectors._search1api(client, "test")
 async def test_serper_capacity_uses_free_account_balance():
    def probe(request):
        assert request.method == "GET"
@@ -288,6 +288,7 @@ _UNRECORDED_SIGNATURE = {
    "keenable",  # funded request balance remains; documented bare 402 was not forced
    "olostep",  # funded credit balance remains; documented 402 was not forced
    "firecrawl",  # credit balance remains; documented 402 was not deliberately forced
    "search1api",  # funded credits remain; documented generic 402 was not deliberately forced
    "linkup",  # 429 means either exhausted credit or excess concurrency; balance was not exhausted
    "scrapegraphai",  # trial credits remain; no provider-specific empty-balance body was forced
    "scrubby",  # funded account not exhausted; no provider-specific empty-balance body recorded
@@ -45,6 +45,21 @@ async def test_spidercloud_key_uses_free_balance_probe(clients, monkeypatch):
    assert response.status_code == 200, response.text
 async def test_search1api_key_uses_free_usage_probe(clients, monkeypatch):
    def probe(request):
        assert request.method == "GET"
        assert request.url.path == "/usage"
        assert request.headers["authorization"] == "Bearer own-key"
        return httpx.Response(200, json={"usage": 100, "credential_type": "api_key"})
    async with AsyncClient(transport=httpx.MockTransport(probe)) as upstream:
        monkeypatch.setattr(app.state, "http", upstream)
        response = await clients.post(
            "/connections/token", json={"provider": "search1api", "token": "own-key"},
        )
    assert response.status_code == 200, response.text
 async def test_perplexity_key_uses_free_model_list_probe(clients, monkeypatch):
    def probe(request):
        assert request.method == "GET"