API Documentation

Everything you need to integrate the RichAPI API into your product.

Web Scraping

Website Intelligence

Flagship: comprehensive website report — meta tags, tech stack, pixels, social links, emails, SSL, headers in one call.

POST
/api/v1/website_intelligence
5 credits per call

Parameters

FieldTypeRequiredDescription
urlstringYesWebsite URL to analyze
modulesarrayNoSpecific modules to run (defaults to all). Options: meta_tags, json_ld, pixels, tech_stack, social_links, emails, ssl, headers
cachebooleanNoUse cached data if available

Response fields

FieldTypeDescription
metaTagsobjectOpenGraph, Twitter Card, and SEO meta tags
techStackarrayDetected technologies with name, category, version
pixelsarrayTracking pixels and analytics tags detected
socialLinksobjectSocial media profile links (linkedin, twitter, facebook, etc.)
emailsarrayEmail addresses found on the homepage
sslobjectSSL certificate info (valid, issuer, expiresAt)
headersobjectNotable HTTP response headers
jsonLdarrayJSON-LD structured data objects

Code

curl -X POST https://api.richapi.ai/api/v1/website_intelligence \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://hubspot.com"
}'

Try it

Sign in to test this endpoint with your API key.

Sign in to try

Tech Stack Detector

Detect 100+ technologies (CMS, analytics, CDN, frameworks, payments) + GTM intelligence signals.

POST
/api/v1/web_tech_stack
1 credit per call

Parameters

FieldTypeRequiredDescription
urlstringYesWebsite URL to analyze
cachebooleanNoUse cached data if available

Response fields

FieldTypeDescription
technologiesarrayList of detected technologies (name, category, version where available)
categoriesobjectTechnologies grouped by category (CMS, Analytics, CDN, Framework, etc.)
gtmSignalsobjectGTM intelligence signals (ad pixels, CRM tools, chat widgets, etc.)

Code

curl -X POST https://api.richapi.ai/api/v1/web_tech_stack \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://hubspot.com"
}'

Try it

Sign in to test this endpoint with your API key.

Sign in to try

Google Search Scraper

Scrape Google Search results synchronously.

POST
/api/v1/google_search_scraper_sync

Parameters

FieldTypeRequiredDescription
querystringYesSearch query string
max_pages_per_queryintegerNoMaximum number of result pages to fetch

Response fields

FieldTypeDescription
titlestringTitle of the search result
urlstringURL of the search result
descriptionstringSnippet/description of the search result

Code

curl -X POST https://api.richapi.ai/api/v1/google_search_scraper_sync \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "best CRM software 2025",
  "max_pages_per_query": 2
}'

Try it

Sign in to test this endpoint with your API key.

Sign in to try

Meta Tags Extractor

Extract OpenGraph, Twitter Card, and SEO meta tags from any URL. Returns title, description, images, favicon.

POST
/api/v1/web_meta_tags
1 credit per call

Parameters

FieldTypeRequiredDescription
urlstringYesPage URL to extract meta tags from
cachebooleanNoUse cached data if available
cache_bustbooleanNoForce fresh fetch, ignoring cache

Response fields

FieldTypeDescription
titlestringPage title
descriptionstringMeta description
ogobjectOpenGraph tags (og:title, og:description, og:image, og:url, etc.)
twitterobjectTwitter Card tags (twitter:title, twitter:description, twitter:image, etc.)
faviconstringFavicon URL
canonicalstringCanonical URL

Code

curl -X POST https://api.richapi.ai/api/v1/web_meta_tags \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://stripe.com"
}'

Try it

Sign in to test this endpoint with your API key.

Sign in to try

Tracking Pixel Detector

Detect Google Tag Manager, GA4, Facebook Pixel, LinkedIn Insight, TikTok Pixel and more on any site.

POST
/api/v1/web_pixels
1 credit per call

Parameters

FieldTypeRequiredDescription
urlstringYesWebsite URL to scan for tracking pixels
cachebooleanNoUse cached data if available

Response fields

