How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
SmartNews

SmartNews catalog API

The catalog API from SmartNews — 4 operation(s) for catalog.

Documentation Provider Profile APIs.io OpenAPI GitHub

SmartNews catalog API is one of 16 APIs that SmartNews publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Catalog. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 8 operations across 4 paths, and defines 47 schemas. It is described by OpenAPI 3.2.0, at version 3.0.1.

Requests are made against a single base URL, https://ads.smartnews.com.

8 operations 4 paths 47 schemas 4 GET2 PATCH2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
3.0.1
Base URL
https://ads.smartnews.com
Authentication
HTTP Bearer
Contact
SmartNews Ads Support
Resource Areas
1

Authentication & Security 1

SmartNews catalog API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (JWT) (ApiKeyAuth). By default, every request must be authenticated.

Paths & Operations 8

Across 4 paths, the API surfaces 8 operations — 4 GET, 2 PATCH, 2 POST. Each is listed below with its method, path, parameters, and response codes.

catalog 8
GET
/api/bm-external/v1/businesses/{business_id}/catalogs
Retrieve all catalogs associated with the specified business.
listBusinessCatalogs 1 param → 200401403404500503
POST
/api/bm-external/v1/businesses/{business_id}/catalogs
Create a new catalog for the specified business. Only business admins can create catalogs. The catalog will be created with the provided configuration and linked to the specified ad accounts.
createBusinessCatalog 1 param body → 201400401403404422500503
GET
/api/bm-external/v1/businesses/{business_id}/catalogs/{catalog_id}
Retrieve metadata of a specific catalog under the specified business.
getBusinessCatalog 2 params → 200401403404500503
PATCH
/api/bm-external/v1/businesses/{business_id}/catalogs/{catalog_id}
Update metadata of an existing catalog under the specified business. Only the catalog-level fields are editable here; product source fields are managed via the product source endpoint and no connecti…
updateBusinessCatalog 2 params body → 200400401403404422500503
GET
/api/bm-external/v1/businesses/{business_id}/catalogs/{catalog_id}/product_sets
Retrieve all product sets configured under the specified catalog.
listCatalogProductSets 2 params → 200401403404500503
POST
/api/bm-external/v1/businesses/{business_id}/catalogs/{catalog_id}/product_sets
Create a new product set under the specified catalog. Users can configure name, rulematchtype, and filterrules. Each filter rule must specify a valid field, condition, and values combination.
createCatalogProductSet 2 params body → 201400401403404422500503
GET
/api/bm-external/v1/businesses/{business_id}/catalogs/{catalog_id}/product_sets/{product_set_id}
Retrieve details of a specific product set under the specified catalog.
getCatalogProductSet 3 params → 200401403404500503
PATCH
/api/bm-external/v1/businesses/{business_id}/catalogs/{catalog_id}/product_sets/{product_set_id}
Update an existing product set under the specified catalog. Users can update name, rulematchtype, and filterrules. Each filter rule must specify a valid field, condition, and values combination. At l…
updateCatalogProductSet 3 params body → 200400401403404422500503

Schemas 47

The contract defines 47 schemas that model the data the API accepts and returns. The most detailed are ProductSource (15 properties), CreateCatalogResponse (14 properties), CatalogResponse (14 properties), ProductSet (12 properties). Each schema is shown below with its type and property counts.

