Skip to main content

Validate Source

POST
/v1/sources/validate
Check if a URL can be used as a source. Returns whether the URL is crawlable and any discovered RSS feeds.

Request body

FieldTypeRequiredDescription
urlstringYesURL to validate
curl -X POST https://twixb.com/api/v1/sources/validate \
  -H "X-API-Key: twxb_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://techcrunch.com"}'

Response

{
  "url": "https://techcrunch.com",
  "source_type": "blog",
  "crawlable": true,
  "error": null,
  "rss_feeds": [
    {
      "url": "https://techcrunch.com/feed/",
      "title": null,
      "description": null,
      "is_category_match": false
    }
  ],
  "recommended_feed": "https://techcrunch.com/feed/"
}

Response fields

FieldTypeDescription
crawlablebooleanWhether the URL can be used as a source
source_typestringDetected source type
errorstringError message if not crawlable
rss_feedsarrayDiscovered RSS feeds
recommended_feedstringBest RSS feed to use