{"endpoint":{"id":"treg.web.search.publications","provider":"treg","provider_display":"treg","name":"web.search.publications — routed: best of 2 providers, own keys first","summary":"Search research publications by topic — provider-native paper rows in `results`","method":"POST","path":"/web.search.publications","scope":"","tier":"core","kind":"routed","domain":"search","call_template":"treg call treg.web.search.publications --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.007 per hit, 0% markup; you pay the child that served AND every child tried before it that bills a miss (1 of 2 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"}},"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.publications","tinyfish.web.search.publications"],"capability":"web.search.publications","capability_description":"Search research papers and publications","platform":"web","platform_label":"Open web & SEO data","observed":{"samples":367,"decided":367,"ok_rate":1.0,"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.publications","provider":"exa","provider_display":"Exa","name":"Search research publications","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","numResults","startPublishedDate","includeDomains","contents"],"observed":{"samples":826,"decided":804,"ok_rate":1.0,"p50_ms":579,"p95_ms":1084,"last_ok_days":0,"hit_rate":1.0,"hit_samples":713},"reviews":{"teams":5,"share":{"useful":0.76,"partly":0.24,"not_useful":0.0}}},{"id":"tinyfish.web.search.publications","provider":"tinyfish","provider_display":"TinyFish","name":"Search research publications","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","language","include_domains","exclude_domains","after_date","before_date","pub_year_min","pub_year_max","page","include_thumbnail","fetch"],"observed":{"samples":2058,"decided":1801,"ok_rate":1.0,"p50_ms":972,"p95_ms":3168,"last_ok_days":0,"hit_rate":0.9618,"hit_samples":1074},"reviews":{"teams":5,"share":{"useful":0.25,"partly":0.46,"not_useful":0.29}}}],"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},"count":{"type":"int"}},"miss":"results == []","derive":{}},"plan":[{"endpoint_id":"tinyfish.web.search.publications","accepts":[["q"]],"usd":0.0,"hit_rate":0.9618,"usd_per_hit":0.0,"works":1.0},{"endpoint_id":"exa.web.search.publications","accepts":[["q"]],"usd":0.007,"hit_rate":1.0,"usd_per_hit":0.007,"works":1.0}],"also":[],"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.publications --method POST --data '{\"q\":\"…\"}'","example_response":null,"hints":["treg call treg.web.search.publications --method POST --data '{\"q\":\"…\"}'   # run it — key injected server-side","treg catalog get exa.web.search.publications   # the same job from exa"]}