--- type: "firecrawl-provider" description: "Released NAEP test questions from the NAEP Questions Tool on The Nation's Report Card (nationsreportcard.gov/nqt), published by the National Center for Education Statistics: list subjects, grades, years and content classifications; search released items for grades 4, 8 and 12 (and long-term trend ages 9, 13 and 17) in the arts, civics, economics, geography, U.S. history, mathematics, reading, science, technology and engineering literacy and writing; and read one item with its question and choices, answer key, scoring guide, sample student responses and national percent correct. NAEP material is public domain; passages and images cited as third-party copyright are withheld." use_when: "Released NAEP test questions from the NAEP Questions Tool on The Nation's Report Card (nationsreportcard.gov/nqt), published by the National Center for Education Statistics: list subjects, grades, years and content classifications; search released items for grades 4, 8 and 12 (and long-term trend ages 9, 13 and 17) in the arts, civics, economics, geography, U.S. history, mathematics, reading, science, technology and engineering literacy and writing; and read one item with its question and choices, answer key, scoring guide, sample student responses and national percent correct. NAEP material is public domain; passages and images cited as third-party copyright are withheld." categories: "Research" capabilities: 3 credits_per_call: 5 --- # NAEP Questions Tool on Firecrawl Alexandria Released NAEP test questions from the NAEP Questions Tool on The Nation's Report Card (nationsreportcard.gov/nqt), published by the National Center for Education Statistics: list subjects, grades, years and content classifications; search released items for grades 4, 8 and 12 (and long-term trend ages 9, 13 and 17) in the arts, civics, economics, geography, U.S. history, mathematics, reading, science, technology and engineering literacy and writing; and read one item with its question and choices, answer key, scoring guide, sample student responses and national percent correct. NAEP material is public domain; passages and images cited as third-party copyright are withheld. - Categories: Research - Category index: [Research category](https://alexandria.firecrawl.dev/agents/categories/research) - Provider key: `nationsreportcard-gov` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://www.firecrawl.dev/app/alexandria/nationsreportcard-gov) - [OpenAPI spec](https://alexandria.firecrawl.dev/agents/providers/nationsreportcard-gov/openapi.json) ## Capabilities - [Get item](https://alexandria.firecrawl.dev/agents/providers/nationsreportcard-gov/test-questions/get_item): One released NAEP question by id: subject, grade, year, block, type, difficulty and classifications; the question and answer choices as Markdown (digitally based items are screenshots with the question text in their description); the correct answer of a multiple-choice item; the scoring guide; sample student responses with scorer comments; national percentages by response category with percent correct; the NCES source line and a bookmark link. When the item carries a citation line for third-party copyrighted material, the cited passages and all images are withheld and the citations returned. Four requests per call. - [List subjects](https://alexandria.firecrawl.dev/agents/providers/nationsreportcard-gov/test-questions/list_subjects): Subjects in the NAEP Questions Tool with their grades (or long-term trend ages). With subject and grade, also the assessment years that have released items, the item types, difficulty levels and content classifications (with descriptions) that search_items filters on. One request without a subject, two with one. - [Search items](https://alexandria.firecrawl.dev/agents/providers/nationsreportcard-gov/test-questions/search_items): Search released NAEP questions for one subject and grade: assessment years (every year by default), item format (selected response, short or extended constructed response), difficulty, content area and words in the item description. Each item: id, question id (year, block, position), NAEP accession number, type, difficulty, content area, classification, description and a link that opens it in the tool. Filters other than years apply to the tool's full result list; continuation pages through it. Two requests per call. ## 1. Choose this provider when Released NAEP test questions from the NAEP Questions Tool on The Nation's Report Card (nationsreportcard.gov/nqt), published by the National Center for Education Statistics: list subjects, grades, years and content classifications; search released items for grades 4, 8 and 12 (and long-term trend ages 9, 13 and 17) in the arts, civics, economics, geography, U.S. history, mathematics, reading, science, technology and engineering literacy and writing; and read one item with its question and choices, answer key, scoring guide, sample student responses and national percent correct. NAEP material is public domain; passages and images cited as third-party copyright are withheld. ## 2. Minimal request Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls. ```json { "provider": "nationsreportcard-gov", "capability": "test-questions/get_item", "options": { "id": 90183 } } ``` ## 3. Add provider options Use only the options needed for the task: - `id` (number, required): Item id from search_items, such as 90183. Example: `10` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "nationsreportcard-gov", capability: "test-questions/get_item", options: { id: 90183, }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "nationsreportcard-gov", "capability": "test-questions/get_item", "options": { "id": 90183 } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "nationsreportcard-gov", "capability": "test-questions/get_item", "options": { "id": 90183 } } }' ``` ### CLI ```sh firecrawl scrape 'nationsreportcard-gov/test-questions/get_item' \ --options '{"id":90183}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "nationsreportcard-gov", "capability": "test-questions/get_item", "options": { "id": 90183 } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "nationsreportcard-gov", "capability": "test-questions/get_item", "options": { "id": 90183 } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "attribution": "SOURCE: U.S. Department of Education, Institute of Education Sciences, National Center for Education Statistics, National Assessment of Educational Progress (NAEP), 2024 Mathematics Assessment.", "block": "8M1", "calculator": false, "choices": [], "citations": [], "content_classifications": "Number Properties and Operations, Low", "copyright_notice": null, "correct_answer": null, "difficulty": "easy", "grade": 8, "grade_kind": "grade", "id": 90183, "item_format": "short_constructed_response", "item_type": "SCR", "naep_id": "MACC03819N01S10", "number_in_block": 1, "observed_at_ms": 1794520800000, "performance": { "categories": [ { "category": "Off task", "correct": false, "percent": 0 }, { "category": "Omitted", "correct": false, "percent": 0 }, { "category": "Correct", "correct": true, "percent": 71 }, { "category": "Incorrect", "correct": false, "percent": 29 } ], "jurisdiction": "National", "percent_correct": 71, "source": "SOURCE: U.S. Department of Education, Institute of Education Sciences, National Center for Education Statistics, National Assessment of Educational Progress (NAEP), 2024 Mathematics Assessment.", "year": 2024 }, "question": "![Screen shot of an interactive question. QUESTION TEXT: Add. Twelve plus open parenthesis negative four close parenthesis plus twelve plus four equals A [blank] is provided for the student to enter a response.](https://www.nationsreportcard.gov/nqt/api/QueryResults/GetItemResource?TableID=3498D8B7-3494-4173-AB5C-D1485AE66D33)", "question_id": "2024-8M1 #1", "rights": "NAEP material is in the public domain, excluding any third-party copyrighted material it contains (passages, photographs, images), which carries a citation line naming its owner. This program withholds cited third-party material; reuse of it needs the copyright holder's permission.", "sample_responses": [ { "category": "Correct", "comment": "This correct response shows a correct answer of 24.", "responses": [ "24" ] }, { "category": "Incorrect", "comment": "These incorrect responses each show an answer other than 24.", "responses": [ "-24", "0" ] } ], "scoring_guide": "Solution:\n\nSample Correct Response:\n\nAnswer: 24\n\nSolution (not required in response)\n\n12 + (−4) + 12 + 4 =\n\n8 + 12 + 4 =\n\n20 + 4 = 24\n\nScore and Description\n\nCorrect\n\nAnswer of 24\n\nIncorrect\n\nIncorrect response", "source_url": "https://www.nationsreportcard.gov/nqt/ETSBookmark?2024-8M1:1", "stimuli": [], "subject": "mathematics", "subject_label": "Mathematics", "third_party_copyright": false, "year": 2024 } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Get item - Capability: `test-questions/get_item` - Description: One released NAEP question by id: subject, grade, year, block, type, difficulty and classifications; the question and answer choices as Markdown (digitally based items are screenshots with the question text in their description); the correct answer of a multiple-choice item; the scoring guide; sample student responses with scorer comments; national percentages by response category with percent correct; the NCES source line and a bookmark link. When the item carries a citation line for third-party copyrighted material, the cited passages and all images are withheld and the citations returned. Four requests per call. - Instructions: Reading a NAEP test question found with search_items, with its answer key, rubric, student work and how students nationally performed. - Cost: 5 credits per call - Capability file: [Get item](https://alexandria.firecrawl.dev/agents/providers/nationsreportcard-gov/test-questions/get_item) Accepted options: - `id` (number, required): Item id from search_items, such as 90183. Example: `10` Response schema example: ```json { "attribution": "SOURCE: U.S. Department of Education, Institute of Education Sciences, National Center for Education Statistics, National Assessment of Educational Progress (NAEP), 2024 Mathematics Assessment.", "block": "8M1", "calculator": false, "choices": [], "citations": [], "content_classifications": "Number Properties and Operations, Low", "copyright_notice": null, "correct_answer": null, "difficulty": "easy", "grade": 8, "grade_kind": "grade", "id": 90183, "item_format": "short_constructed_response", "item_type": "SCR", "naep_id": "MACC03819N01S10", "number_in_block": 1, "observed_at_ms": 1794520800000, "performance": { "categories": [ { "category": "Off task", "correct": false, "percent": 0 }, { "category": "Omitted", "correct": false, "percent": 0 }, { "category": "Correct", "correct": true, "percent": 71 }, { "category": "Incorrect", "correct": false, "percent": 29 } ], "jurisdiction": "National", "percent_correct": 71, "source": "SOURCE: U.S. Department of Education, Institute of Education Sciences, National Center for Education Statistics, National Assessment of Educational Progress (NAEP), 2024 Mathematics Assessment.", "year": 2024 }, "question": "![Screen shot of an interactive question. QUESTION TEXT: Add. Twelve plus open parenthesis negative four close parenthesis plus twelve plus four equals A [blank] is provided for the student to enter a response.](https://www.nationsreportcard.gov/nqt/api/QueryResults/GetItemResource?TableID=3498D8B7-3494-4173-AB5C-D1485AE66D33)", "question_id": "2024-8M1 #1", "rights": "NAEP material is in the public domain, excluding any third-party copyrighted material it contains (passages, photographs, images), which carries a citation line naming its owner. This program withholds cited third-party material; reuse of it needs the copyright holder's permission.", "sample_responses": [ { "category": "Correct", "comment": "This correct response shows a correct answer of 24.", "responses": [ "24" ] }, { "category": "Incorrect", "comment": "These incorrect responses each show an answer other than 24.", "responses": [ "-24", "0" ] } ], "scoring_guide": "Solution:\n\nSample Correct Response:\n\nAnswer: 24\n\nSolution (not required in response)\n\n12 + (−4) + 12 + 4 =\n\n8 + 12 + 4 =\n\n20 + 4 = 24\n\nScore and Description\n\nCorrect\n\nAnswer of 24\n\nIncorrect\n\nIncorrect response", "source_url": "https://www.nationsreportcard.gov/nqt/ETSBookmark?2024-8M1:1", "stimuli": [], "subject": "mathematics", "subject_label": "Mathematics", "third_party_copyright": false, "year": 2024 } ``` ### List subjects - Capability: `test-questions/list_subjects` - Description: Subjects in the NAEP Questions Tool with their grades (or long-term trend ages). With subject and grade, also the assessment years that have released items, the item types, difficulty levels and content classifications (with descriptions) that search_items filters on. One request without a subject, two with one. - Instructions: Before search_items, to learn which subjects, grades, years and content areas have released NAEP questions. - Cost: 5 credits per call - Capability file: [List subjects](https://alexandria.firecrawl.dev/agents/providers/nationsreportcard-gov/test-questions/list_subjects) Accepted options: - `grade` (number): Grade 4, 8 or 12 (arts 8, economics 12, technology-engineering-literacy 8); long-term trend subjects use student ages 9, 13 or 17. Example: `10` - `subject` (string): Subject slug from list_subjects: arts, civics, economics, geography, us-history, mathematics, reading, science, technology-engineering-literacy, writing, ltt-mathematics or ltt-reading (long-term trend). A tool code such as MAT also works. Needs grade. Example: `` Response schema example: ```json { "attribution": "SOURCE: U.S. Department of Education, Institute of Education Sciences, National Center for Education Statistics, National Assessment of Educational Progress (NAEP).", "filters": null, "observed_at_ms": 1794520800000, "rights": "NAEP material is in the public domain, excluding any third-party copyrighted material it contains (passages, photographs, images), which carries a citation line naming its owner. This program withholds cited third-party material; reuse of it needs the copyright holder's permission.", "source_url": "https://www.nationsreportcard.gov/nqt/searchquestions", "subjects": [ { "assessment": "main", "code": "ART", "grade_kind": "grade", "grades": [ 8 ], "label": "Arts", "subject": "arts" }, { "assessment": "main", "code": "CIV", "grade_kind": "grade", "grades": [ 4, 8, 12 ], "label": "Civics", "subject": "civics" }, { "assessment": "main", "code": "ECN", "grade_kind": "grade", "grades": [ 12 ], "label": "Economics", "subject": "economics" }, { "assessment": "main", "code": "GEO", "grade_kind": "grade", "grades": [ 4, 8, 12 ], "label": "Geography", "subject": "geography" }, { "assessment": "main", "code": "HIS", "grade_kind": "grade", "grades": [ 4, 8, 12 ], "label": "U.S. History", "subject": "us-history" }, { "assessment": "main", "code": "MAT", "grade_kind": "grade", "grades": [ 4, 8, 12 ], "label": "Mathematics", "subject": "mathematics" }, { "assessment": "main", "code": "RED", "grade_kind": "grade", "grades": [ 4, 8, 12 ], "label": "Reading", "subject": "reading" }, { "assessment": "main", "code": "SCI", "grade_kind": "grade", "grades": [ 4, 8, 12 ], "label": "Science", "subject": "science" }, { "assessment": "main", "code": "TEL", "grade_kind": "grade", "grades": [ 8 ], "label": "Technology and Engineering Literacy", "subject": "technology-engineering-literacy" }, { "assessment": "main", "code": "WRI", "grade_kind": "grade", "grades": [ 4, 8, 12 ], "label": "Writing", "subject": "writing" }, { "assessment": "long_term_trend", "code": "MAT", "grade_kind": "age", "grades": [ 9, 13, 17 ], "label": "LTT Mathematics", "subject": "ltt-mathematics" }, { "assessment": "long_term_trend", "code": "RED", "grade_kind": "age", "grades": [ 9, 13, 17 ], "label": "LTT Reading", "subject": "ltt-reading" } ] } ``` ### Search items - Capability: `test-questions/search_items` - Description: Search released NAEP questions for one subject and grade: assessment years (every year by default), item format (selected response, short or extended constructed response), difficulty, content area and words in the item description. Each item: id, question id (year, block, position), NAEP accession number, type, difficulty, content area, classification, description and a link that opens it in the tool. Filters other than years apply to the tool's full result list; continuation pages through it. Two requests per call. - Instructions: Finding NAEP test questions for practice, assessment design or curriculum alignment by subject, grade, year, topic or difficulty, before get_item reads one. - Cost: 5 credits per call - Capability file: [Search items](https://alexandria.firecrawl.dev/agents/providers/nationsreportcard-gov/test-questions/search_items) Accepted options: - `content_area` (string): Case-insensitive part of a content area or classification name from list_subjects, such as Algebra, Geometry or Literary. Example: `` - `continuation` (string): Cursor from a previous call's continuation. Example: `` - `difficulty` (string): NAEP's difficulty rating. Example: `easy` - `grade` (number, required): Grade 4, 8 or 12 (arts 8, economics 12, technology-engineering-literacy 8); long-term trend subjects use student ages 9, 13 or 17. Example: `10` - `item_format` (string): Only multiple-choice and other selected-response items, or short or extended written-answer items. Example: `selected_response` - `limit` (number): limit Example: `25` - `q` (string): Words that must all appear in the item description, such as 'fractions' or 'great migration'. Example: `` - `subject` (string, required): Subject slug from list_subjects: arts, civics, economics, geography, us-history, mathematics, reading, science, technology-engineering-literacy, writing, ltt-mathematics or ltt-reading (long-term trend). A tool code such as MAT also works. Example: `` - `years` (number[]): Assessment years to search (list_subjects with subject and grade lists them). Every year when left out. Example: `[]` Response schema example: ```json { "attribution": "SOURCE: U.S. Department of Education, Institute of Education Sciences, National Center for Education Statistics, National Assessment of Educational Progress (NAEP).", "available_years": [ 1990, 1992, 1996, 2003, 2005, 2007, 2009, 2011, 2013, 2017, 2022, 2024 ], "count": 1, "grade": 8, "grade_kind": "grade", "items": [ { "block": "8M1", "classification": "Number Properties and Operations", "complexity": "Low", "content_area": "Number Properties and Operations", "description": "Find the sum of four integers", "difficulty": "easy", "grade": 8, "id": 90183, "interactive_url": "https://enaep.cotw-ng.naep.ed.gov/cotw/8/MAT/VH336972/toolbarOn", "item_format": "short_constructed_response", "item_type": "SCR", "naep_id": "MACC03819N01S10", "number_in_block": 1, "question_id": "2024-8M1 #1", "source_url": "https://www.nationsreportcard.gov/nqt/ETSBookmark?2024-8M1:1", "year": 2024 } ], "observed_at_ms": 1794520800000, "offset": 0, "query": { "content_area": null, "difficulty": null, "item_format": null, "q": "sum of four integers" }, "rights": "NAEP material is in the public domain, excluding any third-party copyrighted material it contains (passages, photographs, images), which carries a citation line naming its owner. This program withholds cited third-party material; reuse of it needs the copyright holder's permission.", "source_url": "https://www.nationsreportcard.gov/nqt/searchquestions", "subject": "mathematics", "subject_label": "Mathematics", "total": 1, "years": [ 2024 ] } ```