AnySearchDocs

Search Capabilities API

GET/v1/sub-domains

Discover available capabilities and parameter definitions for one or more known domains. Use the returned sub_domain as the Search tag, fill required parameters, then run a vertical search. Discovery does not consume free or paid search quota.

Request examples

Repeat the domain query parameter. Do not use domains or a comma-separated list.

cURL · Discover code and finance
  1. 1
  2. 2

curl 'https://api.anysearch.com/v1/sub-domains?domain=code&domain=finance' \

-H "Authorization: Bearer YOUR_ANYSEARCH_API_KEY"

Python · Discover code and finance
  1. 1
  2. 2
  3. 3
  4. 4
  5. 5
  6. 6
  7. 7
  8. 8
  9. 9
  10. 10
  11. 11
  12. 12
  13. 13
  14. 14
  15. 15
  16. 16
  17. 17
  18. 18
  19. 19

import os

import requests

​

response = requests.get(

"https://api.anysearch.com/v1/sub-domains?domain=code&domain=finance",

headers={

"Authorization": f"Bearer {os.environ['ANYSEARCH_API_KEY']}",

},

timeout=30,

)

​

if not response.ok:

request_id = response.headers.get("X-Request-ID", "unknown")

raise RuntimeError(

f"Request failed: HTTP {response.status_code}; request_id={request_id}"

)

​

result = response.json()

print(result["data"])

JavaScript · Discover code and finance
  1. 1
  2. 2
  3. 3
  4. 4
  5. 5
  6. 6
  7. 7
  8. 8
  9. 9
  10. 10
  11. 11
  12. 12
  13. 13
  14. 14
  15. 15
  16. 16
  17. 17
  18. 18
  19. 19
  20. 20

const response = await fetch(

"https://api.anysearch.com/v1/sub-domains?domain=code&domain=finance",

{

method: "GET",

headers: {

Authorization: `Bearer ${process.env.ANYSEARCH_API_KEY}`,

},

signal: AbortSignal.timeout(30_000),

}

);

​

if (!response.ok) {

const requestId = response.headers.get("X-Request-ID") ?? "unknown";

throw new Error(

`Request failed: HTTP ${response.status}; request_id=${requestId}`

);

}

​

const result = await response.json();

console.log(result.data);

Go · Discover code and finance
  1. 1
  2. 2
  3. 3
  4. 4
  5. 5
  6. 6
  7. 7
  8. 8
  9. 9
  10. 10
  11. 11
  12. 12
  13. 13
  14. 14
  15. 15
  16. 16
  17. 17
  18. 18
  19. 19
  20. 20
  21. 21
  22. 22
  23. 23
  24. 24
  25. 25
  26. 26
  27. 27
  28. 28
  29. 29
  30. 30
  31. 31
  32. 32
  33. 33
  34. 34
  35. 35
  36. 36
  37. 37
  38. 38
  39. 39
  40. 40
  41. 41
  42. 42
  43. 43
  44. 44
  45. 45
  46. 46
  47. 47
  48. 48
  49. 49
  50. 50

package main

​

import (

"encoding/json"

"fmt"

"net/http"

"os"

"time"

)

​

func main() {

req, err := http.NewRequest(

http.MethodGet,

"https://api.anysearch.com/v1/sub-domains?domain=code&domain=finance",

nil,

)

if err != nil {

panic(err)

}

​

req.Header.Set("Authorization", "Bearer "+os.Getenv("ANYSEARCH_API_KEY"))

​

client := &http.Client{Timeout: 30 * time.Second}

resp, err := client.Do(req)

if err != nil {

panic(err)

}

defer resp.Body.Close()

​

if resp.StatusCode != http.StatusOK {

requestID := resp.Header.Get("X-Request-ID")

if requestID == "" {

requestID = "unknown"

}

​

panic(fmt.Sprintf(

"Request failed: HTTP %d; request_id=%s",

resp.StatusCode, requestID,

))

}

​

var result struct {

Data json.RawMessage `json:"data"`

}

if err := json.NewDecoder(resp.Body).Decode(&result); err != nil {

panic(err)

}

​

fmt.Println(string(result.Data))

}

Rust · Discover code and finance
  1. 1
  2. 2
  3. 3
  4. 4
  5. 5
  6. 6
  7. 7
  8. 8
  9. 9
  10. 10
  11. 11
  12. 12
  13. 13
  14. 14
  15. 15
  16. 16
  17. 17
  18. 18
  19. 19
  20. 20
  21. 21
  22. 22
  23. 23
  24. 24
  25. 25
  26. 26
  27. 27
  28. 28
  29. 29
  30. 30
  31. 31
  32. 32
  33. 33
  34. 34
  35. 35

use reqwest::blocking::Client;

use serde_json::Value;

use std::{env, error::Error, time::Duration};

​