FieldTypeDescription
pixelsarrayList of detected pixels/tags (name, id where available)
gtmarrayGoogle Tag Manager container IDs
ga4arrayGA4 measurement IDs
facebookPixelarrayFacebook Pixel IDs
linkedinInsightbooleanWhether LinkedIn Insight Tag was detected
tiktokPixelbooleanWhether TikTok Pixel was detected

Code

curl -X POST https://api.richapi.ai/api/v1/web_pixels \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://hubspot.com"
}'

Try it

Sign in to test this endpoint with your API key.

Sign in to try


Website Email Extractor

Extract email addresses by crawling multiple pages of a website.

POST
/api/v1/web_emails
2 credits per call

Parameters

FieldTypeRequiredDescription
urlstringYesRoot URL to start crawling from
max_pagesintegerNoMaximum number of pages to crawl (default 5)
cachebooleanNoUse cached data if available

Response fields

FieldTypeDescription
emailsarrayDeduplicated list of email addresses found across crawled pages
pagesCrawledintegerNumber of pages actually crawled

Code

curl -X POST https://api.richapi.ai/api/v1/web_emails \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://stripe.com",
  "max_pages": 5
}'

Try it

Sign in to test this endpoint with your API key.

Sign in to try

Web Scraper

Scrape full page HTML and markdown with anti-bot protection via Firecrawl.

POST
/api/v1/web_scrape
1 credit per call

Parameters

FieldTypeRequiredDescription
urlstringYesURL of the page to scrape
formatsarrayNoOutput formats to include (e.g. html, markdown, links)
cachebooleanNoUse cached data if available

Response fields

FieldTypeDescription
htmlstringFull page HTML
markdownstringPage content converted to Markdown
titlestringPage title
statusCodeintegerHTTP status code returned by the target page

Code

curl -X POST https://api.richapi.ai/api/v1/web_scrape \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://example.com",
  "formats": [
    "markdown"
  ]
}'

Try it

Sign in to test this endpoint with your API key.

Sign in to try

Similarweb Scraper

Scrape Similarweb overview data for one or more domains.

POST
/api/v1/similarweb_scraper_sync

Parameters

FieldTypeRequiredDescription
domainstringYesDomain of the website to analyze (e.g. stripe.com)

Response fields

FieldTypeDescription
domainstringDomain name
categorystringWebsite category
rankGlobalnumberGlobal rank
totalVisitsnumberTotal visits
engagementobjectEngagement metrics
topKeywordsarrayTop keywords
similarSitesarraySimilar sites

Code

curl -X POST https://api.richapi.ai/api/v1/similarweb_scraper_sync \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "domain": "stripe.com"
}'

Try it

Sign in to test this endpoint with your API key.

Sign in to try

JSON-LD Extractor

Extract structured JSON-LD data (Schema.org) from any web page — products, articles, organizations.

POST
/api/v1/web_json_ld
1 credit per call

Parameters

FieldTypeRequiredDescription
urlstringYesPage URL to extract JSON-LD from
cachebooleanNoUse cached data if available

Response fields

FieldTypeDescription
itemsarrayList of JSON-LD objects found on the page (each is a Schema.org entity)
items[][@type]stringSchema.org type (e.g. Article, Product, Organization, BreadcrumbList)

Code

curl -X POST https://api.richapi.ai/api/v1/web_json_ld \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://www.bbc.com/news"
}'

Try it

Sign in to test this endpoint with your API key.

Sign in to try

Sitemap Extractor

Extract all URLs from a website's sitemap (XML, robots.txt, or crawl discovery).

POST
/api/v1/web_sitemap
1 credit per call

Parameters

FieldTypeRequiredDescription
urlstringYesWebsite root URL or direct sitemap URL
max_urlsintegerNoMaximum number of URLs to return
cachebooleanNoUse cached data if available

Response fields

FieldTypeDescription
urlsarrayList of discovered URLs from the sitemap
countintegerTotal number of URLs found

Code

curl -X POST https://api.richapi.ai/api/v1/web_sitemap \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://stripe.com"
}'

Try it

Sign in to test this endpoint with your API key.

Sign in to try