{"uid":"cap_KxpJ1Ms7hVc8_d6h4H_B3","slug":"main-image-detect-e5f388e2","name":"main-image-detect","description":"Main image of a page: the Open Graph / Twitter image when declared, else the largest content image by declared dimensions, with alt text, resolved URL, content type and byte size via a HEAD request. Get a representative thumbnail for any URL. $0.01 per page.","url":"https://intel.rallylive.ca/page/main-image","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_MghGRpeRcsf8nfn0ogQAy","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Extracts the main representative image from any URL by preferring Open Graph/Twitter meta tags, then falling back to the largest declared content image, returning alt text, resolved URL, content type, and byte size.","exampleAgentPrompt":"What's the main image for this URL — https://www.bbc.com/news/technology? Give me the resolved image URL, its content type, and file size.","exampleUseCases":[{"title":"Link preview thumbnail for shared URLs","prompt":"I'm building a link preview card — can you grab the main image for https://techcrunch.com/2024/01/15/openai-news/ so I can show a thumbnail next to the headline?"},{"title":"Social media OG image audit","prompt":"Check what image shows up when someone shares https://mystore.com/products/running-shoes on social media — I want the resolved image URL, alt text, and file size."},{"title":"Content aggregator image enrichment","prompt":"For this article URL https://www.wired.com/story/best-laptops/, find the representative thumbnail image — I need the image URL, its format, and how big the file is in bytes."}],"resultDescription":"Returns the resolved URL of the main page image (Open Graph > Twitter Card > largest declared content image), along with its alt text, MIME content type, and byte size obtained via a HEAD request against the image URL.","failureModes":["Page has no images and no OG/Twitter meta tags — returns null or empty image result","Target URL is unreachable or returns non-2xx status — fetch fails with an error","Image URL found in meta tags returns a 4xx/5xx on HEAD request — byte size and content type may be unavailable","Page blocks crawlers via robots.txt or bot detection — HTML may not be accessible","Redirects to a login wall or CAPTCHA page — no meaningful image can be detected"],"whenToPreferThis":"Use this endpoint when you need a single representative thumbnail for any public URL without writing custom scraping logic. It is ideal for link-preview generation, content aggregation pipelines, and social-sharing audits where you want the canonical OG/Twitter image with fallback to the largest declared image — and you also need file metadata (content type, byte size) without downloading the full image.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T13:12:27.505Z","isFirstParty":false}