{"openapi":"3.1.0","info":{"title":"NewsMesh (BYOK) API","version":"0.1.0","description":"NewsMesh (BYOK) lets an AI assistant read your own NewsMesh data through the NewsMesh API with a key you supply (NewsMesh API key). Read-only: 5 tools (get_trending_articles, get_latest_articles, search_articles, search_articles_by_publisher, get_article). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is only ever sent to...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-newsmesh.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-newsmesh/docs"},"termsOfService":"https://connectorbay.com/byok-newsmesh/terms"},"servers":[{"url":"https://byok-newsmesh.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-newsmesh/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/get_trending_articles":{"post":{"operationId":"get_trending_articles","summary":"Get the trending articles from NewsMesh's curated, cached feed, each with category, topics and people mentioned. Use for","description":"Get the trending articles from NewsMesh's curated, cached feed, each with category, topics and people mentioned. Use for \"What is trending in the news right now\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"limit":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"Articles per request: 1 to 10 on the Free and Starter plans, up to 25 on Growth and 50 on Pro (default 10).","title":"Limit"}},"title":"get_trending_articlesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_latest_articles":{"post":{"operationId":"get_latest_articles","summary":"Get the latest articles, optionally by category, by the countries the story is about, or by the country of the news outl","description":"Get the latest articles, optionally by category, by the countries the story is about, or by the country of the news outlet. The plan limits how far back it reaches and may delay articles by up to 24 hours. Use for \"What is the latest business news about the United States\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"category":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Categories, comma separated, at most 10: politics, technology, business, health, entertainment, sports, science, lifestyle, environment or world.","title":"Category"},"country":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Countries the article is about, ISO 3166-1 alpha-2 codes, comma separated, for example 'us,gb'.","title":"Country"},"source_country":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Countries the news outlet is based in, ISO 3166-1 alpha-2 codes, comma separated, for example 'us,gb'.","title":"Source Country"},"limit":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"Articles per request: 1 to 10 on the Free and Starter plans, up to 25 on Growth and 50 on Pro (default 10).","title":"Limit"},"cursor":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Pagination cursor: the next_cursor value from the previous answer.","title":"Cursor"}},"title":"get_latest_articlesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/search_articles":{"post":{"operationId":"search_articles","summary":"Search articles by keyword with phrase, exclusion and AND / OR syntax, date range, category, country and sort order. Use","description":"Search articles by keyword with phrase, exclusion and AND / OR syntax, date range, category, country and sort order. Use for \"What was written about \"climate change\" in September 2026\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"q":{"description":"Search query; supports \"exact phrase\", -exclude, AND and OR, for example 'bitcoin -scam'.","maxLength":500,"title":"Q","type":"string"},"search_in":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Fields to search: title, description.","title":"Search In"},"from_date":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Earliest publication date, YYYY-MM-DD.","title":"From Date"},"to_date":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Latest publication date, YYYY-MM-DD.","title":"To Date"},"category":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Categories, comma separated, at most 10: politics, technology, business, health, entertainment, sports, science, lifestyle, environment or world.","title":"Category"},"country":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Countries the article is about, ISO 3166-1 alpha-2 codes, comma separated, for example 'us,gb'.","title":"Country"},"source_country":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Countries the news outlet is based in, ISO 3166-1 alpha-2 codes, comma separated, for example 'us,gb'.","title":"Source Country"},"sort_by":{"anyOf":[{"enum":["date_descending","date_ascending","relevant"],"type":"string"},{"type":"null"}],"default":null,"description":"Order: date_descending (default), date_ascending or relevant.","title":"Sort By"},"limit":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"Articles per request: 1 to 10 on the Free and Starter plans, up to 25 on Growth and 50 on Pro (default 10).","title":"Limit"},"cursor":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Pagination cursor: the next_cursor value from the previous answer.","title":"Cursor"}},"required":["q"],"title":"search_articlesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/search_articles_by_publisher":{"post":{"operationId":"search_articles_by_publisher","summary":"Search articles from specific publishers by domain (for example nytimes.com,wsj.com), or exclude publishers, optionally ","description":"Search articles from specific publishers by domain (for example nytimes.com,wsj.com), or exclude publishers, optionally with a keyword. Use for \"What did the New York Times and the Wall Street Journal publish about inflation\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"q":{"description":"Search query; supports \"exact phrase\", -exclude, AND and OR.","maxLength":500,"title":"Q","type":"string"},"sources":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Only these publishers, by domain, comma separated, for example 'nytimes.com,wsj.com'.","title":"Sources"},"exclude_sources":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Leave out these publishers, by domain, comma separated.","title":"Exclude Sources"},"from_date":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Earliest publication date, YYYY-MM-DD.","title":"From Date"},"to_date":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Latest publication date, YYYY-MM-DD.","title":"To Date"},"limit":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"Articles per request: 1 to 10 on the Free and Starter plans, up to 25 on Growth and 50 on Pro (default 10).","title":"Limit"},"cursor":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Pagination cursor: the next_cursor value from the previous answer.","title":"Cursor"}},"required":["q"],"title":"search_articles_by_publisherArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_article":{"post":{"operationId":"get_article","summary":"Get one article by its NewsMesh article id (from trending, latest or search results). Use for \"Show me the article with ","description":"Get one article by its NewsMesh article id (from trending, latest or search results). Use for \"Show me the article with id 4c213ea447c9773981780776c9b7399b\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"article_id":{"description":"NewsMesh article id.","maxLength":200,"title":"Article Id","type":"string"}},"required":["article_id"],"title":"get_articleArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}