Skip to main content
Search1API logo
  • Category: ai web scraping
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 14
  • Triggers: 0
  • Slug: SEARCH1API
  • Version: 20261101_00

Tools

Slug: SEARCH1API_ASK_RESEARCHRun a natural-language research query across up to five provider-selected engines and return at most 10 deduplicated, reranked results plus partial source errors. Warning: each completed call costs 5 credits.

Input Parameters

string
required
Natural-language research request for Search1API to interpret and route. Platform and time hints can steer source and time-window selection.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEARCH1API_CRAWL_URLSFetch readable content from one or more public URLs. Search1API charges 1 credit for each successful item; a target 404 or 410 is a completed, charged lookup. Batch successes may be unordered, and failed items may be omitted.

Input Parameters

array
required
URLs to crawl. Use one item for one URL. Search1API charges 1 credit for each successful item.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEARCH1API_DISCOVER_SITEMAPDiscover sitemap URLs for a public site, or list all links on one public page without fetching page content. Warning: each completed call costs 1 Search1API credit.

Input Parameters

string
required
Public HTTP(S) site or page URL from which to discover links.
string ("sitemap" | "all")
Discovery mode. sitemap follows declared or conventional sitemaps and falls back to page links; all lists links only from the supplied page, including external hosts.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEARCH1API_EXTRACT_STRUCTURED_DATAExtract caller-defined structured data from one public webpage using an optional prompt and JSON response shape. Warning: each completed call costs 10 Search1API credits.

Input Parameters

string
required
Public HTTP(S) webpage URL from which to extract data.
string
Optional natural-language instructions describing the data to extract.
object
Optional caller-supplied JSON Schema or result shape. Arbitrary object properties are supported.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEARCH1API_GET_DEEPCRAWL_STATUSGet the current state of a deepcrawl task and its packaged result URL when available. Status checks are free; this tool performs one check and does not poll automatically or fetch the result package.

Input Parameters

string
required
Task ID returned by Start Deepcrawl.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEARCH1API_GET_HEALTHRead Search1API’s free provider serving and readiness status. The health endpoint does not validate the configured API key, but this tool requires an API-key connection.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEARCH1API_GET_USAGEReturn the connected account’s remaining Search1API credits and credential metadata. This call is free. The optional period is forwarded as documented, but the returned balance is not period consumption.

Input Parameters

string ("day" | "week" | "month" | "year")
Optional period accepted by Search1API. The returned balance is the current remaining credits, not credits consumed during this period.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEARCH1API_SEARCH_MAPSSearch one Google Maps results page for businesses or places. Each completed page costs 3 Search1API credits, including an empty page; max_results only truncates the response and does not lower the charge.

Input Parameters

integer
Maps results page to fetch. Pages after 1 require location coordinates.
string
required
Place, business, category, or location query.
string
Two-letter country code used to localize Maps results.
string
Result language code, optionally with a region or script suffix.
object
Map center coordinates and zoom. Required when page is greater than 1.
integer
Maximum places returned from this page. Reducing this value does not reduce the 3-credit charge for a completed page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEARCH1API_SEARCH_NEWSSearch recent news for one or more queries with source, site, language, and time filters, returning a typed outcome for each. Each query has a base cost of 1 credit plus 1 credit for each article page successfully fetched through crawl_results. News has no page field and this tool does not auto-paginate.

Input Parameters

array
required
One or more news search queries. Each item is billed at a base cost of 1 credit plus 1 credit for each article page successfully fetched through crawl_results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEARCH1API_SEARCH_WEBSearch the web for one or more queries and return a typed outcome for each. Each query has a base cost of 1 credit plus 1 credit for each result page successfully fetched through crawl_results. The page field selects one native provider page only for Bing, Bing China, Baidu, and Grokipedia; this tool does not auto-paginate.

Input Parameters

array
required
One or more web search queries. Each item is billed at a base cost of 1 credit plus 1 credit for each result page successfully fetched through crawl_results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEARCH1API_START_DEEPCRAWLStart an asynchronous multi-page crawl of a public site and return its task ID. WARNING: each submission creates server-side work and costs 20 Search1API credits. The native API exposes no maximum depth, page or result limit, path filter, or timeout control.

Input Parameters

string
required
Public HTTP(S) site URL to crawl asynchronously. Submitting this request creates a task and costs 20 Search1API credits.
string ("sitemap" | "all")
Optional discovery mode. Omit this field to use provider behavior; the native contract does not assert a default.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEARCH1API_SUBMIT_FEEDBACKCreate external feedback for Search1API about a problem, missing capability, or confusing documentation encountered during a task. Use this tool only when the user explicitly asks to contact Search1API or submit provider feedback. WARNING: this irreversibly stores a non-idempotent external report with the provider and has no retraction endpoint. Never include credentials, PII, or private user content. Do not report every empty result, do not retry the same report automatically, and never let feedback block the primary task. The call is free and limited to 10 submissions per account per minute at a Cloudflare location.

Input Parameters

object
Optional agent identification. Include only non-sensitive agent name or model metadata, never credentials, PII, or private user content.
string
Optional task intent that helps Search1API understand the feedback context (maximum 2000 characters). Exclude credentials, PII, and private user content.
string
required
Feedback message sent to and stored by Search1API (1-4000 characters). This creates external provider feedback and is non-idempotent. Do not include credentials, PII, or private user content. Do not report every empty result, and do not let feedback block the primary task.
string ("bug" | "feature_request" | "docs" | "other")
Feedback category. Defaults to other. Submitting any category creates a non-idempotent external provider report.
string
Optional Search1API request ID for the original problem request (maximum 256 characters). Do not substitute credentials or private content.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEARCH1API_TAKE_SCREENSHOTRender a public webpage as a PNG, JPEG, or WebP file with viewport, readiness, selector, and appearance controls. A successful provider capture costs 2 Search1API credits; a tool failure after capture may still be charged.

Input Parameters

string
required
Public HTTP(S) webpage URL without embedded credentials.
string ("png" | "jpeg" | "webp")
Output image format.
integer
Optional quality for lossy JPEG or WebP output.
integer
Additional delay in milliseconds after readiness conditions are met.
string
Optional CSS selector for an element-only capture; cannot be combined with full_page=true.
object
Browser viewport dimensions and device scale factor.
boolean
Capture the full scrollable page instead of only the viewport; cannot be combined with selector.
string ("disabled" | "allow")
Whether page animations remain enabled during capture.
integer
Maximum provider-side capture time in milliseconds.
string ("domcontentloaded" | "load" | "networkidle")
Page readiness event to wait for before capture.
string ("light" | "dark")
Preferred page color scheme during rendering.
boolean
Whether to omit the default page background when the output format supports transparency.
string
Optional CSS selector that must appear before capture.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not