Abstract user icon
zh
创作者

Search: 网络故事 API 参考

Search Web Stories that matches the search parameters specified in an API request.

Methods

searchReturns a list of Web Stories.

API Request

GET https://webstories.today/api/v1/search

Parameters

qstring, required
The q parameter specifies the query term to search for.
apikeystring, required
categorystring, optional
Use the displayname_encoded from the StoryCategory Resource.
languagestring, required, default: en
The language parameter specifies in which language the category list should be returned.
maxresultsstring, optional
default: 10, max 50


Request body

Do not provide a request body when calling this method.

Response

The following table defines the properties that appear in this resource:

titlestring
Title of the web story
descriptionstring
The description of the web stories, max 280 chars long
languagestring
The language of the story, 2 letter language code.
urlstring
The full URL of the web story
channelinfoChannelInfo
Information on the channel/creator who owns the web story.
categoryStoryCategory
Information on the category, the web story belongs too.


If successful, this method returns a response body with the following structure:
{
  "searchquery": "dogs",
  "searchcategory": "",
  "pagination": 1,
  "webstories": [
    {
      "title": "Amazing facts about dogs that are unbelievable.",
      "url": "fascinating-facts-about-dogs",
      "language": "en",
      "category": {
        "displayname": "Animals \u0026 Pets",
        "displayname_encoded": "pets"
      },
      "description": "Dogs are around us and are part of our family. They give unconditional love and companionship. Is there something far more than what we know about them?"
    },
    {
      "title": "Importance of dog toys and their role in development",
      "url": "importance-of-dog-toys",
      "language": "en",
      "category": {
        "displayname": "Animals \u0026 Pets",
        "displayname_encoded": "pets"
      },
      "description": "Dog toys play a crucial role in the proper growth of the dog."
    },
    {
      "title": "10 ways your dog says I LOVE YOU",
      "url": "10-ways-your-dog-says-i-love-you",
      "language": "en",
      "category": {
        "displayname": "Animals \u0026 Pets",
        "displayname_encoded": "pets"
      },
      "description": "Dogs are very communicative if you know how to read their expression. Here are 10 ways your dog is telling you he or she loves you"
    },
    {
      "title": "Why do dogs make the best emotional support companions?",
      "url": "why-do-dogs-make-the-best-emotional-support-companions",
      "language": "en",
      "category": {
        "displayname": "Animals \u0026 Pets",
        "displayname_encoded": "pets"
      },
      "description": "Companionship with dogs make us happy, healthier and more complete person."
    }
  ]
}