Examples

Below are some examples of queries answering specific questions you might ask of the API. Replace $token in the examples with your own. The basic cURL structure is:

curl -X "POST" "https://eapi.mattermark.com/graphql" \
     -H "Accept: application/json" \
     -H "Authorization: Bearer $token" \
     -H "Content-Type: application/graphql" \
     -d $'$query'

Replace $query with the GraphQL query below.

Details

Get Organization by domain

query {
    organization(domain:"mattermark.com") {
        name
        estFounded
    }
}

Get Multiple Organizations by domain

query {
    organizations(domains:["lyft.com", "uber.com"]) {
        name
        estFounded
        businessModels {
            name
        }
        industries {
            name
        }
        offices {
            location {
                name
            }
        }
        organizationMetrics {
            growthScore {
                current
                points(limit:10) {
                    value
                    at
                }
            }
        }
    }
}

Get Feed Events

Uses optional start and end microsecond timestamps from epoch to filter events by date.

{
  organization(id: "c#146589") {
    socialAccounts {
      slugHandle
    }
    name
    feed(start: 1489276700000000, end: 1499276700000000) {
      events {
        canonicalTimestamp
        eventType
        ... on GrowthScore {
          growthScore
                    oldGrowthScore
                    oldCanonicalTimestamp
        }
        ... on EmployeeCount {
          employeeCount
          oldEmployeeCount
          oldCanonicalTimestamp
        }
      }
    }
  }
}

Query

Companies with greater than 10 employees

MSFL

{
    "dataset": "companies",
    "filter": {
        "organizationMetrics.employeeCounts.current": {
            "gte":10
        }
    }
}

curl -X "POST" "https://eapi.mattermark.com/graphql" \
     -H "Accept: application/json" \
     -H "Authorization: Bearer $token" \
     -H "Content-Type: application/graphql" \
     -d $'query {
    organizationSummaryQuery(msfl:"{\\"dataset\\": \\"companies\\", \\"filter\\":{\\"organizationMetrics.employeeCounts.current\\":{\\"gte\\":10}}}") {
        results {
            edges {
                cursor
                node {
                    id
                    name
                    companyPersona {
                        companyStage
                        lastFundingAmount {
                            value
                            currency
                        }
                        lastFundingDate
                    }
                }
            }
            pageInfo {
                hasNextPage
                    hasPreviousPage
            }
            queryId
            totalResults
            currentPage
            pageSize
        }
    }
}
'

Setting Query Page Size

query {
    organizationSummaryQuery(msfl:"{\"dataset\": \"companies\", \"filter\":{\"organizationMetrics.employeeCounts.current\":{\"gte\":10}}}") {
        organizations(first: 2) {
            edges {
                cursor
                node {
                    id
                    name
                    companyPersona {
                        lastFundingDate
                    }
                }
            }
            pageInfo {
                hasNextPage
                hasPreviousPage
            }
            queryId
            totalResults
            currentPage
            pageSize
        }
    }
}

Paginate Query

query {
    organizationSummaryQuery(msfl:"{\"dataset\": \"companies\", \"filter\":{\"organizationMetrics.employeeCounts.current\":{\"gte\":10}}}") {
        organizations(first: 50, after:"1|50") {
            edges {
                cursor
                node {
                    id
                    name
                    companyPersona {
                        lastFundingDate
                    }
                }
            }
        }
    }
}

Funding Rounds Query

Find all series e or seed funding rounds that occurred between 2015-01-03 and 2016-01-01 in either Canada or the U.K. and between the funding range of $200,000 and $20,000,000.

query {
  fundingRoundSummaryQuery(countries: ["CAN", "GBR"], fundingDateMin: "2015-01-03", fundingDateMax: "2016-01-01", series: ["seed", "e"], amountRaisedMin: 200000, amountRaisedMax: 20000000) {
    fundingRounds(first: 50) {
      pageInfo {
        hasNextPage
        startCursor
        hasPreviousPage
      }
      currentPage
      totalResults
      edges {
        cursor
        node {
          id
          country
          companyId
          companyName
          city
          newsUrl
          industry
          country
          amountRaised {
            value
            currency
          }
          investorNames
          investorSlugs
          fundingDate
          series
        }
      }
    }
  }
}

Utilities

How many requests do I have left in the current period?

query {
    viewer {
        email
        quota {
            limit
            remaining
            reset
        }
    }
}