searchpipe-tech

searchpipe-tech Extract API

The extract API from searchpipe-tech — 2 operation(s) for extract.

GitHub OpenAPI

Operations 2

POST /extract Extract #
POST /v1/extract Extract #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/searchpipe-tech/openapi/searchpipe-tech-extract-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/searchpipe-tech:searchpipe-tech-extract-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

searchpipe-tech-extract-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: SearchPipe Extract API
  version: 0.2.0
tags:
- name: Extract
paths:
  /extract:
    post:
      tags:
      - Extract
      summary: Extract
      description: '批量抓取 URL 正文：鉴权 → 门禁 → 限流 → 按 URL 扣费 → 并发抓取 → 失败退款。


        计费口径：cost = ceil(len(urls) * extract_credit_per_url)，进抓取前扣；

        部分失败按失败 URL 数退款（同口径向上取整），全部失败全额退；admin/owner

        免扣免退。单 URL 失败不影响整批（落 failed_results，HTTP 仍 200）。'
      operationId: extract_extract_post
      security:
      - HTTPBearer: []
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ExtractRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExtractResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/extract:
    post:
      tags:
      - Extract
      summary: Extract
      description: '批量抓取 URL 正文：鉴权 → 门禁 → 限流 → 按 URL 扣费 → 并发抓取 → 失败退款。


        计费口径：cost = ceil(len(urls) * extract_credit_per_url)，进抓取前扣；

        部分失败按失败 URL 数退款（同口径向上取整），全部失败全额退；admin/owner

        免扣免退。单 URL 失败不影响整批（落 failed_results，HTTP 仍 200）。'
      operationId: extract_v1_extract_post
      security:
      - HTTPBearer: []
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ExtractRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExtractResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ExtractResultItem:
      properties:
        url:
          type: string
          title: Url
        raw_content:
          type: string
          title: Raw Content
      type: object
      required:
      - url
      - raw_content
      title: ExtractResultItem
      description: 抓取成功的单条结果（Tavily extract 风格：url + raw_content）。
    ExtractRequest:
      properties:
        urls:
          items:
            type: string
            maxLength: 2048
          type: array
          maxItems: 20
          minItems: 1
          title: Urls
          description: List of URLs to extract content from (1-20)
      type: object
      required:
      - urls
      title: ExtractRequest
      description: POST /extract 请求体：urls 必填，1..extract_max_urls 条，单条 ≤2048 字符。
    ExtractResponse:
      properties:
        results:
          items:
            $ref: '#/components/schemas/ExtractResultItem'
          type: array
          title: Results
        failed_results:
          items:
            $ref: '#/components/schemas/ExtractFailedItem'
          type: array
          title: Failed Results
      type: object
      title: ExtractResponse
      description: 响应：results 与 failed_results 恒存在（无失败时 failed_results 为空数组）。
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    ExtractFailedItem:
      properties:
        url:
          type: string
          title: Url
        error:
          type: string
          title: Error
      type: object
      required:
      - url
      - error
      title: ExtractFailedItem
      description: '抓取失败的单条结果：error 为机器可读原因（invalid_url:/blocked:/timeout/

        http_<status>/extraction_empty/fetch_error），英文短语可直接展示给调用方。'
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer