East River View Software Company

Meta API

This page contains documentation for our Meta API service. This service fetches metadata about web pages.

Request Parameters

All endpoints accept the same parameters

  • Name
    url
    Type
    string
    Description

    The URL to fetch metadata for. When the protocol is not included, we'll add https:// to your input for you.

  • Name
    language
    Type
    string
    Description

    By default, no Accept-Language is set by our crawlers. To include one, use this parameter. This will only work for sites that are localized.

Icons

The /icons endpoint lets you fetch all the icons linked to by a given web page. This includes the "apple-touch-icon" as well as any "favicon" links.

Below is an example response from this endpoint:

// curl https://meta-api.ervsoftware.co/icons?url=instagram.com -H 'Authorization: [API_TOKEN]'
{
  "canonical_url": "",
  "icon_url": "https://static.cdninstagram.com/rsrc.php/y4/r/QaBlI0OZiks.ico",
  "icons": [
    {
      "rel": "apple-touch-icon",
      "url": "https://static.cdninstagram.com/rsrc.php/v3/yR/r/lam-fZmwmvn.png",
      "height": 76,
      "width": 76
    },
    {
      "rel": "apple-touch-icon",
      "url": "https://static.cdninstagram.com/rsrc.php/v3/ys/r/aM-g435MtEX.png",
      "height": 120,
      "width": 120
    },
    {
      "rel": "apple-touch-icon",
      "url": "https://static.cdninstagram.com/rsrc.php/v3/yx/r/H1l_HHqi4p6.png",
      "height": 152,
      "width": 152
    },
    {
      "rel": "apple-touch-icon",
      "url": "https://static.cdninstagram.com/rsrc.php/v3/yB/r/-7Z_RkdLJUX.png",
      "height": 167,
      "width": 167
    },
    {
      "rel": "apple-touch-icon",
      "url": "https://static.cdninstagram.com/rsrc.php/v3/yG/r/De-Dwpd5CHc.png",
      "height": 180,
      "width": 180
    }
  ]
}

Redirects

The /redirects endpoint will capture all the redirect "hops" for a given URL, if any. We'll also provide the exact redirect status code returned by the web server. This API be could be useful for validation purposes or ensuring a web server is properly configured.

// curl https://meta-api.ervsoftware.co/redirects?url=es.pn/superbowl -H "Authorization: [API_TOKEN]"
{
  "locations": [
    {
      "status_code": 302,
      "location": "http://www.espn.com/news"
    }
  ]
}

Unfurl

The /unfurl endpoint will detailed metadata information about a webpage. This includes the page's title, description, favicon, and "Open Graph" protocol metatags.

{
  "application_name": "The New York Times",
  "canonical_url": "https://www.nytimes.com",
  "page_description": "Live news, investigations, opinion, photos and video by the journalists of The New York Times from more than 150 countries around the world. Subscribe for coverage of U.S. and international news, politics, business, technology, science, health, arts, sports and more.",
  "icon_url": "https://www.nytimes.com/vi-assets/static-assets/favicon-d2483f10ef688e6f89e23806b9700298.ico",
  "page_keywords": "news, live updates, latest news, breaking news, local news, current events, top stories, livestream, live video, world news, us news",
  "resolved_url": "https://www.nytimes.com/",
  "open_graph": {
    "og:title": "The New York Times - Breaking News, US News, World News and Videos",
    "og:type": "website",
    "og:url": "https://www.nytimes.com",
    "og:description": "Live news, investigations, opinion, photos and video by the journalists of The New York Times from more than 150 countries around the world. Subscribe for coverage of U.S. and international news, politics, business, technology, science, health, arts, sports and more.",
    "og:image": [
      {
        "url": "https://static01.nyt.com/newsgraphics/images/icons/defaultPromoCrop.png"
      }
    ]
  },
  "page_title": "The New York Times - Breaking News, US News, World News and Videos"
}