fn main() -> Result<(), Box<dyn Error>> {

let api_key = env::var("ANYSEARCH_API_KEY")?;

​

let client = Client::builder()

.timeout(Duration::from_secs(30))

.build()?;

​

let response = client

.get("https://api.anysearch.com/v1/sub-domains?domain=code&domain=finance")

.bearer_auth(api_key)

.send()?;

​

if !response.status().is_success() {

let request_id = response

.headers()

.get("X-Request-ID")

.and_then(|value| value.to_str().ok())

.unwrap_or("unknown");

​

return Err(format!(

"Request failed: HTTP {}; request_id={request_id}",

response.status().as_u16()

)

.into());

}

​

let result: Value = response.json()?;

println!("{}", result["data"]);

​

Ok(())

}

Capability discovery does not consume free or paid search quota or count as search usage. Requests may still be rate limited.

API Key is optional. These examples include a Key.

Use a discovered capability in Search

  1. Select a known domain, such as domain=finance.
  2. Read data.domains[].sub_domains[].sub_domain as the Search tag.
  3. Fill parameters using params.required and conditions in description.
  4. Submit query, tag and params to POST /v1/search.

Example: turn a discovered finance capability into a search request

After discovering the finance domain, read the finance.quote definition: type is required. Select type=stock and set symbol=AAPL to construct the corresponding Search request.

Request example · POST /v1/search
  1. 1
  2. 2
  3. 3
  4. 4
  5. 5
  6. 6
  7. 7
  8. 8
  9. 9

{

"query": "Apple stock price",

"tag": "finance.quote",

"params": {

"type": "stock",

"symbol": "AAPL"

},

"max_results": 5

}

Read the finance.quote parameter definitions →

General-search tags

The general domain exposes only general.general for general search, with no dedicated params.

A general Search request can omit tag and submit query alone. To specify the general-search tag explicitly, use general.general.

Request parameters

ParameterTypeRequiredFormat and behavior
domainstring[]YesRepeat the query parameter: ?domain=code&domain=finance. Duplicate values do not create duplicate entries.
Unknown domain——HTTP 200 with an empty data.domains array.
Valid request path
  1. 1

GET /v1/sub-domains?domain=code&domain=finance

Response fields

FieldMeaningUse in Search
data.domainsCapabilities grouped by requested domainChoose a domain.
sub_domainsAvailable capability definitionsChoose a capability.
sub_domainComplete capability tagtag
paramsDefinitions keyed by parameter name; may be omitted if emptyparams
params.*.descriptionMeaning, allowed values and conditionsProvide valid values.
params.*.requiredRequired flagCheck for missing values.
params.*.sort_orderDisplay orderSort the fields.
REST response shape · Selected capabilities and parameters
  1. 1
  2. 2
  3. 3
  4. 4
  5. 5
  6. 6
  7. 7
  8. 8
  9. 9
  10. 10
  11. 11
  12. 12
  13. 13
  14. 14
  15. 15
  16. 16
  17. 17
  18. 18
  19. 19
  20. 20
  21. 21
  22. 22
  23. 23
  24. 24
  25. 25
  26. 26
  27. 27
  28. 28
  29. 29
  30. 30
  31. 31
  32. 32
  33. 33
  34. 34
  35. 35
  36. 36
  37. 37
  38. 38
  39. 39
  40. 40
  41. 41
  42. 42
  43. 43

{

"code": 0,

"message": "success",

"request_id": "7d6f4e91-2a83-4c5b-9f10-6e8a3d27b541",

"data": {

"domains": [

{

"domain": "code",

"description": "Developer documentation and code search",

"sub_domains": [

{

"sub_domain": "code.snippet",

"description": "Search real code implementations",

"params": {

"lang": {

"description": "Filter by programming language",

"required": false,

"sort_order": 0

}

}

}

]

},

{

"domain": "finance",

"description": "Financial data and market information",

"sub_domains": [

{

"sub_domain": "finance.quote",

"description": "Real-time and historical quotes",

"params": {

"type": {

"description": "Asset type. Values: stock, forex, crypto, commodity, index, etf",

"required": true,

"sort_order": 0

}

}

}

]

}

]

}

}

Error codes

HTTP status codes and their meanings. error_code is optional; inspect the actual response.

HTTP statusMeaning
400Missing domain query parameter.
429Request rate limit exceeded.
502Unable to load capability definitions.
400 · Missing domain
  1. 1
  2. 2
  3. 3
  4. 4
  5. 5

{

"code": -1,

"message": "At least one domain parameter is required.",

"request_id": "7d6f4e91-2a83-4c5b-9f10-6e8a3d27b541"

}

FAQ

Can I omit domain to read the entire catalog?

The REST endpoint requires at least one domain and returns 400 if it is missing. Select domains from this directory first.

What is the paper-search tag?

The capability definitions use academic.paper. Do not use the older publication.paper example as a confirmed tag.

Does no required flag mean every parameter can always be omitted?

Not necessarily. Read conditions in the description. The flight-status departure field has a required/Optional conflict that is preserved in the definitions.

Can I send the tool’s domains array directly to REST?

No. REST uses repeated domain query parameters. The tool and REST entry points have different outer arguments.