Research
USAFacts logo

USAFacts API

usafacts.org

US government data - metrics, topics, state comparisons, and data reports.

Actions
10
Category
Research
Login
Not required
Output
JSON

Call the USAFacts API

Submit a task, then poll the job until it settles. This example runs act_usafacts_org_answer_detail_page.

curl -X POST https://api.anakin.io/v1/wire/task \
  -H "X-API-Key: $ANAKIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "action_id": "act_usafacts_org_answer_detail_page",
    "params": {
      "answer_slug": "is-the-population-growing-or-shrinking",
      "country_slug": "united-states"
    }
  }'

10 actions on usafacts.org

Read

  • Answer Details

    act_usafacts_org_answer_detail_pageread1 credit / call

    Returns a country-level data answer with title, answer text, source, and dates.

    answer_slug
    string · required
    country_slug
    string · required
  • Article Report

    act_usafacts_org_article_report_pageread1 credit / call

    Returns a data article's title, summary, author, dates, section, and linked datasets.

    article_slug
    string · required
  • Chart Metric Data

    act_usafacts_org_chart_metric_dataread2 credits / call

    Returns a chart's data bindings, datasets, and visualization settings.

    flourish_api_key
    string · required
    chart_template
    string · required
    chart_version
    string · required
  • Homepage Feed

    act_usafacts_org_homepage_ssrread1 credit / call

    Returns featured homepage answers and articles with titles, URLs, and page types.

  • Related Content Recommendations

    act_usafacts_org_related_content_recommendationsread2 credits / call

    Returns related answers and articles with titles, URLs, images, and dates for a page.

    builder_id
    string · required
    source_page_type
    string
    limit
    string
  • Search Results

    act_usafacts_org_search_stream_resultsread2 credits / call

    Searches USAFacts by keyword and returns matching answers and articles with titles, URLs, and summaries.

    search_query
    string · required
  • State Comparison Answer

    act_usafacts_org_state_comparison_answerread1 credit / call

    Returns a state-level data answer with title, summary, body, source, and dates.

    answer_slug
    string · required
    state_slug
    string · required
  • Topic Category Page

    act_usafacts_org_topic_category_pageread1 credit / call

    Returns a topic page's guides with titles, URLs, summaries, and category details.

    topic_slug
    string · required
  • Topic Content Listing

    act_usafacts_org_topic_content_listingread2 credits / call

    Returns paginated answers and articles for a topic category with titles, URLs, and summaries.

    category_properties_json
    string · required
    page
    string
  • Topic Guide Index

    act_usafacts_org_topic_guide_indexread2 credits / call

    Returns a guide's questions with titles, URLs, categories, and answer summaries.

    guide_page_id
    string · required

USAFacts API questions

Is there an API for USAFacts?
USAFacts does not offer a public data API for this, but Anakin Wire provides 10 maintained endpoints for usafacts.org. You call Anakin's REST API with an action ID and parameters and get structured JSON back; Anakin handles the browser, proxies, anti-bot, and parsing.
How do I scrape USAFacts data?
POST to https://api.anakin.io/v1/wire/task with your API key, the action ID, and its parameters, then poll GET /v1/wire/jobs/{id} until the job settles. There is nothing to install and no scraper to maintain — when usafacts.org changes its markup, Anakin updates the action.
Do I need a USAFacts account?
No. Every USAFacts action listed here runs anonymously — no account and no credentials required.
What does the USAFacts API cost?
Usage-based credits, charged per call and refunded automatically when a job fails. New accounts start with 300 free credits and no card. See anakin.io/pricing for the current rates.

More Research APIs

All Research sites