Web Search

Web results for a query: Google's results page read through the ladder, Bing's when Google refuses. Organic results only -- title, URL, snippet -- each saying which engine it came from.

Waits for the results like a one-URL /scrape -- up to timeout seconds (60 by default, 120 at most), then 202 with the id to poll at GET /search/{id}. scrape hands the results' URLs to a batch, and each result gains its page as it lands. A refused results page is free; the same search within the hour is answered from the last one at no charge.

webhook (a URL, or {url, events, metadata}) is told once how the search ended -- search.completed or search.failed, an answer from the cache included -- signed with webhookSecret, returned here only.

post/api/v1/search

Request

  • Base URL: https://api.mesharc.dev (the document declares no server; this is the origin it was published from)
  • URL: https://api.mesharc.dev/api/v1/search
  • Auth: none declared

Headers

authorizationstring nullable
x-mesharc-tenantstring nullable

Request body

querystring required
limitinteger nullable
sourcesstring[] nullable
pageinteger nullable
countrystring nullable
langstring nullable
freshnessstring nullable
includeDomainsstring[] nullable
excludeDomainsstring[] nullable
timeoutnumber nullable
destinationstring nullable

Response

Successful Response

idstring required
kindstring required
statusstring required
querystring required
paramsobject required
enginestring required
rungstring required
cachedboolean required
batchIdstring nullable
creditsUsedinteger required
nextstring nullable
errorstring required
createdAtstring nullable
finishedAtstring nullable
request_idstring required
webhookSecretstring nullable

Changes

No recorded changes to this operation across all 1 revision of this API.