locked
call via http://api.search.live.net/xml.aspx : full parameters list and two more questions RRS feed

  • Question

  • Hi there!

    Thanks for this service, hope it will be be really useful for me.

    At a glancle I plan to use simplest approach for me - just via forming single line request.

    Here - http://msdn.microsoft.com/en-us/library/dd440734.aspx - I had found info how to create a basic test like "http://api.search.live.net/xml.aspx?Appid={0}&sources={1}&query={2}" and implemented it successfully.

    (Q1) But still cannot find an info about other nice optional parameters like number of result, filtering adult content or not, etc. May someone point me to this?

    I already studied forum a bit and able to create site limitation and logic operation, so I am pretty familiar with requests like
    (weather OR windows) AND (site:microsoft.com OR site:aol.com)

    (Q2) I heard about 1500 chars limitation - is it 'search' part limitation or for whole parameters string?

    (Q3) If I'll go forward with this solution for one of my project, I develop architecture when my app will server a several users - roughly a proxying process. Can you please tell me about limitation about number of requests per time unit? I suppose I'll have very uneven distribution of requests in final environment.

    Thanks in advance,
    Dennis
    Sunday, February 15, 2009 10:18 PM

Answers

  • Hi Dennis,

    The specific parameters of every type (how many results, starting from which offset, etc.) are typical of each type and are documented as part of the type in question. Case in point - the sourcetype web has the parameters web.count and web.offset to do the operations mentioned.
    Adult settings are determined at the SearchRequest level - see the documentation at http://msdn.microsoft.com/en-us/library/dd251083.aspx

    1500 characters are the limit of the query parameter. Going beyond this will risk truncations of the query string.

    Any use that goes beyond ~10 queries/second for regular queries or 7 QPS for complex queries will be flagged as a DoS attack and cause the refusal of any traffic from the originating IP. If you plan to send more than this traffic rate, please contact api_tou at microsoft dot com. There is a standard solution for premium partners.

    This said, 10 queries/second = 25 million queries/month. If you are really going to have this level of traffic, you probably want to have a better service than the self-serve.

    HTH

    --Alessandro
    • Proposed as answer by AlessC Monday, February 16, 2009 6:28 AM
    • Marked as answer by WorkingDay Monday, February 16, 2009 3:12 PM
    • Marked as answer by WorkingDay Monday, February 16, 2009 3:24 PM
    Monday, February 16, 2009 6:28 AM
  • Hi Alessandro!

    Q2 - thanks for your answer.

    Q3 - thanks, great news, I think it will be more than enough for my task.

    Q1 - thanks for giving me right direction. This link http://msdn.microsoft.com/en-us/library/dd250852.aspx described exactly what I wanted. I decided to post link here - might be useful for someone else.

    Thanks a lot for your work!

    Regards, Dennis

    • Marked as answer by WorkingDay Monday, February 16, 2009 3:12 PM
    Monday, February 16, 2009 3:11 PM

All replies

  • Hi Dennis,

    The specific parameters of every type (how many results, starting from which offset, etc.) are typical of each type and are documented as part of the type in question. Case in point - the sourcetype web has the parameters web.count and web.offset to do the operations mentioned.
    Adult settings are determined at the SearchRequest level - see the documentation at http://msdn.microsoft.com/en-us/library/dd251083.aspx

    1500 characters are the limit of the query parameter. Going beyond this will risk truncations of the query string.

    Any use that goes beyond ~10 queries/second for regular queries or 7 QPS for complex queries will be flagged as a DoS attack and cause the refusal of any traffic from the originating IP. If you plan to send more than this traffic rate, please contact api_tou at microsoft dot com. There is a standard solution for premium partners.

    This said, 10 queries/second = 25 million queries/month. If you are really going to have this level of traffic, you probably want to have a better service than the self-serve.

    HTH

    --Alessandro
    • Proposed as answer by AlessC Monday, February 16, 2009 6:28 AM
    • Marked as answer by WorkingDay Monday, February 16, 2009 3:12 PM
    • Marked as answer by WorkingDay Monday, February 16, 2009 3:24 PM
    Monday, February 16, 2009 6:28 AM
  • Hi Alessandro!

    Q2 - thanks for your answer.

    Q3 - thanks, great news, I think it will be more than enough for my task.

    Q1 - thanks for giving me right direction. This link http://msdn.microsoft.com/en-us/library/dd250852.aspx described exactly what I wanted. I decided to post link here - might be useful for someone else.

    Thanks a lot for your work!

    Regards, Dennis

    • Marked as answer by WorkingDay Monday, February 16, 2009 3:12 PM
    Monday, February 16, 2009 3:11 PM