Sources & Content

A source represents a page URL that has been processed by FAQSIR. When the widget loads on a page, it submits the URL to the API, which extracts the content and generates AI-powered features from it.

What Is a Source?

A source is the fundamental unit of content in FAQSIR. Each unique page URL you process becomes a source, and the AI generates the following from it:

Summary paragraphs — A concise overview of the article's key points
FAQs — Relevant questions and answers derived from the content
Sentiment score — An overall tone analysis (Plus and Pro plans)
Video summary — An AI-narrated video (Plus and Pro plans, requires video credits)

Each source is identified by a UUID, which is used across the API for chat and analytics interactions.

How Sources Are Created

Sources are created automatically when the widget loads on a new page URL:

The widget mounts on the page and reads the current URL
It sends a POST /source request to the API with the page URL
The API checks if this URL has already been processed for your site
If it's a new URL, a source is created and queued for AI processing.
If the URL already exists, the cached content is returned immediately.

Deduplication

The API deduplicates sources by URL within each site. The same URL submitted multiple times within a billing period only counts as one source. This means repeated page loads do not consume additional quota.

Pre-Generating Content

While the widget calls the API automatically on page load, you don't have to wait for the first visitor to trigger content generation. You can call the Source endpoint directly from your CMS or publishing workflow — for example, as a post-publish webhook or a step in your CI/CD pipeline.

This is particularly valuable for two reasons:

Instant experience for visitors — Summaries, FAQs, and sentiment are ready before anyone lands on the page. Without pre-generation, the first visitor triggers generation and may see a loading state.
Video readiness — Video summaries can take several minutes to produce and upload to YouTube. Pre-generating ensures the video tab is populated from the start, rather than appearing later.

A simple integration might look like this:

# Call after publishing an article in your CMS
curl -X POST https://faqsir.com/api/source \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"url": "https://example.com/article/my-new-article"}'

Pro tip

If you publish content on a schedule, consider calling the Source endpoint as soon as the article goes live. This gives the AI enough time to generate all content — including video — so everything is ready for your audience from the moment of publication.

Press Releases (Sources)

All plans include unlimited press releases (sources) per month. There is no cap on the number of unique page URLs you can process. See API Limits for full details on rate limits and other quotas.

Processing Pipeline

When a new source is created, it goes through a processing pipeline:

1. Content Extraction

The API fetches and extracts the article content from your page URL. This includes the main body text, headings, and any structured data.

2. AI Analysis

The extracted content is processed by the AI to generate:

Summary — Key points condensed into readable paragraphs
FAQs — Questions a reader might ask, with comprehensive answers
Sentiment — A tone score from 1 (very negative) to 10 (very positive) — available on Plus and Pro plans

3. Video Generation (Plus and Pro)

If your plan includes video generation and you have available video credits, a video summary is automatically queued. The video is generated from the summary content and uploaded to YouTube.

4. Hosted News Article (Plus and Pro)

On Plus and Pro plans, a hosted news article page is generated from the source content, complete with SEO metadata and schema markup.

Processing Priority

Sources are processed in priority order based on your plan tier:

Plan	Priority Level	Description
Starter	Low	Processed after higher-priority sources
Plus	Default	Standard processing queue
Pro	High	Processed with highest priority

This means Pro subscribers will see their content generated fastest, particularly during periods of high system load.

Managing Sources

From the FAQSIR dashboard, you can view and manage all your site's sources. Each source entry shows:

The page URL
Processing status
Generated content preview
Video status (if applicable)
Creation date

Content Updates

Currently, source content is generated once when the URL is first submitted. If the underlying article changes significantly, the existing generated content will reflect the original version. Future updates to re-process sources may be available.