Back to list

search/{API key}/

The workhorse of the site. Search for lessons and Companion Resources in the Curriculum Matrix.

Extra Parameters:

Parameter API key
Type (20 character) string
Description This key is given to you by a national administrator.
GETParameter findlesson
Description A flag indicating searching for lessons
Example https://api.agclassroom.org/api/search/ade32765c9f5487efa15/?findresource&findlesson&search=apples
GETParameter findresource
Description A flag indicating searching for Companion Resources
Example https://api.agclassroom.org/api/search/ade32765c9f5487efa15/?search=apples&findresource
GETParameter search
Type url-encoded string
Description Indicates the search term returned from search bar
Example https://api.agclassroom.org/api/search/ade32765c9f5487efa15/?findlesson&search=apples
GETParameter commoncore
Type number(s)
Description A comma separated list of Common Core standard group (identifiers or constants) to search within.
Examples https://api.agclassroom.org/api/search/ade32765c9f5487efa15/?findlesson&search=apples&commoncore=2,4
https://api.agclassroom.org/api/search/ade32765c9f5487efa15/?findlesson&search=apples&commoncore=READ,WRITE
GETParameter grade
Type number -or- string
Description A comma separated list of grade abbreviations or grade band abbreviations to search within.
Example https://api.agclassroom.org/api/search/ade32765c9f5487efa15/?findlesson&search=apples&grade=K,1,2
https://api.agclassroom.org/api/search/ade32765c9f5487efa15/?findlesson&search=apples&grade=MS,EE
GETParameter contentarea
Type number(s) -or- string
Description A comma separated list of Content Area (identifiers or constants) to search within.
Examples https://api.agclassroom.org/api/search/ade32765c9f5487efa15/?findlesson&search=apples&contentarea=2,4
https://api.agclassroom.org/api/search/ade32765c9f5487efa15/?findlesson&search=apples&contentarea=GEOGRAPHY,HISTORY
GETParameter theme
Type number(s)
Description A comma separated list of theme (identifiers or constants) to search within.
Example https://api.agclassroom.org/api/search/ade32765c9f5487efa15/?findlesson&search=apples&theme=5
https://api.agclassroom.org/api/search/ade32765c9f5487efa15/?findlesson&search=apples&theme=ANIMALS,CULTURE
GETParameter mediatype
Type number(s) -or- string
Description A comma separated list of media type (identifiers or constants) to search within.
Examples https://api.agclassroom.org/api/search/ade32765c9f5487efa15/?findresource&search=apples&mediatype=2,4
https://api.agclassroom.org/api/search/ade32765c9f5487efa15/?findresource&search=apples&mediatype=POSTER

HTTP Method

GET

Requires authentication:

Yes

Return Format:

JSON

Return Example:

{

success:true

message:Found.

lessoncount:8

resourcecount:23

lessons: [...]

0 {...}

id:374

title:A is for Apples

purpose:Students will use the five senses to investigate apples, identify and model the parts of an apple, make applesauce, and learn how apples are grown.

1 {...}

id:673

title:An Apple a Day Keeps the Doctor Away

purpose:Students will explore organic and conventional farming practices by analyzing multimedia texts to investigate the differences between conventionally and organically grown apples.

2 {...}

. . .

resources: {...}

ACTIVITY {...}

media:2

shorttitle:ACTIVITY

title:Activity

count:2

resources: [...]

0 {...}

id:132

mediatype:Activity

title:Farm Pop-Ups

description:Students use this template to create a pop-up game to reinforce agricultural concepts....

1 {...}

id:847

mediatype:Activity

title:The Very Hungry Western Caterpillar

description:Based off of Erik Carle's "Very Hungry Caterpillar", this caterpillar takes a journey....

BOOK {...}

. . .

}