OpenSincera queries

The OpenSincera API seamlessly integrates your platform with Sincera metadata to provide you detailed insights into advertiser quality and the digital advertising supply chain. OpenSincera includes metrics such as A2CR (ads-to-content ratio).

Request syntax and conventions

Here's what you need to know about calling the API:

You need an OpenSincera account and valid bearer token. For details, see Get started with OpenSincera API.
Use the base path https://open.sincera.io/api.
To create or update a query, include the following:
- A valid bearer token
- The base path https://open.sincera.io/api with the appropriate endpoint
- Any required or optional query parameters

Use the following request syntax:

curl -H "Authorization: Bearer AUTH_TOKEN_PLACEHOLDER" "https://open.sincera.io/api/ENDPOINT_PLACEHOLDER"

The following table lists the available request options and corresponding endpoints.

Request Option	Endpoint	Query Parameters	Example
Ecosystem	`ecosystem`	None	`https://open.sincera.io/api/ecosystem`
Publisher	`publishers`	`id=PUBLISHER_ID_PLACEHOLDER` `domain=PUBLISHER_DOMAIN_PLACEHOLDER` `page=PAGE_NUMBER_PLACEHOLDER`	`https://open.sincera.io/api/publishers?id=1` `https://open.sincera.io/api/publishers?domain=businessinsider.com` `https://open.sincera.io/api/publishers?page=2`
Publisher List	`publishers`	`page=PAGE_NUMBER_PLACEHOLDER`	`https://open.sincera.io/api/publishers?page=2`
Page-level metrics	`urls`	`id=PUBLISHER_ID_PLACEHOLDER` `domain=PUBLISHER_DOMAIN_PLACEHOLDER`	`https://open.sincera.io/api/urls?id=1` `https://open.sincera.io/api/urls?domain=businessinsider.com`
Resolution market share	`resolution_market_shares`	None	`https://open.sincera.io/api/resolution_market_shares`
Ad systems	`adsystems`	None	`https://open.sincera.io/api/adsystems`
Prebid module mappings	`mapping_modules`	None	`https://open.sincera.io/api/mapping_modules`

For example, here's a request to retrieve ecosystem data. Be sure to replace the placeholder token with your actual bearer token ID:

curl -H "Authorization: Bearer fak3T0k3n.12345.abcDEFGHIJKLMNOPQRST_uvwxYZ" "https://open.sincera.io/api/ecosystem"

The following sections provide examples of how to search OpenSincera, ranging from ecosystem data to Prebid module mappings.

Get ecosystem data

With your OpenSincera API token, you can retrieve comprehensive ecosystem data in OpenSincera. This includes ad media types, major Prebid versions, common user modules, and more.

Request syntax

Here's the syntax for retrieving general ecosystem data in cURL:

curl -H "Authorization: Bearer AUTH_TOKEN_PLACEHOLDER" "https://open.sincera.io/api/ecosystem"

Response object

The OpenSincera API returns a response object with comprehensive ecosystem metadata. The following is a sample response.

{
  "date": "2026-07-27",
  "updated_at": "2026-07-27T02:11:58.166Z",
  "known_adsystems": 1007,
  "global_gpids": 13010598,
  "pbjs_ad_unit_media_types": {
    "video": "26784332",
    "banner": "65946449",
    "native": "2966553",
    "slider": "9320",
  },
  "video_plcmt_pubs": 51291,
  "pubs_with_gpid": 210509,
  "pbjs_major_versions": [
    [
      "11.x",
      "35171"
    ],
    [
      "10.x",
      "40399"
    ]
  ],
  "global_policies": 62680350,
  "recently_updated_publishers": [
    535782,
    535781,
    535780
  ],
  "header_wrappers": {
    "Prebid.org": 118190,
    "Amazon": 93481,
    "PubMatic": 87270
  },
  "avg_user_modules_deployed": 6.589421894218942,
  "avg_audience_providers_deployed": 1.5805884802502614,
  "sincera_ecosystem_size": 505963,
  "webrisk_flagged_publishers": 1636,
  "adult_domains": 150,
  "topics_opt_outs": 23058,
  "known_ios_apps": 1234,
  "known_roku_apps": 1234,
  "known_google_apps": 1234
}

