Matched string in content failure responses

Responses triggered by fail_if_content_contains now identify the first visible string that matched.

Changelog1 min read

Written by

Dmytro Krasun

Published on

Errors triggered by the fail_if_content_contains option now include the first visible string that matched in the matched_string response field.

For example, make the following request:

https://api.screenshotone.com/take?access_key=<API KEY>&url=https://example.com&fail_if_content_contains=Example%20domain

The API returns:

{
"is_successful": false,
"error_message": "The page content contains the specified string by the `fail_if_content_contains` option. If it seems to be a mistake or not what you expected, please, reach out to `support@screenshotone.com` as quickly as possible, and will assist and try to resolve your problem.",
"error_code": "content_contains_specified_string",
"documentation_url": "https://screenshotone.com/docs/errors/content-contains-specified-string/",
"matched_string": "Example Domain"
}

The match remains case-insensitive, while matched_string preserves the text as it appears on the page. If you specify multiple values, the field contains the first visible match found on the page.

See the fail_if_content_contains option documentation for more details.

Read more product updates

New features, bug fixes, and optimizations...

View all product updates
Hosted ScreenshotOne MCP server is now available

Hosted ScreenshotOne MCP server is now available

Connect your AI agents to ScreenshotOne through the hosted MCP server with OAuth. No local server or copied API key is required.

Read more

1 min read

Screenshot URL in webhooks

Screenshot URL in webhooks

Now, you can get the screenshot URL in the webhook response.

Read more

1 min read

Include shadow DOM when requesting the page content

Include shadow DOM when requesting the page content

A new version of the ScreenshotOne API has been just deployed. It allows you to include the shadow DOM contents when requesting the page content.

Read more

1 min read

Automate website screenshots

Exhaustive documentation, ready SDKs, no-code tools, and other automation to help you render website screenshots and outsource all the boring work related to that to us.