--- title: Audit Webpage Images for SEO API slug: audit-webpage-images-for-seo url: https://apyhub.com/freejosephe/service/audit-webpage-images-for-seo provider: Youssef Ferri tags: [seo-audit, image-alt-text, alt-text, accessibility, page-audit, image-optimization] auth: api_key version: 1.0.1 service_type: sync endpoints: 1 atoms: 200 mcp: true --- # Audit Webpage Images for SEO API Audit one page for image alt text, image speed issues, and page SEO signals. Returns scores, per-image findings, and metadata for QA. ## Endpoints | Method | URL | Description | Atoms | | --- | --- | --- | --- | | GET | `https://api.eu.apyhub.com/freejosephe/audit-webpage-images-for-seo/v1/image-seo/audit` | What it does Audits a single page for image SEO and alt-text issues. It takes a page url and option… | 200 | ## Endpoint reference ### Image SEO + alt text audit of one page `GET https://api.eu.apyhub.com/freejosephe/audit-webpage-images-for-seo/v1/image-seo/audit` · 200 atoms · accepts `application/json` · returns `application/json` | Parameter | In | Type | Required | Description | | --- | --- | --- | --- | --- | | `url` | query | string (uri) | yes | | | `lang` | query | string | no | One of: auto, en, fr, ar. Default: `auto`. | #### Quickstart Audit a page for image SEO by providing the page URL as a query parameter. ```bash curl -X GET "https://api.eu.apyhub.com/freejosephe/audit-webpage-images-for-seo/v1/image-seo/audit?url=https://apyhub.com/blog/ultimate-guide-ai-api-marketplaces-2026&lang=auto" \ -H "apy-token: $APY_TOKEN" ``` #### What you'll get back Returns a JSON object with top-level fields such as `url`, `page`, `grade`, `score`, `images`, `language`, `final_url`, `audited_at`, `robots_txt`, and `score_breakdown`. The `page` and `images` fields are objects that contain the audited page metadata and image analysis results. ```json { "url": "https://apyhub.com/blog/ultimate-guide-ai-api-marketplaces-2026", "final_url": "https://apyhub.com/blog/ultimate-guide-ai-api-marketplaces-2026", "redirects": 0, "audited_at": "2026-10-23T07:11:57.463Z", "score": 93, "grade": "A", "score_breakdown": [ { "issue": "missing_max_image_preview_large", "points": 4 }, { "issue": "image_speed", "points": 3, "detail": { "over_200kb": 0, "missing_dimensions": 2, "not_lazy_loaded": 0, "legacy_format": 1 } } ], "language": "en", "page_language": "en", "site_name": "ApyHub", "language_note": "Suggestions reuse the page's own words (caption, title, H1, file name) with connector words in this language. Other languages are null (not_page_language) when they would only repeat the page's words: nothing is machine-translated.", "page": { "title": "The ultimate guide to AI API marketplaces — ApyHub Blog", "title_length": 55, "meta_description": "The ApyHub Marketplace offers curated APIs, one subscription, flexible pricing, EU hosting, and powerful AI job management for developers.", "meta_description_length": 138, "robots_meta": null, "canonical": "https://apyhub.com/blog/ultimate-guide-ai-api-marketplaces-2026", "open_graph": { "title": "The ultimate guide to AI API marketplaces", "description": "The ApyHub Marketplace offers curated APIs, one subscription, flexible pricing, EU hosting, and powerful AI job management for developers.", "image": "https://assets.apyhub.com/prod/image-2fe39592-335c-4a81-ad6c-375aa653151e.webp", "type": "article", "url": "https://apyhub.com/blog/ultimate-guide-ai-api-marketplaces-2026", "site_name": "ApyHub" }, "twitter_card": "summary_large_image", "h1": "The ultimate guide to AI API marketplaces", "h1_count": 1, "topic": "The ultimate guide to AI API marketplaces", "html_lang": "en", "json_ld": { "present": true, "blocks": 2, "invalid_blocks": 0, "types": [ "BlogPosting", "BreadcrumbList" ] }, "issues": [ "missing_max_image_preview_large" ] }, "images": { "img_tags_on_page": 2, "analyzed": 2, "analysis_cap": 150, "total_found": 2, "decorative": 0, "content_images": 2, "with_alt_problems": 0, "alt_issue_counts": {}, "speed_issue_counts": { "over_200kb": 0, "missing_dimensions": 2, "not_lazy_loaded": 0, "legacy_format": 1 }, "size_checked": 2, "size_checks_skipped": {}, "returned": 2, "list": [ { "src": "https://assets.apyhub.com/prod/image-2fe39592-335c-4a81-ad6c-375aa653151e.webp", "position": 1, "current_alt": "Cover illustration for The ultimate guide to AI API marketplaces", "alt_issues": [], "suggested_alt": "Cover illustration for The ultimate guide to AI API marketplaces", "confidence": "ok", "suggestions": null, "suggestion_reasons": null, "width": null, "height": null, "has_dimensions": false, "lazy_loaded": false, "is_logo": false, "speed_issues": [ "missing_dimensions" ], "format": "modern", "file_size_kb": 65, "size_checked": true }, { "src": "https://assets.apyhub.com/blog/apis-for-developers-apyhub/start-cta.png", "position": 2, "current_alt": "Explore ApyHub", "alt_issues": [], "suggested_alt": "Explore ApyHub", "confidence": "ok", "suggestions": null, "suggestion_reasons": null, "width": null, "height": null, "has_dimensions": false, "lazy_loaded": true, "is_logo": false, "speed_issues": [ "missing_dimensions", "legacy_format" ], "format": "legacy", "file_size_kb": 10, "size_checked": true } ] }, "html_bytes_read": 175384, "html_truncated": false, "robots_txt": { "checked": true, "status": 200, "allowed": true, "crawl_delay": null }, "notes": [ "Suggested alts reuse only words already on the page (caption, title attribute, file name, H1, site name). confidence=manual means no honest context was found: write it by hand.", "SVG, tracking pixels and icons under 40x40 are skipped. alt=\"\" is valid for decorative images and is not penalised." ], "requests_used": 10 } ``` ## About ## What it does Image SEO Audit checks a webpage for image SEO and alt-text issues, then returns a score, grade, and a breakdown of what needs attention. Send a page `url`, optionally set `lang` to `auto`, `en`, `fr`, or `ar`, and get back the page-level audit plus image-by-image findings. Use it to spot missing or weak alt text, duplicated or generic descriptions, and image delivery issues that can affect crawlability and accessibility. The response includes page signals such as `h1`, `title`, `issues`, `canonical`, `html_lang`, `open_graph`, `robots_meta`, and `meta_description`, along with `json_ld` and `h1_count` for broader on-page context. For each image found, you get its `src`, `position`, current alt text, `alt_issues`, `confidence`, `lazy_loaded` status, and any `suggestions` available in Arabic, English, or French. The audit also flags speed-related problems like missing dimensions, legacy formats, non-lazy-loaded images, and large files when size checks are available. Image SEO Audit is useful for content teams, technical SEOs, and CMS workflows that need to review published pages, prioritise fixes, and track whether image markup is helping or hurting search visibility. ## Usage Base URL: `https://api.eu.apyhub.com` (default region — see `GET https://apyhub.com/api/public/regions` for the rest). Authenticate with an ApyHub API key in the `apy-token` header. Full docs and a live playground: https://apyhub.com/freejosephe/service/audit-webpage-images-for-seo