Property reference

The following table lists the properties in the response object with ecosystem data.

Property Name	Description
`date`	The date when the data was retrieved.
`updated_at`	The timestamp for when the data was last updated.
`known_adsystems`	The number of ad systems in the Sincera ecosystem.
`global_gpids`	The number of global placement identifiers (GPIDs) found by Sincera.
`pbjs_ad_unit_media_types`	A breakdown of Prebid ad unit media types found on publisher domains.
`video_plcmt_pubs`	The number of publishers with video placement (`video.plcmt`) signals found.
`pubs_with_gpid`	The number of publishers with GPIDs found.
`pbjs_major_versions`	A breakdown of Prebid wrapper versions found across the Sincera publisher ecosystem.
`global_policies`	The number of policies (`ads.txt` entries) recorded by Sincera.
`recently_updated_publishers`	An array of publishers updated within the last 24 hours as detected by Sincera, identified by their publisher ID.
`header_wrappers`	A breakdown of header wrappers found across the Sincera publisher ecosystem, categorized by ad system.
`avg_user_modules_deployed`	The average number of user modules found in Prebid wrappers across the Sincera publisher ecosystem.
`avg_audience_providers_deployed`	The average number of audience providers deployed by publishers.
`sincera_ecosystem_size`	The number of publishers in the Sincera ecosystem.
`webrisk_flagged_publishers`	The number of publishers flagged by Google Web Risk in the Sincera ecosystem.
`adult_domains`	The number of publishers flagged for adult content in the Sincera ecosystem.
`topics_opt_outs`	The number of publishers opting out of specific topics in the Sincera ecosystem.
`known_ios_apps`	The total number of iOS apps in the Sincera ecosystem.
`known_roku_apps`	The total number of Roku apps in the Sincera ecosystem.
`known_google_apps`	The total number of Google Play Store apps in the Sincera ecosystem.

Get publisher metadata

With your OpenSincera API token, you can retrieve publisher information for a specific ID or domain. Here's what you need to know about using this API, including rate limits, token restrictions, and formatting requirements:

You can retrieve publisher IDs from the OpenSincera UI.
Exclude the protocol and path from the publisher's domains. For example, the owner_domain field has a value of businessinsider.com.

IMPORTANT: Attempting to bypass rate limits by using multiple tokens on the same system results in permanent suspension from the platform.

The following sections explain the request syntax in cURL and use Business Insider as a publisher in the examples. However, you can use this same information with any technology and get similar results.

For a given publisher ID

Here's the syntax for retrieving publisher information for a publisher ID:

curl -H "Authorization: Bearer AUTH_TOKEN_PLACEHOLDER" "https://open.sincera.io/api/publishers?id=PUBLISHER_ID_PLACEHOLDER"

For a given publisher domain

Here's the syntax for retrieving publisher information for a publisher domain:

curl -H "Authorization: Bearer AUTH_TOKEN_PLACEHOLDER" "https://open.sincera.io/api/publishers?domain=PUBLISHER_DOMAIN_PLACEHOLDER"

Response object

The OpenSincera API returns a response object with comprehensive publisher metadata, including the A2CR ratio, page weight, average ads in view, and ad refresh rate. The following is a sample response for a Business Insider request.

