Search1API文档

Datasets

Answer questions from curated, verified fact datasets, with confidence, corroboration and sources for every fact.

A dataset is a set of facts collected from many sources, checked against each other and scored. Each result is one short fact, together with how relevant it is to your question, how well its sources support it, how many independent sources state it, whether sources disagree about it, and links to those sources. The first dataset is gta6, covering GTA 6 gameplay. Call GET /dataset to see every dataset and when it was last updated.

Ask in natural language and include constraints such as platform or version in the question. Questions in other languages are translated before matching. When found is false, the dataset has no fact that answers the question; the results are only the closest facts, and the request is not charged. An answered query (found: true) costs 1 credit, and listing datasets is free. See Credits and limits for billing rules.

Questions sent to this endpoint, including those asked through the MCP server and the s1.dev tool pages, are stored as text without account, API key or IP address, to improve dataset coverage and quality.

POST
/dataset

Authorization

bearerAuth
headerAuthorizationBearer <token>

Request Body

application/json
  1. body
dataset*string

Dataset to query, for example gta6. GET /dataset lists the available datasets.

Length1 <= length <= 64
query*string

Natural-language question, for example "how do I lose a wanted level fast". Put constraints such as platform or version in the question itself. Non-English questions are translated before matching.

Length1 <= length <= 500
max_results?integer

Maximum facts to return, 1–10; default 5.

Range1 <= value <= 10
Default5

Response Body

Successful response

application/json
  1. response
dataset*string
query*string
query_en?string

The English translation used for matching, for non-English queries.

found*boolean

Whether the best fact answers the query. When false, results are only the closest facts and the request is not charged.

results*array<>
curl -X POST 'https://api.search1api.com/dataset' \  -H 'Content-Type: application/json' \  -d '{  "dataset": "string",  "query": "string"}'
{  "dataset": "string",  "query": "string",  "query_en": "string",  "found": true,  "results": [    {      "id": "string",      "fact": "string",      "question": "string",      "relevance": 0,      "confidence": 0,      "corroborated_by": 0,      "contested": true,      "conflicting_claims": [        "string"      ],      "sources": [        {          "source": "string",          "site": "string",          "url": "string"        }      ],      "attributes": {        "property1": null,        "property2": null      },      "updated_at": "string"    }  ]}

List verified fact datasets

GET
/dataset

Authorization

bearerAuth
headerAuthorizationBearer <token>

Response Body

Successful response

application/json
  1. response
datasets*array<>
curl -X GET 'https://api.search1api.com/dataset'
{  "datasets": [    {      "dataset": "string",      "title": "string",      "description": "string",      "fact_count": 0,      "updated_at": "string",      "stats": {        "by_type": {          "property1": 0,          "property2": 0        },        "by_source": {          "property1": 0,          "property2": 0        },        "multi_source_facts": 0,        "contested_facts": 0      }    }  ]}