Yahoo! Answers: Search for Questions

An excellent starting point for many applications, questionSearch finds open, resolved, or up-for-vote questions that include your search terms. Returned results include question, category, and user IDs, which are required by the getQuestion, getByUser, and getByCategory services.

Request URL: GET

GET Request parameters

See information on constructing REST queries

Parameter Value Description
query string (required) Search terms.
search_in string: omit for default "all". Search for keywords in: "all", "question", "best_answer".
category_id integer: omit for default to all categories Search only in the specified category ID or IDs. (IDs may be seen in the request URLs when browsing Yahoo! Answers categories.)
category_name string: omit for default to all categories (either this or category_id is required) Search only in the specified category name or names. Will match against the full path to the English category name as found on the Yahoo! Answers site. Category names are case-sensitive and should be URL-encoded. Computers & Internet>Software, for example, looks like this: Computers+%26+Internet%3ESoftware.
region string: omit for default "us". Filter based on country:
  • us: United States
  • uk: United Kingdom
  • ca: Canada
  • au: Australia
  • in: India
  • es: Spain
  • br: Brazil
  • ar: Argentina
  • mx: Mexico
  • e1: en Espanol
  • it: Italy
  • de: Germany
  • fr: France
  • sg: Singapore
You can enter multiple regions. The first will determine the destination country of hyperlinks.
date_range string:omit for default "all". Filter based on date submitted:
  • all: Anytime
  • 7: Within 7 days
  • 7-30: Within 7-30 days
  • 30-60: Within 30-60 days
  • 60-90: Within 60-90 days
  • more90: More than 90 days
sort string: omit for default "relevance". Sorting order of result set:
  • relevance: By relevance.
  • date_desc: By date, newest first.
  • date_asc: By date, oldest first.
appid string (required) The application ID. See Application IDs for more information.
type string: omit for default "all" Question status. Set to "all", "resolved", "open", or "undecided".
start integer: default 0, max 1000 Starting question to list, used to display further results.
results integer : default 10, max 50 Number of questions to be returned.
output string: omit for default "xml" Defines the output for the call. Accepted values are "xml", "json", "php", and "rss".
callback string: default "" If set, wraps the JSON object in call to the selected function. Only makes sense if output selected is JSON.

Sample Request Url:

Response fields

The schema document for this service response is located at

ResultSetContains all of the questions listed.
QuestionContain an individual question's data. Has attributes:

  • id: The unique question id
  • type: The state of the question.
SubjectThe subject of the question
ContentThe full question
DatePre-formatted date when the question was submitted
TimestampUnix timestamp for when the question was submitted
LinkLink to the question
CategoryThe Category that the question is listed under. Has attribute:
  • id: The unique category id
UserIdThe unique User id
UserNickThe nickname of the user
UserPhotoURLUser photo URL.
NumAnswersThe number of answers to the question
NumCommentsThe number of comments on the question
ChosenAnswerThe answer chosen by the user as the best
ChosenAnswererIdThe user id of the chosen answerer
ChosenAnswererNickThe nickname of the chosen answerer
ChosenAnswererTimestampThe time the answer was submitted
ChosenAnswererAwardTimestampThe time the answer was given an award

Sample response

The following is a sample response for the query cars:

Rate Limits

Yahoo! Web Search web services are limited to 5,000 queries per IP per day per API. See information on rate limiting and our Usage Policy to learn about acceptable uses and how to request additional queries.


The Yahoo! Answers Web Search services return the standard errors. There are no service-specific errors.

Ready to get started?

By applying for an Application ID for this service, you hereby agree to the Terms of Use