{
  "publisher_id": 1,
  "name": "Business Insider",
  "visit_enabled": true,
  "status": "available",
  "primary_supply_type": "web",
  "domain": "businessinsider.com",
  "pub_description": "Business Insider tells the global tech, finance, stock market, media, economy, lifestyle, real estate, AI and innovative stories you want to know.",
  "categories": [
    "General",
    "Business and Finance",
    "Technology & Computing",
    "Personal Finance",
    "Law",
    "Business",
    "Computing"
  ],
  "slug": "business-insider",
  "avg_ads_to_content_ratio": 0.20525,
  "avg_ads_in_view": 2.02004,
  "avg_ad_refresh": 70.896,
  "device_level_metrics": {
    "mobile": {
      "average_refresh_rate": 53.704,
      "avg_ad_units_in_view": 1.60285,
      "avg_ads_to_content_ratio": 0.21721,
      "max_refresh_rate": 295.0,
      "min_refresh_rate": 20.0,
      "max_ad_units_in_view": 4.0,
      "max_ads_to_content_ratio": 1.0,
      "min_ads_to_content_ratio": 0.0,
      "percentage_of_ad_slots_with_refresh": 100.0
    },
    "desktop": {
      "average_refresh_rate": 56.25,
      "avg_ad_units_in_view": 2.37945,
      "avg_ads_to_content_ratio": 0.19513,
      "max_refresh_rate": 205.0,
      "min_refresh_rate": 5.0,
      "max_ad_units_in_view": 12.0246,
      "max_ads_to_content_ratio": 1.0,
      "min_ads_to_content_ratio": 0.0,
      "percentage_of_ad_slots_with_refresh": 91.23
    }
  },
  "total_unique_gpids": 926,
  "id_absorption_rate": 0.375,
  "avg_page_weight": 27.8427,
  "avg_cpu": 254.6705,
  "total_supply_paths": 123,
  "reseller_count": 70,
  "parent_entity_id": 59072,
  "owner_domain": "insider-inc.com",
  "updated_at": "2026-01-06T01:00:28.820Z",
  "similar_publishers": {
    "content": [
      41,
      67,
      405,
      700
    ]
  },
  "tech_stack": {
    "ad_servers": ["Google Ad Manager"],
    "analytics": ["Google Analytics"],
    "audience": [],
    "auth": [],
    "identity_providers": ["LiveRamp"],
    "technical_sales_houses": [],
    "survey": [],
    "video_players": ["JW Player"],
    "affiliate": [],
    "wrappers": ["Prebid"],
    "encrypted_signals": ["Google ESS"]
  }
}

Property reference

The following table lists the properties in the response object with publisher metadata.

Property Name	Description
`publisher_id`	The Sincera ID for the publisher. This matches the publisher ID in the OpenSincera UI.
`name`	The name of the publisher.
`visit_enabled`	If set to `true`, indicates that Sincera visits the publisher regularly. The default value is `true`.
`status`	The status of the publisher's website as seen by OpenSincera synthetic users, which are simulated users that mimic typical consumer behavior online.
`primary_supply_type`	The type of platform used for the A2CR value. For example, `web` or `ctv`.
`domain`	The base domain for the publisher website.
`pub_description`	Sincera's description of the publisher, as shown on the OpenSincera platform.
`categories`	The Interactive Advertising Bureau (IAB) 3.0 Content Taxonomy categories and manually assigned categories for the publisher.
`slug`	The part of a URL that identifies a specific page on a website in a readable way. It comes after the domain and any directory structure. For example, `open.sincera.io/publisher/businessinsider`.
`avg_ads_to_content_ratio`	The A2CR is the average of metrics that measure the percentage of pixels allocated to ads compared to those dedicated to content on a webpage. Sincera evaluates both the dimensions of the creatives and the ad slots, using the larger of the two values to calculate the A2CR. The value returned is an percentage. For example, `0.2` is 20%.
`avg_ads_in_view`	The average number of ads in view at the viewport level. Sincera calculates this by comparing the ad server functions or ad slot coordinates with a given viewport on the page.
`avg_ad_refresh`	The average time in seconds before an ad unit refreshes. Sincera monitors ad refresh timings across multiple ad servers.
`device_level_metrics`	Metrics, like A2CR, separated by device type.
`total_unique_gpids`	The total number of GPIDs, which are unique placement IDs specified by the publisher that remain unchanged across all supply-side platforms (SSPs).
`id_absorption_rate`	The identifier absorption rate, a metric developed by Sincera, measures how effectively SSPs append identifiers to their outgoing bid requests. It focuses on the success rate when an identifier is already present, not the overall enrichment rate. A higher score indicates that a larger proportion of real-time bidding (RTB) traffic includes user identifiers.
`avg_page_weight`	The average file size in MB for a given URL, which is a signal that inversely correlates with ad performance.
`avg_cpu`	The average CPU usage for a given URL, which is a signal that inversely correlates with ad performance. CPU usage is measured in seconds.
`total_supply_paths`	The total number of supply paths an ad takes from the advertiser to the publisher's website or app where it is displayed. It includes the series of intermediaries involved in the selling and delivery of the ad inventory, such as ad exchanges, SSPs, and other resellers.
`reseller_count`	The number of resellers associated with the publisher.
`parent_entity_id`	The publisher ID of the domain that is the publisher’s parent company.
`owner_domain`	The owner domain listed in the publisher's `ads.txt` file.
`updated_at`	The most recent update to the publisher's statistics.
`similar_publishers`	A list of publisher IDs that are similar in content.
`tech_stack`	A breakdown of the technology providers detected on the publisher's site, categorized by type. For example, `ad_servers`, `analytics`, `identity_providers`, `video_players`, and `wrappers`.
`pagination`	An object for paginated publisher responses. For details, see Pagination property reference.