CommonSchemas_ValidationErrorResponse
object
1 property 1 required
FilterCondition
string
Supported operators for catalog product filtering rules.
ReviewStatus
string
PostProductSetRequest
object
Request body for creating a new product set.
3 properties 2 required
UnauthorizedErrorResponse
object
1 property 1 required
ServiceUnavailableErrorExtension
object
1 property 1 required
UnexpectedErrorResponse
object
1 property 1 required
FilterRuleRequest
object
Filter rule input for creating or updating a product set.
3 properties 3 required
UnexpectedError
object
ProductSet
object
Product set definition along with the latest operational metadata.
12 properties 9 required
UpdateCatalogRequest
object
Request body for updating catalog metadata. Only catalog-level fields are editable; region, currency, and timezone are read-only. At least one field must be pr…
5 properties
AppTracking
object
Mobile app tracking configuration for the catalog.
3 properties 1 required
ProductSource
object
Product source configuration and operational data. Returned identically by the catalog endpoints (nested under productsources) and by the product source endpoi…
15 properties 9 required
ForbiddenErrorResponse
object
1 property 1 required
FilterRule
object
Filter rule definition used to build a product set.
4 properties 4 required
CommonSchemas_ValidationErrorExtension
object
2 properties 2 required
CommonSchemas_ResourceNotFoundErrorResponse
object
1 property 1 required
CreateCatalogRequest
object
Request body for creating a new catalog.
8 properties 5 required
ProductSetResponse
object
Response body containing a single product set.
1 property 1 required
CommonSchemas_ValidationError
object
FilterField
string
Supported fields for catalog product filtering.
ProductSourceStatus
string
Status of the product source, covering both the latest fetch (connection) and the health of the items it imported. On a successful fetch the status reflects th…
ServiceUnavailableError
object
CreateCatalogResponse
object
Response for catalog creation containing the newly created catalog details.
14 properties 10 required
BadRequestErrorResponse
object
1 property 1 required
UnauthorizedErrorExtension
object
1 property 1 required
ForbiddenError
object
IngestionErrorReason
stringnull
The reason for an ingestion error. Null when product source status is not ERROR. - AUTHFAILED: Authentication failed (HTTP 401/403, FTP 530) - FILENOTFOUND: Fi…
ForbiddenErrorExtension
object
2 properties 1 required
CommonSchemas_ResourceNotFoundError
object
CatalogArrayResponse
object
Response wrapper containing a list of catalogs for a given business.
1 property 1 required
TrackingType
string
The platform type for app tracking. - ANDROID: Android platform only - IOS: iOS platform only - ALL: Both Android and iOS platforms
BadRequestErrorExtension
object
1 property 1 required
ProductSourceRequest
object
Product source configuration for catalog creation.
5 properties 3 required
CatalogResponse
object
Complete representation of a catalog including metadata and configuration.
14 properties 9 required
BadRequestError
object
Status
string
Status of the product set generation. - CREATED: Product set is pending processing or regeneration. - READY: Latest processing succeeded and the set is ready f…
ServiceUnavailableErrorResponse
object
1 property 1 required
UnexpectedErrorExtension
object
1 property 1 required
ProductSetArrayResponse
object
Response body containing multiple product sets.
1 property 1 required
UnauthorizedError
object
CommonSchemas_ResourceNotFoundErrorExtension
object
2 properties 2 required
CatalogAdAccount
object
Ad account that has access to the catalog.
2 properties 2 required
RuleMatchType
string
Rule matching strategy within a product set. - ALL: Products must satisfy every rule (logical AND). - ATLEASTONE: Products may satisfy any single rule (logical…
CommonSchemas_FileType
string
The file format for product feed. - CSV: Comma-separated values - TSV: Tab-separated values
ErrorBase
object
2 properties 2 required
PatchProductSetRequest
object
Request body for updating an existing product set. At least one field must be provided.
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

smartnews-catalog-api-openapi.yml Raw ↑

Other APIs SmartNews publishes across the network.

SmartNews ad API
AE Profile APIs.io
SmartNews ad-group API
AE Profile APIs.io
SmartNews article category API
AE Profile APIs.io
SmartNews campaign API
AE Profile APIs.io
SmartNews channel alias label API
AE Profile APIs.io
SmartNews custom-audience API
AE Profile APIs.io
SmartNews developer-app API
AE Profile APIs.io
SmartNews insights API
AE Profile APIs.io
SmartNews interests API
AE Profile APIs.io
SmartNews locations API
AE Profile APIs.io
SmartNews media-file API
AE Profile APIs.io
SmartNews oauth API
AE Profile APIs.io
#Catalog
← Back to S APIs
API Details
ID
smartnews:smartnews-catalog-api
Base URL
https://ads.smartnews.com
Docs
https://ads.smartnews.com/developers/
Provider
SmartNews
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=smartnews-catalog-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/smartnews-catalog-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of SmartNews catalog API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.