{"endpoint":{"id":"treg.web.search.news","provider":"treg","provider_display":"treg","name":"web.search.news — routed: best of 4 providers, own keys first","summary":"Search recent news — provider-native article rows in `results`","method":"POST","path":"/web.search.news","scope":"","tier":"core","kind":"routed","domain":"search","call_template":"treg call treg.web.search.news --method POST --data '{\"q\":\"…\"}'","cost":{"type":"per_success","value":0.0,"currency":"USD","per":1,"unit":"call","source":"inferred","confidence":"documented","checked":null,"varies":true,"note":"NOT free: misses are billed too. the children's range $0–$0.008 per hit, 0% markup; you pay the child that served AND every child tried before it that bills a miss (2 of 4 do), up to X-Treg-Route-Max-Cost (default $1 a call). X-Treg-Route-Exclude them, or X-Treg-Route-Waterfall: 0, to pay for one provider only","usd":0.0},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":{"status":200,"means":"output.results == []"},"status":null,"status_note":null,"superseded_by":null,"verified":null,"added":null,"docs_url":"","has_example":false,"input":{"bodyType":"json","body":{"q":{"type":"str","required":false,"note":"identity key (part of q)"},"limit":{"type":"int","required":false,"note":"filter — default 10; maximum compared results; sent upstream where supported"}},"note":"Send everything you know about the subject — treg derives the rest (full_name ⇄ first+last), matches each provider on the variants it accepts ({q}) and sends each provider only the fields it wants. On a miss treg keeps trying providers, cheapest first, within X-Treg-Route-Max-Cost (default $1 per call; misses on per-success providers are free). Options ride as headers, never in the body: X-Treg-Route-Waterfall: 0 (stop at the first miss), X-Treg-Route-Max-Cost: <usd>, X-Treg-Route-Prefer / X-Treg-Route-Exclude: <provider>. The response is {output, raw, _treg: {served_by, tried}}; X-Treg-Served-By names the child."},"test_request":{"body":{"q":"…"}},"routed_children":["exa.web.search.news","search1api.web.news","tavily.web.search.news","tinyfish.web.search.news"],"capability":"web.search.news","capability_description":"Search recent news articles by topic","platform":"web","platform_label":"Open web & SEO data","observed":{"samples":18776,"decided":18776,"ok_rate":0.992,"p50_ms":null,"p95_ms":null,"last_ok_days":0,"hit_rate":null,"hit_samples":0}},"provider":{"service":"treg","display_name":"treg"},"siblings":[{"id":"exa.web.search.news","provider":"exa","provider_display":"Exa","name":"Search news by topic","scope":"any_account","kind":"data","cost":{"type":"per_call","value":7,"currency":"USD","per":1000,"unit":"call","usd":0.007},"platform_eligible":true,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-08-27","params":["query","category","startPublishedDate","endPublishedDate","numResults","includeDomains","contents"],"observed":{"samples":32338,"decided":32150,"ok_rate":1.0,"p50_ms":1032,"p95_ms":5194,"last_ok_days":0,"hit_rate":0.9966,"hit_samples":27268},"reviews":{"teams":10,"share":{"useful":0.84,"partly":0.16,"not_useful":0.0}}},{"id":"octen.web.search.news","provider":"octen","provider_display":"Octen","name":"Search news by query — articles and subjects","scope":"any_account","kind":"data","cost":{"type":"per_call","value":3,"currency":"USD","per":1000,"unit":"call","octen_rates":{"call":0.003,"full_content_extra":0.0005},"usd":0.003},"platform_eligible":true,"status":null,"status_note":null,"superseded_by":null,"verified":null,"params":["query","count","include_domains","exclude_domains","time_basis","time_range","start_time","end_time","language","highlight","full_content","subjects"],"observed":{"samples":490,"decided":481,"ok_rate":1.0,"p50_ms":425,"p95_ms":573,"last_ok_days":0,"hit_rate":null,"hit_samples":0},"reviews":{"teams":0}},{"id":"search1api.web.news","provider":"search1api","provider_display":"Search1API","name":"Search recent news","scope":"any_account","kind":"data","cost":{"type":"per_success","value":1,"currency":"credit","unit":"call","usd":0.001},"platform_eligible":true,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-09-30","params":["query","search_service","max_results","image","include_sites","exclude_sites","language","time_range"],"observed":{"samples":3738,"decided":3731,"ok_rate":0.956,"p50_ms":2214,"p95_ms":4662,"last_ok_days":0,"hit_rate":0.8722,"hit_samples":3553},"reviews":{"teams":0}},{"id":"search1api.web.news.crawl","provider":"search1api","provider_display":"Search1API","name":"Search news with full page content","scope":"any_account","kind":"data","cost":{"type":"per_success","value":1,"currency":"credit","unit":"call","usd":0.001},"platform_eligible":false,"status":null,"status_note":null,"superseded_by":null,"verified":null,"params":["query","max_results","crawl_results","search_service","time_range"],"observed":{"samples":1,"decided":1,"ok_rate":null,"p50_ms":null,"p95_ms":null,"last_ok_days":null,"hit_rate":null,"hit_samples":0}},{"id":"tavily.web.search.news","provider":"tavily","provider_display":"Tavily","name":"Search recent news","scope":"any_account","kind":"data","cost":{"type":"per_call","value":1,"currency":"credit","unit":"call","tavily_rates":{"basic":1,"fast":1,"ultra_fast":1,"advanced":2},"usd":0.008},"platform_eligible":true,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-10-05","params":["query","topic","max_results","search_depth","include_usage"],"observed":{"samples":550,"decided":536,"ok_rate":1.0,"p50_ms":1590,"p95_ms":4896,"last_ok_days":0,"hit_rate":0.9967,"hit_samples":300}},{"id":"tinyfish.web.search.news","provider":"tinyfish","provider_display":"TinyFish","name":"Search recent news","scope":"any_account","kind":"data","cost":{"type":"free","value":0,"currency":"USD","unit":"call","usd":0.0},"platform_eligible":true,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-09-23","params":["query","domain_type","purpose","location","language","include_domains","exclude_domains","after_date","before_date","recency_minutes","page","include_thumbnail","fetch"],"observed":{"samples":209531,"decided":201873,"ok_rate":0.9982,"p50_ms":1550,"p95_ms":5770,"last_ok_days":0,"hit_rate":0.7641,"hit_samples":183200},"reviews":{"teams":25,"share":{"useful":0.46,"partly":0.33,"not_useful":0.2}}}],"related_capabilities":[{"endpoint_id":"treg.web.anchors.list","capability":"web.anchors.list","does":"List the anchor texts used"},{"endpoint_id":"treg.web.backlinks.list","capability":"web.backlinks.list","does":"List individual backlinks to a target"},{"endpoint_id":"treg.web.backlinks.summary","capability":"web.backlinks.summary","does":"Backlink profile of a domain or URL"},{"endpoint_id":"treg.web.extract","capability":"web.extract","does":"Extract clean content from web pages"},{"endpoint_id":"treg.web.extract.structured","capability":"web.extract.structured","does":"Extract typed JSON from one web page"}],"routing":{"contract":{"identity":[["q"]],"output":{"results":{"type":"list","required":true,"note":"the provider's own ranked news articles"},"count":{"type":"int"}},"miss":"results == []","derive":{}},"plan":[{"endpoint_id":"tinyfish.web.search.news","accepts":[["q"]],"usd":0.0,"hit_rate":0.7641,"usd_per_hit":0.0,"works":0.9982},{"endpoint_id":"search1api.web.news","accepts":[["q"]],"usd":0.001,"hit_rate":0.8722,"usd_per_hit":0.001,"works":0.956},{"endpoint_id":"exa.web.search.news","accepts":[["q"]],"usd":0.007,"hit_rate":0.9966,"usd_per_hit":0.0070238811960666265,"works":1.0},{"endpoint_id":"tavily.web.search.news","accepts":[["q"]],"usd":0.008,"hit_rate":0.9967,"usd_per_hit":0.008026487408447879,"works":1.0}],"also":[{"endpoint_id":"octen.web.search.news","usd":0.003},{"endpoint_id":"search1api.web.news.crawl","usd":0.001}],"headers":{"X-Treg-Route-Waterfall":"on by default: a miss tries the next provider; 0 = stop at the first miss","X-Treg-Route-Max-Cost":"USD ceiling for the whole call (default 1.00)","X-Treg-Route-Prefer":"provider[,…]","X-Treg-Route-Exclude":"provider[,…]","X-Treg-Route-Strict-Filters":"1 = never call a provider that cannot apply a filter you sent (answers 422, nothing charged); off by default — the answer names what was ignored in X-Treg-Ignored-Filters"}},"call_template":"treg call treg.web.search.news --method POST --data '{\"q\":\"…\"}'","example_response":null,"hints":["treg call treg.web.search.news --method POST --data '{\"q\":\"…\"}'   # run it — key injected server-side","treg catalog get exa.web.search.news   # the same job from exa"]}