Get publisher list

This endpoint lists all the publishers in Sincera. It supports pagination.

For all publishers (paginated)

Here's the syntax for retrieving a paginated list of all publishers in the Sincera universe. The page query parameter is optional and defaults to 1.

curl -H "Authorization: Bearer AUTH_TOKEN_PLACEHOLDER" "https://open.sincera.io/api/publishers?page=PAGE_NUMBER_PLACEHOLDER"

Response object

The OpenSincera API returns a response object with a comprehensive list of all publishers. The following is a sample response for a list, truncated to two items.

{
  "publishers": [
    {
      "publisher_id": 1,
      "name": "Business Insider",
      "domain": "businessinsider.com",
      "primary_supply_type": "web",
      "owner_domain": "businessinsider.com",
      "manager_domain": null,
      "slug": "businessinsider-com"
    },
    {
      "publisher_id": 2,
      "name": "Business Outsider",
      "domain": "businessoutsider.com",
      "primary_supply_type": "web",
      "owner_domain": "businessoutsider.com",
      "manager_domain": null,
      "slug": "businessoutsider-com"
    }
  ],
  "pagination": {
    "page": 2,
    "total_count": 500000,
    "total_pages": 5000
  }
}

Pagination property reference

The following table lists the properties in the response object with paginated publisher list data.

Property Name	Description
`page`	The current page number returned.
`total_count`	The total number of publishers in the Sincera universe.
`total_pages`	The total number of pages available.

Get page-level metrics data

With your OpenSincera API token, you can retrieve a sample of page-level ad metrics for a publisher's individual pages (URLs).

Request syntax

Here's the syntax for retrieving page-level metrics in cURL. Use the same query parameters as the publisher endpoint (id or domain) to identify the publisher.

For a given publisher ID

curl -H "Authorization: Bearer AUTH_TOKEN_PLACEHOLDER" "https://open.sincera.io/api/urls?publisher_id=PUBLISHER_ID_PLACEHOLDER"

For a given publisher domain

curl -H "Authorization: Bearer AUTH_TOKEN_PLACEHOLDER" "https://open.sincera.io/api/urls?domain=PUBLISHER_DOMAIN_PLACEHOLDER"

Response object

The OpenSincera API returns a response object keyed by page URL, with each entry containing a sample of ad metrics for that page. The following is a sample response.

{
  "https://variety.com/2026/tv/news/chicago-pd-laroyce-hawkins-exit-season-14-1236800914": {
    "updated_at": "2026-07-06",
    "avg_a2cr": 0.15683,
    "min_a2cr": 0.0791,
    "max_a2cr": 0.2897,
    "avg_ads_in_view": 1.40627,
    "max_ads_in_view": 2.1368,
    "ad_refresh": "73.33",
    "ad_overlap": false
  }
}

Property reference

The following table lists the properties in the response object with page-level metrics data.

Property Name	Description
`updated_at`	The date when the page's metrics were last updated.
`avg_a2cr`	The average A2CR recorded for the page.
`min_a2cr`	The minimum A2CR recorded for the page.
`max_a2cr`	The maximum A2CR recorded for the page.
`avg_ads_in_view`	The average number of ads in view at the viewport level for the page.
`max_ads_in_view`	The maximum number of ads in view at the viewport level for the page.
`ad_refresh`	The average time in seconds before an ad unit refreshes on the page.
`ad_overlap`	If set to `true`, indicates that overlapping ads were detected on the page.

Get resolution market share data

