v1

latestOpenAPI 3.1.0License and Price2026-07-1722542.4 KB

Initialize an intelligent search and return the ID of the task/search for further processing.

Initialize an intelligent search and return the ID of the task/search for further processing.

post/intelligent/search

Query parameters

termstring required

The term must be a strong selector. These selector types are currently supported:

  • Email address
  • Domain, including wildcards like *.example.com
  • URL
  • IPv4 & IPv6
  • CIDRv4 & CIDRv6
  • Phone Number
  • Bitcoin Address
  • MAC Address
  • IPFS Hash
  • UUID
  • Storage ID
  • System ID
  • Simhash
  • Credit card number
  • IBAN Soft selectors (generic terms) are not supported!
maxresultsinteger required
  • Tells how many results to query maximum per bucket.
bucketsstring
timeoutinteger required
  • Set a timeout value for the search. If omitted or set to 0, the default is used.
datefromstring required
  • Set a starting date to begin the search from.
  • Example: 2020-01-01 00:00:00
  • Example: 2020-01-01 12:00:00
datetostring required
  • Set an ending date to finish the search from.
  • Example: 2020-02-02 23:59:59
  • Example: 2020-02-02 00:00:00
sortinteger required
  • Define the way to sort search results.
  • 0: No sorting.
  • 1: X-Score ASC. Least relevant items first.
  • 2: X-Score DESC. Most relevant items first.
  • 3: Date ASC. Oldest items first.
  • 4: Date DESC. Newest items first.
mediainteger required
  • Define the type of media to search for.
  • 0: Not set. (All media types)
  • 1: Paste document
  • 2: Paste User
  • 3: Forum
  • 4: Forum Board
  • 5: Forum Thread
  • 6: Forum Post
  • 7: Forum User
  • 8: Screenshot of a Website
  • 9: HTML copy of a website.
  • 10: Invalid, do not use.
  • 11: Invalid, do not use.
  • 12: Invalid, do not use.
  • 13: Tweet
  • 14: URL, high-level item having HTML copies as linked sub-items
  • 15: PDF document
  • 16: Word document
  • 17: Excel document
  • 18: Powerpoint document
  • 19: Picture
  • 20: Audio file
  • 21: Video file
  • 22: Container files including ZIP, RAR, TAR and others
  • 23: HTML file
  • 24: Text file
lookuplevelinteger

lookuplevel

terminatestring[]

Optional: ID of previous search to terminate to save system resources.

Response

Success search

statusinteger

Result status

idstring

Example response

{
  "id": "61202067-543e-4e6a-8c23-11f9b8f008cf"
}