/search endpoint definition props are out of sync

[joepio]

• Has things like parent but that's wrong. Should be parents I think
• Check if other props are all present
• Make sure the endpoint mentions the URLs and make them reference to each other to notify future devs to keep 'em synced
• Update description
• Subjects in properties should be escaped. Server should do this. (@Polleps knows details)