With your OpenSincera API token, you can retrieve resolution market share data, which breaks down screen resolution usage by date and device type.

Request syntax

Here's the syntax for retrieving resolution market share data in cURL:

curl -H "Authorization: Bearer AUTH_TOKEN_PLACEHOLDER" "https://open.sincera.io/api/resolution_market_shares"

Response object

The OpenSincera API returns a response object with an array of resolution market share entries. The following is a sample response.

[
  {
    "date": "2026-01-01",
    "device": "desktop",
    "resolution": "2560x1440",
    "market_share": 2.94
  },
  {
    "date": "2026-01-01",
    "device": "desktop",
    "resolution": "360x800",
    "market_share": 1.55
  }
]

Property reference

The following table lists the properties in the response object with resolution market share data.

Property Name	Description
`date`	The date the market share data was recorded.
`device`	The device type associated with the resolution. For example, `desktop` or `mobile`.
`resolution`	The screen resolution, formatted as `WIDTHxHEIGHT`.
`market_share`	The percentage of traffic recorded at the given resolution.

Get ad systems data

With your OpenSincera API token, you can retrieve ad systems information, including its name, canonical domain, description and image.

Request syntax

Here's the syntax for retrieving general ad systems data in cURL:

curl -H "Authorization: Bearer AUTH_TOKEN_PLACEHOLDER" "https://open.sincera.io/api/adsystems"

Response object

The OpenSincera API returns a response object with ad systems metadata. The following is a sample response.

[
  {
    "id": 1,
    "name": "Rubicon Project",
    "canonical_domain": "rubiconproject.com",
    "image": {
      "url": "https://sincera-development.s3.amazonaws.com/uploads/adsystem/image/1/ZCwcY4yV_400x400.jpg"
    },
    "description": "Rubicon Project is an advertising automation platform enabling premium publishers to transact advertising brands."
  },
  {
    "id": 2,
    "name": "33Across",
    "canonical_domain": "33across.com",
    "image": {
      "url": "https://sincera-development.s3.amazonaws.com/uploads/adsystem/image/2/Aizp9so5_400x400.jpg"
    },
    "description": "33Across is a supply-side platform with integrated solutions to unlock addressability and monetization."
  },
  {
    "id": 3,
    "name": "PubMatic",
    "canonical_domain": "pubmatic.com",
    "image": {
      "url": "https://sincera-development.s3.amazonaws.com/uploads/adsystem/image/3/grm_XTmh_400x400.jpg"
    },
    "description": "PubMatic is an automation solutions company for an open digital media industry."
  }
]

Property reference

The following table lists the properties in the response object with ad system metadata.

Property Name	Description
`id`	The index of the ad system in the payload.
`name`	The external name of the ad system.
`canonical_domain`	The main domain of the ad system.
`image.url`	The image stored in Sincera for the ad system.
`description`	The description of the ad system as provided from their website.

Get Prebid module mappings

With your OpenSincera API token, you can retrieve Prebid module information, including its name, category, ad system ID, and detected count.

Request syntax

Here's the syntax for retrieving general Prebid module data in cURL:

curl -H "Authorization: Bearer AUTH_TOKEN_PLACEHOLDER" "https://open.sincera.io/api/mapping_modules"

Response object

The OpenSincera API returns a response object with Prebid module metadata. The following is a sample response.

[
  {
    "id": 1,
    "module_name": "brightcomBidAdapter",
    "module_category": "bid",
    "adsystem_id": 52,
    "detected_count": 4469
  },
  {
    "id": 2,
    "module_name": "adnNmInterstitial",
    "module_category": "formats",
    "adsystem_id": 776,
    "detected_count": 1
  },
  {
    "id": 3,
    "module_name": "guAnalyticsAdapter",
    "module_category": "analytics",
    "adsystem_id": null,
    "detected_count": 12
  }
]

Property reference

The following table lists the properties in the response object with Prebid module metadata.

Property Name	Description
`id`	The index of the module in the payload.
`module_name`	The external name of the module.
`module_category`	The type of module. Examples include: `bid`, `formats`, `analytics`, `id`, and `rtd`.
`adsystem_id`	The ad system the module is associated with.
`detected_count`	The number of times the module was detected in the previous 90 days.