openapi: 3.1.0
info:
title: SEO Data Extractor
description: 'Give this API a web address and it will visit that page, then hand back everything an SEO professional needs
to know: the page title, meta description, meta keywords, robots instructions, canonical link, H1/H2/H3 headings, how
many links are on the page, and the HTTP status code. No setup required — just paste a URL and get structured data back
in under two seconds.'
version: 1.0.0
contact:
name: _done
url: https://forms.gle/5KzuSFH7p8hHtDmz7
email: info@underscoredone.com
x-openapi-url: https://seo-data-extractor.underscoredone.com/openapi.json
x-logo:
url: https://underscoredone.com/logo.png
altText: _done
x-guidance: Send a single URL string in the 'url' field. The API will fetch that page and return structured SEO data. If
the page redirects, the final destination URL and its status code are returned. All missing fields come back as empty
strings, never null. The 'num_links' field is always an integer. Use the returned fields directly for SEO audits, content
comparisons, or monitoring pipelines. Do not send multiple URLs in one call — make one call per URL.
x-ai-instructions: Send a single URL string in the 'url' field. The API will fetch that page and return structured SEO data.
If the page redirects, the final destination URL and its status code are returned. All missing fields come back as empty
strings, never null. The 'num_links' field is always an integer. Use the returned fields directly for SEO audits, content
comparisons, or monitoring pipelines. Do not send multiple URLs in one call — make one call per URL.
x-provider: _done — single-purpose utility APIs for developers and AI agents. Pay per call with USDC on Base Mainnet or
Solana Mainnet.
x-pricing:
model: pay-per-call
currency: USDC
network: Base Mainnet or Solana Mainnet
price: $0.01
x-keywords:
- parsing
- seo
- data
- extractor
- meta tags
- title tag
- canonical
- headings
- seo audit
- competitor analysis
- webpage scraping
- robots
- h1
- h2
- utility
- api
- ai-agent
- pay-per-call
- usdc
- x402
x-category: seo
x-provider-url: https://underscoredone.com
x-agentcash-auth:
mode: paid
x-402:
price: $0.01
network: eip155:8453
asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
pay_to: '0xE9740820225B3918b4ddd1292C7cA4Ca0e2C2F08'
facilitator: https://api.cdp.coinbase.com/platform/v2/x402
scheme: exact
description: 'Give this API a web address and it will visit that page, then hand back everything an SEO professional needs
to know: the page title, meta description, meta keywords, robots instructions, canonical link, H1/H2/H3 headings, how
many links are on the page, and the HTTP status code. No setup required — just paste a URL and get structured data back
in under two seconds.'
mime_type: application/json
networks:
- network: eip155:8453
asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
pay_to: '0xE9740820225B3918b4ddd1292C7cA4Ca0e2C2F08'
- network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
asset: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
pay_to: 8ugAWAXDB8V18kiUrGZTq1oMvU3C6Fxs8hfC6rvzQT3b
paths:
/extract:
post:
tags:
- seo
- seo metadata
- on page seo
- meta tags
- extract meta tags
- page title and headings
- seo audit
- meta description
- open graph tags
- technical seo
- seo data
- canonical url
- h1 tags
- seo analysis
- page metadata
- search engine optimization
- search engine optimisation
summary: Visit a URL and pull out every important SEO field in one call.
description: Visit the web address you provide and pull out every important SEO field in one go.
operationId: handler_extract_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/Request'
required: true
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/Response'
examples:
success:
summary: Successful response
value:
api_version: 1.0.0
url: https://www.onescales.com
final_url: https://onescales.com/
status_code: 200
title_tag: One Scales - Ecommerce, Analytics, Tech, Shopify & Marketing Tutorials
meta_description: We Create Tutorials, How-To's and Share Insight about E-commerce, Web, Tech, AI, Shopify,
Analytics, SEO, PPC, Marketing and More.
meta_keywords: ''
meta_robots: ''
canonical_tag: https://onescales.com/
h1_tags: []
h2_tags:
- Join our Newsletter
- Size chart
- Follow Us on Social Media
h3_tags:
- Intro to One Scales
num_links: 187
'422':
description: Unprocessable — a required field is missing or the wrong type. Check the detail field for specifics.
content:
application/json:
schema:
type: object
properties:
detail:
type: array
'402':
description: Payment required. Send a signed USDC payment on Base Mainnet or Solana Mainnet using the x402 protocol.
headers:
X-Payment-Response:
description: x402 payment challenge — base64-encoded JSON with payment details.
schema:
type: string
'400':
description: Bad request — your input failed validation or could not be processed. Check the detail field for specifics.
content:
application/json:
schema:
type: object
properties:
detail:
type: string
x-ai-instructions: Send a single URL string in the 'url' field. The API will fetch that page and return structured SEO
data. If the page redirects, the final destination URL and its status code are returned. All missing fields come back
as empty strings, never null. The 'num_links' field is always an integer. Use the returned fields directly for SEO
audits, content comparisons, or monitoring pipelines. Do not send multiple URLs in one call — make one call per URL.
x-guidance: Send a single URL string in the 'url' field. The API will fetch that page and return structured SEO data.
If the page redirects, the final destination URL and its status code are returned. All missing fields come back as
empty strings, never null. The 'num_links' field is always an integer. Use the returned fields directly for SEO audits,
content comparisons, or monitoring pipelines. Do not send multiple URLs in one call — make one call per URL.
x-payment-info:
price:
fixed:
mode: fixed
currency: USD
amount: '0.01'
protocols:
- x402: {}
components:
schemas:
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
Request:
properties:
url:
type: string
maxLength: 2048
title: Url
description: 'The full web address of the page you want to analyse, including http:// or https://. Example: https://www.example.com'
timeout_seconds:
type: integer
maximum: 15.0
minimum: 1.0
title: Timeout Seconds
description: How many seconds to wait for the page to respond before giving up. Must be between 1 and 15. Defaults
to 10 if not provided.
default: 10
type: object
required:
- url
title: Request
example:
url: https://www.example.com
Response:
properties:
api_version:
type: string
title: Api Version
description: API version
default: 1.0.0
url:
type: string
title: Url
description: The original web address you submitted.
final_url:
type: string
title: Final Url
description: The web address of the page after any redirects.
status_code:
type: integer
title: Status Code
description: The HTTP status code the page returned, for example 200 means OK, 404 means not found.
title_tag:
type: string
title: Title Tag
description: The page title as set by the website, shown in browser tabs and search results. Empty string if not
found.
meta_description:
type: string
title: Meta Description
description: The short description the website provides to search engines. Empty string if not present.
meta_keywords:
type: string
title: Meta Keywords
description: Keywords the website declares for search engines. Mostly unused today. Empty string if not present.
meta_robots:
type: string
title: Meta Robots
description: Instructions the website gives to search engine crawlers, for example 'noindex'. Empty string if not
present.
canonical_tag:
type: string
title: Canonical Tag
description: The preferred URL the website declares for search engines to index. Empty string if not present.
h1_tags:
items:
type: string
type: array
title: H1 Tags
description: All top-level headings found on the page. Empty list if none.
h2_tags:
items:
type: string
type: array
title: H2 Tags
description: All second-level headings found on the page. Empty list if none.
h3_tags:
items:
type: string
type: array
title: H3 Tags
description: All third-level headings found on the page. Empty list if none.
num_links:
type: integer
title: Num Links
description: The total number of clickable links (anchor tags with an href) found on the page.
type: object
required:
- url
- final_url
- status_code
- title_tag
- meta_description
- meta_keywords
- meta_robots
- canonical_tag
- h1_tags
- h2_tags
- h3_tags
- num_links
title: Response
example:
api_version: 1.0.0
canonical_tag: https://onescales.com/
final_url: https://onescales.com/
h1_tags: []
h2_tags:
- Join our Newsletter
- Size chart
- Follow Us on Social Media
h3_tags:
- Intro to One Scales
meta_description: We Create Tutorials, How-To's and Share Insight about E-commerce, Web, Tech, AI, Shopify, Analytics,
SEO, PPC, Marketing and More.
meta_keywords: ''
meta_robots: ''
num_links: 187
status_code: 200
title_tag: One Scales - Ecommerce, Analytics, Tech, Shopify & Marketing Tutorials
url: https://www.onescales.com
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError
securitySchemes:
siwx:
type: apiKey
in: header
name: SIGN-IN-WITH-X
description: CAIP-122 wallet signature for repeat access after payment
servers:
- url: https://seo-data-extractor.underscoredone.com
description: Production
tags:
- name: seo
- name: seo metadata
- name: on page seo
- name: meta tags
- name: extract meta tags
- name: page title and headings
- name: seo audit
- name: meta description
- name: open graph tags
- name: technical seo
- name: seo data
- name: canonical url
- name: h1 tags
- name: seo analysis
- name: page metadata
- name: search engine optimization
- name: search engine optimisation
x402Version: 2
x-payment-accepts:
- scheme: exact
network: eip155:8453
payTo: '0xE9740820225B3918b4ddd1292C7cA4Ca0e2C2F08'
asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
- scheme: exact
network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
payTo: 8ugAWAXDB8V18kiUrGZTq1oMvU3C6Fxs8hfC6rvzQT3b
asset: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v