{
"message": "Max API requests concurrency reached",
"status_code": 429,
"status": "Too many requests"
}
Internal Server Error
{
"message": "Source groups are temporarily unavailable, so this search was not run. Please retry - this request has not been charged.",
"status_code": 503,
"status": "Service unavailable"
}
Source groups
List source groups
Lists the source groups you can search with the source_groups parameter of the Search endpoint. A source group is a ready-made list of publisher domains that the NewsCatcher team builds and maintains for a common use case, such as the top financial news publishers, central banks and regulators, or a region’s business press. Instead of listing dozens of domains in sources, pass the group’s slug. Groups are read-only: you can’t create or edit them, and NewsCatcher may update their domains over time. The response describes each group but does not list its domains. This endpoint requires an API key and does not count toward your plan’s quota.
GET
/
api
/
source-groups
List source groups
curl --request GET \
--url https://v3-api.newscatcherapi.com/api/source-groups \
--header 'x-api-token: <api-key>'
{
"message": "Max API requests concurrency reached",
"status_code": 429,
"status": "Too many requests"
}
Internal Server Error
{
"message": "Source groups are temporarily unavailable, so this search was not run. Please retry - this request has not been charged.",
"status_code": 503,
"status": "Service unavailable"
}
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"newscatcher","colors":{"primary":"#183FD9","light":"#4A90E2","dark":"#04006B"},"logo":{"light":"https://mintcdn.com/newscatcherinc-docs/NcLiyYj9meKksQck/logos/full_black.png?fit=max\u0026auto=format\u0026n=NcLiyYj9meKksQck\u0026q=85\u0026s=20bb812dd269c21260d0753faf2c9831","dark":"https://mintcdn.com/newscatcherinc-docs/NcLiyYj9meKksQck/logos/full_white.png?fit=max\u0026auto=format\u0026n=NcLiyYj9meKksQck\u0026q=85\u0026s=9da57040c94e1feb514d702d71220e3b"},"favicon":"https://mintcdn.com/newscatcherinc-docs/NcLiyYj9meKksQck/logos/favicon.ico?fit=max\u0026auto=format\u0026n=NcLiyYj9meKksQck\u0026q=85\u0026s=707239042f28cefea634ec24d89e70bb","navbar":{"primary":{"type":"button","label":"Get API key","href":"https://platform.newscatcherapi.com"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/newscatcherapi/about","twitter":"https://twitter.com/newscatcherapi"}},"integrations":{"gtm":{"tagId":"GTM-KLCW9GXN"}},"contextual":{"options":["copy","view",{"title":"llms.txt","description":"Open llms.txt for this site","icon":"file","href":"https://www.newscatcherapi.com/docs/llms.txt"},"chatgpt","claude","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"newscatcherinc-docs","hasAudioNarration":false,"actualSubdomain":"newscatcherinc-docs","customDomains":[],"gitSource":{"type":"github","owner":"newscatcher","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aeb74093c05d2162593dbf9","collectionId":"21294f88-e1e7-4ce1-a920-5de7bcf561ab","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aeb74093c05d2162593dbf9"},"feedback":{"thumbs":true,"edits":true,"issues":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aedd9997d3fe39d4f38b8b7","clientVersion":"0.0.4074","searchFilterCounts":[{"language":"default","tag":"API Reference","count":141},{"language":"default","tag":"Web Search API","count":88},{"language":"default","tag":"News API","count":65},{"language":"default","tag":"Agent","count":52},{"language":"default","tag":"Documentation","count":31},{"language":"default","tag":"Get started","count":18},{"language":"default","tag":"How to","count":15},{"language":"default","tag":"Webhooks","count":13},{"language":"default","tag":"Monitors","count":12},{"language":"default","tag":"Local News API","count":11}]},"assistantConfig":{},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"news-api/api-reference/source-groups/list-source-groups-get","slug":"/news-api/api-reference/source-groups/list-source-groups-get","pageMetadata":{"openapi":"news-api-v3 get /api/source-groups","title":"List source groups","description":"Lists the source groups you can search with the `source_groups` parameter of the Search endpoint. A source group is a ready-made list of publisher domains that the NewsCatcher team builds and maintains for a common use case, such as the top financial news publishers, central banks and regulators, or a region's business press. Instead of listing dozens of domains in `sources`, pass the group's `slug`. Groups are read-only: you can't create or edit them, and NewsCatcher may update their domains over time. The response describes each group but does not list its domains. This endpoint requires an API key and does not count toward your plan's quota.\n","href":"/news-api/api-reference/source-groups/list-source-groups-get"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Lists the source groups you can search with the \", _jsx(_components.code, {\n children: \"source_groups\"\n }), \" parameter of the Search endpoint. A source group is a ready-made list of publisher domains that the NewsCatcher team builds and maintains for a common use case, such as the top financial news publishers, central banks and regulators, or a region’s business press. Instead of listing dozens of domains in \", _jsx(_components.code, {\n children: \"sources\"\n }), \", pass the group’s \", _jsx(_components.code, {\n children: \"slug\"\n }), \". Groups are read-only: you can’t create or edit them, and NewsCatcher may update their domains over time. The response describes each group but does not list its domains. This endpoint requires an API key and does not count toward your plan’s quota.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"openapi":"news-api-v3 get /api/source-groups","title":"List source groups","description":"Lists the source groups you can search with the `source_groups` parameter of the Search endpoint. A source group is a ready-made list of publisher domains that the NewsCatcher team builds and maintains for a common use case, such as the top financial news publishers, central banks and regulators, or a region's business press. Instead of listing dozens of domains in `sources`, pass the group's `slug`. Groups are read-only: you can't create or edit them, and NewsCatcher may update their domains over time. The response describes each group but does not list its domains. This endpoint requires an API key and does not count toward your plan's quota.\n","href":"/news-api/api-reference/source-groups/list-source-groups-get"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/newscatcherinc-docs/4995e0e8e19b5719/tracking.js"],"openApiReferenceData":{"operation":{"x-fern-sdk-group-name":"source_groups","x-fern-sdk-method-name":"get","tags":["SourceGroups"],"summary":"List source groups","description":"Lists the source groups you can search with the `source_groups` parameter of the Search endpoint. A source group is a ready-made list of publisher domains that the NewsCatcher team builds and maintains for a common use case, such as the top financial news publishers, central banks and regulators, or a region's business press. Instead of listing dozens of domains in `sources`, pass the group's `slug`. Groups are read-only: you can't create or edit them, and NewsCatcher may update their domains over time. The response describes each group but does not list its domains. This endpoint requires an API key and does not count toward your plan's quota.\n","operationId":"sourceGroupsGet","parameters":["690e5bc6-4a7b-4857-b39b-004598a8a73c","1d9aa0eb-35ba-4fbe-9b13-2275fd36bf94"],"responses":{"200":"1bc55f7e-8f6b-43f4-92b8-f76523d102c6","401":"7767980b-823f-4512-ad6a-1c58756c2e7d","403":"062ca1ad-6cc7-47dd-9be7-154315494c36","422":"0c2ef2e2-df02-4741-8492-79d3044648ff","429":"a5a0c14c-09f4-426b-8fe1-3067646ea25e","500":"4cedb10d-4db2-4791-bdd0-b1f05626cfd6","503":"cc9da2ae-569f-445c-a1ee-669862e245d0"},"method":"get","type":"path","servers":["c6352d96-c6ad-4f24-8410-8487e92fc94b"],"security":["5189df8a-b403-4b02-a930-d7d3428e0119"],"path":"/api/source-groups","baseUrlOptions":["https://v3-api.newscatcherapi.com"],"title":"List source groups","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"690e5bc6-4a7b-4857-b39b-004598a8a73c":{"description":"The page number to return, starting from 1.","name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"example":1,"isRequired":false,"description":"The page number to return, starting from 1.","uniqueKey":"","typeLabel":"integer"}},"1d9aa0eb-35ba-4fbe-9b13-2275fd36bf94":{"description":"The number of source groups per page.","name":"page_size","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500,"default":100,"example":100,"isRequired":false,"description":"The number of source groups per page.","uniqueKey":"","typeLabel":"integer"}}},"responses":{"1bc55f7e-8f6b-43f4-92b8-f76523d102c6":{"description":"A successful response containing one page of source groups.","content":{"application/json":{"schema":{"title":"List Source Groups Response","description":"One page of the source group catalog.","required":["source_groups","total","page","page_size"],"type":"object","properties":{"source_groups":{"title":"Source Groups","description":"The source groups on this page.","type":"array","items":{"title":"Source Group","description":"A ready-made list of publisher domains, curated and maintained by the NewsCatcher team.","required":["slug","name"],"type":"object","properties":{"slug":{"title":"Slug","description":"The identifier to pass to the `source_groups` parameter of the Search endpoint.","type":"string","example":"top_100_financial_news","isRequired":true,"uniqueKey":"source_groups.items.[INDEX].slug","typeLabel":"string"},"name":{"title":"Name","description":"The display name of the group.","type":"string","example":"Top 100 financial news publishers","isRequired":true,"uniqueKey":"source_groups.items.[INDEX].name","typeLabel":"string"},"description":{"oneOf":[{"title":"Description","description":"What kind of publishers the group covers.","type":"string","example":"The most read finance and markets publishers, English-language.","uniqueKey":"source_groups.items.[INDEX].description.oneOf.0","typeLabel":"string"},{"title":"Description","description":"What kind of publishers the group covers.","type":"null","example":"The most read finance and markets publishers, English-language.","uniqueKey":"source_groups.items.[INDEX].description.oneOf.1","typeLabel":"null"}],"uniqueKey":"source_groups.items.[INDEX].description","typeLabel":"string | null"}},"uniqueKey":"source_groups.items.[INDEX]","typeLabel":"Source Group · object"},"isRequired":true,"uniqueKey":"source_groups","typeLabel":"Source Group · object[]"},"total":{"title":"Total","description":"The total number of source groups across all pages.","type":"integer","example":21,"isRequired":true,"uniqueKey":"total","typeLabel":"integer"},"page":{"title":"Page","description":"The current page number.","type":"integer","example":1,"isRequired":true,"uniqueKey":"page","typeLabel":"integer"},"page_size":{"title":"Page Size","description":"The number of source groups per page.","type":"integer","example":100,"isRequired":true,"uniqueKey":"page_size","typeLabel":"integer"}},"uniqueKey":"","typeLabel":"List Source Groups Response · object"},"examples":{"Example":{"title":"Example","value":{"source_groups":[{"slug":"top_100_financial_news","name":"Top 100 financial news publishers","description":"The most read finance and markets publishers, English-language."}],"total":21,"page":1,"page_size":100}}},"exampleType":"generated"}},"exampleType":"generated"},"7767980b-823f-4512-ad6a-1c58756c2e7d":{"description":"Unauthorized - Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"A detailed description of the error.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"status_code":{"type":"integer","description":"The HTTP status code of the error.","isRequired":true,"uniqueKey":"status_code","typeLabel":"integer"},"status":{"type":"string","description":"A short description of the status code.","isRequired":true,"uniqueKey":"status","typeLabel":"string"}},"required":["message","status_code","status"],"uniqueKey":"","typeLabel":"object"},"example":{"message":"The 'x-api-token' parameter has an invalid value. Please provide a valid API key.","status_code":401,"status":"Unauthorized"},"examples":{"Example":{"title":"Example","value":{"message":"The 'x-api-token' parameter has an invalid value. Please provide a valid API key.","status_code":401,"status":"Unauthorized"}}},"exampleType":"examples"}},"exampleType":"examples"},"062ca1ad-6cc7-47dd-9be7-154315494c36":{"description":"Forbidden - Server refuses action","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"A detailed description of the error.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"status_code":{"type":"integer","description":"The HTTP status code of the error.","isRequired":true,"uniqueKey":"status_code","typeLabel":"integer"},"status":{"type":"string","description":"A short description of the status code.","isRequired":true,"uniqueKey":"status","typeLabel":"string"}},"required":["message","status_code","status"],"uniqueKey":"","typeLabel":"object"},"example":{"message":"Your plan request date range cannot be greater than 400 days","status_code":403,"status":"Forbidden"},"examples":{"Example":{"title":"Example","value":{"message":"Your plan request date range cannot be greater than 400 days","status_code":403,"status":"Forbidden"}}},"exampleType":"examples"}},"exampleType":"examples"},"0c2ef2e2-df02-4741-8492-79d3044648ff":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"A detailed description of the error.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"status_code":{"type":"integer","description":"The HTTP status code of the error.","isRequired":true,"uniqueKey":"status_code","typeLabel":"integer"},"status":{"type":"string","description":"A short description of the status code.","isRequired":true,"uniqueKey":"status","typeLabel":"string"}},"required":["message","status_code","status"],"uniqueKey":"","typeLabel":"object"},"example":{"message":"Invalid date format","status_code":422,"status":"Validation error"},"examples":{"Example":{"title":"Example","value":{"message":"Invalid date format","status_code":422,"status":"Validation error"}}},"exampleType":"examples"}},"exampleType":"examples"},"a5a0c14c-09f4-426b-8fe1-3067646ea25e":{"description":"Too many requests - Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"A detailed description of the error.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"status_code":{"type":"integer","description":"The HTTP status code of the error.","isRequired":true,"uniqueKey":"status_code","typeLabel":"integer"},"status":{"type":"string","description":"A short description of the status code.","isRequired":true,"uniqueKey":"status","typeLabel":"string"}},"required":["message","status_code","status"],"uniqueKey":"","typeLabel":"object"},"example":{"message":"Max API requests concurrency reached","status_code":429,"status":"Too many requests"},"examples":{"Example":{"title":"Example","value":{"message":"Max API requests concurrency reached","status_code":429,"status":"Too many requests"}}},"exampleType":"examples"}},"exampleType":"examples"},"4cedb10d-4db2-4791-bdd0-b1f05626cfd6":{"description":"Internal server error","content":{"text/plain":{"schema":{"type":"string","uniqueKey":"","typeLabel":"string"},"example":"Internal Server Error","examples":{"Example":{"title":"Example","value":"Internal Server Error"}},"exampleType":"examples"}},"exampleType":"examples"},"cc9da2ae-569f-445c-a1ee-669862e245d0":{"description":"Service unavailable. A part of the service is temporarily unavailable, for example the source group catalog. Requests answered with `503` are not charged. Retry after a short wait.\n","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"A detailed description of the error.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"status_code":{"type":"integer","description":"The HTTP status code of the error.","isRequired":true,"uniqueKey":"status_code","typeLabel":"integer"},"status":{"type":"string","description":"A short description of the status code.","isRequired":true,"uniqueKey":"status","typeLabel":"string"}},"required":["message","status_code","status"],"uniqueKey":"","typeLabel":"object"},"example":{"message":"Source groups are temporarily unavailable, so this search was not run. Please retry - this request has not been charged.","status_code":503,"status":"Service unavailable"},"examples":{"Example":{"title":"Example","value":{"message":"Source groups are temporarily unavailable, so this search was not run. Please retry - this request has not been charged.","status_code":503,"status":"Service unavailable"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"5189df8a-b403-4b02-a930-d7d3428e0119":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-token","description":"API Key to authenticate requests.\n\nTo access the API, include your API key in the `x-api-token` header. \nTo obtain your API key, complete the [form](https://www.newscatcherapi.com/book-a-demo) or contact us directly.\n","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"c6352d96-c6ad-4f24-8410-8487e92fc94b":{"url":"https://v3-api.newscatcherapi.com","description":"News API production server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-token","description":"API Key to authenticate requests.\n\nTo access the API, include your API key in the `x-api-token` header. \nTo obtain your API key, complete the [form](https://www.newscatcherapi.com/book-a-demo) or contact us directly.\n","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"x-api-token","type":"string","description":"API Key to authenticate requests.\n\nTo access the API, include your API key in the `x-api-token` header. \nTo obtain your API key, complete the [form](https://www.newscatcherapi.com/book-a-demo) or contact us directly.\n","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"x-api-token"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"news-api/api-reference/news-api-v3.yml"},"subdomain":"newscatcherinc-docs","siteName":"newscatcher","title":"List source groups - newscatcher","navMaps":{"firstHrefInVersion":{"Latest":{"href":"/get-started/overview","matchLevel":4},"Enterprise":{"href":"/news-api/api-reference/source-groups/list-source-groups-get","matchLevel":0}},"firstHrefInLanguage":{}},"lastModified":"2026-11-06T10:43:36.433Z","originalFileLocation":"news-api/api-reference/source-groups/list-source-groups-get.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Lists the source groups you can search with the source_groups parameter of the Search endpoint. A source group is a ready-made list of publisher domains that the NewsCatcher team builds and maintains for a common use case, such as the top financial news publishers, central banks and regulators, or a region\u0026#x27;s business press. Instead of listing dozens of domains in sources, pass the group\u0026#x27;s slug. Groups are read-only: you can\u0026#x27;t create or edit them, and NewsCatcher may update their domains over time. The response describes each group but does not list its domains. This endpoint requires an API key and does not count toward your plan\u0026#x27;s quota.\">\u003cmeta data-mint-head name=\"application-name\" content=\"newscatcher\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/newscatcherinc-docs/2244mS4HNtJc0azZ/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/newscatcherinc-docs/2244mS4HNtJc0azZ/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/newscatcherinc-docs/2244mS4HNtJc0azZ/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/newscatcherinc-docs/2244mS4HNtJc0azZ/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/newscatcherinc-docs/2244mS4HNtJc0azZ/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/newscatcherinc-docs/2244mS4HNtJc0azZ/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/newscatcherinc-docs/2244mS4HNtJc0azZ/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/newscatcherinc-docs/2244mS4HNtJc0azZ/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/newscatcherinc-docs/2244mS4HNtJc0azZ/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List source groups - newscatcher\">\u003cmeta data-mint-head property=\"og:description\" content=\"Lists the source groups you can search with the source_groups parameter of the Search endpoint. A source group is a ready-made list of publisher domains that the NewsCatcher team builds and maintains for a common use case, such as the top financial news publishers, central banks and regulators, or a region\u0026#x27;s business press. Instead of listing dozens of domains in sources, pass the group\u0026#x27;s slug. Groups are read-only: you can\u0026#x27;t create or edit them, and NewsCatcher may update their domains over time. The response describes each group but does not list its domains. This endpoint requires an API key and does not count toward your plan\u0026#x27;s quota.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"newscatcher\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://newscatcherinc-docs.mintlify.dev/docs/news-api/api-reference/source-groups/list-source-groups-get\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://newscatcherinc-docs.mintlify.site/docs/_mintlify/api/og/v2?division=Source+groups\u0026amp;title=List+source+groups\u0026amp;description=Lists+the+source+groups+you+can+search+with+the+%60source_groups%60+parameter+of+the+Search+endpoint.+A+source+group+is+a+ready-made+list+of+publisher+domains+that+\u0026amp;theme=09b224810abf96124a03f519\u0026amp;signature=cee4e5ed97bb26c5dfa536c643e79be9af216dd335e518444ef9d01733669a77\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"List source groups - newscatcher\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Lists the source groups you can search with the source_groups parameter of the Search endpoint. A source group is a ready-made list of publisher domains that the NewsCatcher team builds and maintains for a common use case, such as the top financial news publishers, central banks and regulators, or a region\u0026#x27;s business press. Instead of listing dozens of domains in sources, pass the group\u0026#x27;s slug. Groups are read-only: you can\u0026#x27;t create or edit them, and NewsCatcher may update their domains over time. The response describes each group but does not list its domains. This endpoint requires an API key and does not count toward your plan\u0026#x27;s quota.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://newscatcherinc-docs.mintlify.site/docs/_mintlify/api/og/v2?division=Source+groups\u0026amp;title=List+source+groups\u0026amp;description=Lists+the+source+groups+you+can+search+with+the+%60source_groups%60+parameter+of+the+Search+endpoint.+A+source+group+is+a+ready-made+list+of+publisher+domains+that+\u0026amp;theme=09b224810abf96124a03f519\u0026amp;signature=cee4e5ed97bb26c5dfa536c643e79be9af216dd335e518444ef9d01733669a77\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/newscatcherinc-docs/2244mS4HNtJc0azZ/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"newscatcher\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#183FD9\">\u003clink data-mint-head rel=\"canonical\" href=\"https://newscatcherinc-docs.mintlify.dev/docs/news-api/api-reference/source-groups/list-source-groups-get\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/news-api/api-reference/source-groups/list-source-groups-get.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://newscatcherinc-docs.mintlify.dev/#organization\",\"name\":\"newscatcher\",\"url\":\"https://newscatcherinc-docs.mintlify.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/newscatcherinc-docs/NcLiyYj9meKksQck/logos/full_black.png?fit=max\u0026auto=format\u0026n=NcLiyYj9meKksQck\u0026q=85\u0026s=20bb812dd269c21260d0753faf2c9831\"}},{\"@type\":\"WebSite\",\"@id\":\"https://newscatcherinc-docs.mintlify.dev/docs#website\",\"name\":\"newscatcher\",\"url\":\"https://newscatcherinc-docs.mintlify.dev/docs\",\"publisher\":{\"@id\":\"https://newscatcherinc-docs.mintlify.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://newscatcherinc-docs.mintlify.dev/docs/news-api/api-reference/source-groups/list-source-groups-get#webpage\",\"url\":\"https://newscatcherinc-docs.mintlify.dev/docs/news-api/api-reference/source-groups/list-source-groups-get\",\"name\":\"List source groups\",\"description\":\"Lists the source groups you can search with the source_groups parameter of the Search endpoint. A source group is a ready-made list of publisher domains that the NewsCatcher team builds and maintains for a common use case, such as the top financial news publishers, central banks and regulators, or a region's business press. Instead of listing dozens of domains in sources, pass the group's slug. Groups are read-only: you can't create or edit them, and NewsCatcher may update their domains over time. The response describes each group but does not list its domains. This endpoint requires an API key and does not count toward your plan's quota.\",\"dateModified\":\"2026-11-06T10:43:36.433Z\",\"isPartOf\":{\"@id\":\"https://newscatcherinc-docs.mintlify.dev/docs#website\"},\"breadcrumb\":{\"@id\":\"https://newscatcherinc-docs.mintlify.dev/docs/news-api/api-reference/source-groups/list-source-groups-get#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://newscatcherinc-docs.mintlify.dev/docs/news-api/api-reference/source-groups/list-source-groups-get#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://newscatcherinc-docs.mintlify.dev/docs/news-api/api-reference/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List source groups\",\"item\":\"https://newscatcherinc-docs.mintlify.dev/docs/news-api/api-reference/source-groups/list-source-groups-get\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://newscatcherinc-docs.mintlify.dev/docs/news-api/api-reference/source-groups/list-source-groups-get#apireference\",\"headline\":\"List source groups\",\"name\":\"List source groups\",\"description\":\"Lists the source groups you can search with the source_groups parameter of the Search endpoint. A source group is a ready-made list of publisher domains that the NewsCatcher team builds and maintains for a common use case, such as the top financial news publishers, central banks and regulators, or a region's business press. Instead of listing dozens of domains in sources, pass the group's slug. Groups are read-only: you can't create or edit them, and NewsCatcher may update their domains over time. The response describes each group but does not list its domains. This endpoint requires an API key and does not count toward your plan's quota.\",\"url\":\"https://newscatcherinc-docs.mintlify.dev/docs/news-api/api-reference/source-groups/list-source-groups-get\",\"mainEntityOfPage\":{\"@id\":\"https://newscatcherinc-docs.mintlify.dev/docs/news-api/api-reference/source-groups/list-source-groups-get#webpage\"},\"dateModified\":\"2026-11-06T10:43:36.433Z\",\"publisher\":{\"@id\":\"https://newscatcherinc-docs.mintlify.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://newscatcherinc-docs.mintlify.dev/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"newscatcher\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"newscatcher","nav":{"global":null,"versions":[{"version":"Latest","default":true,"pages":[{"title":"Latest","href":"/get-started/overview"}]},{"version":"Enterprise","tabs":[{"tab":"Home","pages":[{"title":"Home","href":"/home"}]},{"tab":"Web Search API","pages":[{"title":"Web Search API","href":"/web-search-api/get-started/introduction"}]},{"tab":"Event Monitors","pages":[{"title":"Event Monitors","href":"/web-search-api/concepts/event-monitors"}]},{"tab":"Company Monitors","pages":[{"title":"Company Monitors","href":"/web-search-api/concepts/company-monitors"}]},{"tab":"News API","groups":[{"group":"Get started","pages":[{"title":"Introduction to News API","sidebarTitle":"Introduction","href":"/news-api/get-started/introduction"},{"title":"Quickstart","sidebarTitle":"Quickstart","href":"/news-api/get-started/quickstart"},{"title":"News API subscription plans","sidebarTitle":"Subscription plans","href":"/news-api/get-started/subscription-plans"},{"title":"News API changelog","sidebarTitle":"Changelog","href":"/news-api/get-started/changelog"}]},{"group":"Guides and concepts","pages":[{"title":"Advanced querying techniques","sidebarTitle":"Query syntax","href":"/news-api/guides-and-concepts/advanced-querying"},{"title":"Clustering news articles","href":"/news-api/guides-and-concepts/clustering-news-articles"},{"title":"Articles deduplication","sidebarTitle":"Articles deduplication","href":"/news-api/guides-and-concepts/articles-deduplication"},{"title":"NLP Enrichments","sidebarTitle":"NLP Enrichments","href":"/news-api/guides-and-concepts/nlp-enrichments"},{"title":"Custom tags","sidebarTitle":"Custom tags","href":"/news-api/guides-and-concepts/custom-tags"},{"title":"Breaking news","sidebarTitle":"Breaking news","href":"/news-api/guides-and-concepts/breaking-news"},{"title":"Robots.txt compliance","sidebarTitle":"Robots.txt compliance","href":"/news-api/guides-and-concepts/robots-txt-compliance"},{"title":"Working with historical data","sidebarTitle":"Working with historical data","href":"/news-api/guides-and-concepts/working-with-historical-data"}]},{"group":"How to","pages":[{"title":"Build search queries","sidebarTitle":"Build search queries","href":"/news-api/how-to/build-search-queries"},{"title":"Filter by date","sidebarTitle":"Filter by date","href":"/news-api/how-to/filter-by-date"},{"title":"How to search articles by entity","sidebarTitle":"Search by entity","href":"/news-api/how-to/search-by-entity"},{"title":"How to search articles by URL","sidebarTitle":"Search by URL","href":"/news-api/how-to/search-by-url"},{"title":"Search in translations","sidebarTitle":"Search in translations","href":"/news-api/how-to/search-in-translations"},{"title":"Retrieve large datasets","sidebarTitle":"Retrieve large datasets","href":"/news-api/how-to/retrieve-more-than-10k-articles"},{"title":"Check sources coverage","sidebarTitle":"Check sources coverage","href":"/news-api/how-to/check-sources-coverage"},{"title":"Validate queries with Python SDK","sidebarTitle":"Validate queries","href":"/news-api/how-to/validate-queries-python-sdk"}]},{"group":"Troubleshooting","pages":[{"title":"Interpret and handle API errors","sidebarTitle":"Error handling","href":"/news-api/troubleshooting/error-handling"},{"title":"Report bugs","sidebarTitle":"Report bugs","href":"/news-api/troubleshooting/report-bugs"},{"title":"Request tracing with correlation IDs","sidebarTitle":"Request tracing with correlation IDs","href":"/news-api/troubleshooting/request-tracing-correlation-ids"}]},{"group":"API Reference","pages":[{"title":"API reference overview","sidebarTitle":"Overview","href":"/news-api/api-reference/overview"},{"title":"Authentication","sidebarTitle":"Authentication","href":"/news-api/api-reference/authentication"},{"title":"Rate limits and quotas","sidebarTitle":"Rate limits","href":"/news-api/api-reference/rate-limits"},{"title":"Errors","href":"/news-api/api-reference/errors"},{"title":"HTTP headers","sidebarTitle":"HTTP headers","href":"/news-api/api-reference/http-headers"},{"title":"Enumerated parameters","href":"/news-api/api-reference/enumerated-parameters"},{"group":"Search","pages":[{"openapi":"news-api-v3 get /api/search","title":"Search articles","href":"/news-api/api-reference/search/search-articles-get"},{"openapi":"news-api-v3 post /api/search","title":"Search articles","href":"/news-api/api-reference/search/search-articles-post"}]},{"group":"Latest headlines","pages":[{"openapi":"news-api-v3 get /api/latest_headlines","title":"Retrieve latest headlines","href":"/news-api/api-reference/latest-headlines/retrieve-latest-headlines-get"},{"openapi":"news-api-v3 post /api/latest_headlines","title":"Retrieve latest headlines","href":"/news-api/api-reference/latest-headlines/retrieve-latest-headlines-post"}]},{"group":"Breaking news","pages":[{"openapi":"news-api-v3 get /api/breaking_news","title":"Get breaking news","href":"/news-api/api-reference/breaking-news/retrieve-breaking-news-get"},{"openapi":"news-api-v3 post /api/breaking_news","title":"Get breaking news","href":"/news-api/api-reference/breaking-news/retrieve-breaking-news-post"}]},{"group":"Authors","pages":[{"openapi":"news-api-v3 get /api/authors","title":"Search articles by author","href":"/news-api/api-reference/authors/search-articles-by-author-get"},{"openapi":"news-api-v3 post /api/authors","title":"Search articles by author","href":"/news-api/api-reference/authors/search-articles-by-author-post"}]},{"group":"Search by link","pages":[{"openapi":"news-api-v3 get /api/search_by_link","title":"Search articles by links or IDs","href":"/news-api/api-reference/search-by-link/search-articles-by-links-or-ids-get"},{"openapi":"news-api-v3 post /api/search_by_link","title":"Search articles by links or IDs","href":"/news-api/api-reference/search-by-link/search-articles-by-links-or-ids-post"}]},{"group":"Sources","pages":[{"openapi":"news-api-v3 get /api/sources","title":"Retrieve sources","href":"/news-api/api-reference/sources/retrieve-sources-get"},{"openapi":"news-api-v3 post /api/sources","title":"Retrieve sources","description":"Retrieves the list of sources available in the database. You can filter the sources by language, country, and more.","href":"/news-api/api-reference/sources/retrieve-sources-post"}]},{"group":"Source groups","pages":[{"openapi":"news-api-v3 get /api/source-groups","title":"List source groups","href":"/news-api/api-reference/source-groups/list-source-groups-get"}]},{"group":"Aggregation count","pages":[{"openapi":"news-api-v3 get /api/aggregation_count","title":"Get aggregation count by interval","description":"Retrieves the count of articles aggregated by day or hour based on various search criteria, such as keyword, language, country, and source.","href":"/news-api/api-reference/aggregation-count/get-aggregation-count-by-interval-get"},{"openapi":"news-api-v3 post /api/aggregation_count","title":"Get aggregation count by interval","href":"/news-api/api-reference/aggregation-count/get-aggregation-count-by-interval-post"}]},{"group":"Subscription","pages":[{"openapi":"news-api-v3 get /api/subscription","title":"Retrieve subscription plan information","href":"/news-api/api-reference/subscription/retrieve-subscription-plan-information-get"},{"openapi":"news-api-v3 post /api/subscription","title":"Retrieve subscription plan information","href":"/news-api/api-reference/subscription/retrieve-subscription-plan-information-post"}]}]},{"group":"Integrations","pages":[{"title":"News API MCP server","sidebarTitle":"MCP","href":"/news-api/integrations/mcp"}]},{"group":"Libraries","pages":[{"title":"Python SDK","sidebarTitle":"Python","href":"/news-api/libraries/python"},{"title":"TypeScript SDK","sidebarTitle":"TypeScript","href":"/news-api/libraries/typescript"},{"title":"Java SDK","sidebarTitle":"Java","href":"/news-api/libraries/java"}]}]},{"tab":"Local News API","pages":[{"title":"Local News API","href":"/local-news-api/get-started/introduction"}]}]}]},"basePath":"","title":"List source groups - newscatcher","buildId":"dpl_CEsowfH15TDzsBT2BFbX312Be4Ct","deploymentId":"dpl_CEsowfH15TDzsBT2BFbX312Be4Ct","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CqF8gK93.js","utils-Cfy66YIG.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-cadwlSiW.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BOSHrB55.js","snippetPresets-DuIJ6Tui.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-BByZ-4eP.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DWD4BnjW.js","shallow-Bo7p10ck.js","getApiPlaygroundDisplay-C7mFZ2Cg.js","CodeSnippet-DrT8v8gt.js","CodeSnippets-DGLmtlSm.js","Page-CGry0O4L.js","getPastedJson-DXZGgv-T.js","icon-DMjuBky8.js","MethodPill-C_c9VvF7.js","DuplicateIcon-D8Zrb3hW.js","createIcon-eYWxX-Sl.js","DynamicMarkdown-DORtg_Te.js","SectionHeading-DE1W9Ett.js","axios-vUo_bRtp.js","Markdown-BvSqw8zR.js","clsx-B-KWekQe.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CTE3eEYy.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Ba-QebqG.js"]}