Skip to content

Publisher matching

The Publisher Matching endpoint provides a way to match a publisher by some query attributes:

Endpoint path: /api/publisher_match

A JSON encoded query example of a request of making an attempt to match two publishers

[
{
"name":"Rackspace Technology",
"domain":"www.rackspace.com",
"email_domain":"rackspace.com",
"linkedin_url":"https://www.linkedin.com/company/rackspace-technology/",
"hq_country_iso2":"US"
},
{
"name":"Gamaga",
"domain":"http://www.gamaga.com",
"email_domain":"gamaga.com"
}
]

The same example performed via curl:

Terminal window
curl -X "POST" "https://integrations.apptopia.com/api/publisher_match" \
-H "Authorization: $APPTOPIA_TOKEN" \
-H "Content-Type: application/json; charset=utf-8" \
-d '[{"name":"Rackspace Technology","domain":"www.rackspace.com","email_domain":"rackspace.com","linkedin_url":"https://www.linkedin.com/company/rackspace-technology/","hq_country_iso2":"US"},
{"name":"Gamaga","domain":"http://www.gamaga.com","email_domain":"gamaga.com"}]'

The responses will contain an array of results per requested query sorted by the matching score, best first, e.g:

// Abbreviated response; omitted fields and records are shown as ...
[
{
"query":{
"name":"Rackspace Technology",
"domain":"www.rackspace.com",
"email_domain":"rackspace.com",
"linkedin_url":"https://www.linkedin.com/company/rackspace-technology/",
"hq_country_iso2":"US"
},
"result":[
{
"score":3.279260935143288,
"matched_attributes":{
"hq_country_iso2":"US",
"name":"Rackspace Hosting",
"email_domain":[
"rackspace.com"
],
"domain":"rackspace.com"
},
"publisher_data":{...}
}
]
},
{
"query":{
"name":"Gamaga",
"domain":"http://www.gamaga.com",
"email_domain":"gamaga.com"
},
"result":[
{
"score":2.536036036036036,
"matched_attributes":{
"name":"Sociedad Gamers Making Games Limitada",
"email_domain":[
"gamaga.com"
],
"domain":"gamaga.com"
},
"publisher_data":{...}
},
{
"score":0.888888888888889,
"matched_attributes":{
"name":"GamaGame"
},
"publisher_data":{}
},
{
"score":0.888888888888889,
"matched_attributes":{
"name":"Gamagame"
},
"publisher_data":{...}
},
{
"score":0.7083333333333334,
"matched_attributes":{
"name":"gamagal.net"
},
"publisher_data":{...}
}
]
}
]

A request only can be performed as POST with JSON-encoded body as array of queries where a single query should request for a single publisher matching.

Supported query parameters:

Param Description
id optional, number, unique query’s identifier (to simplify distinction in case of multi-request)
name string, represent name of wanted publisher
domain string, publishers domain
email_domain string, publishers email domain
hq_country_iso2 string, publisher’s HQ country code in ISO 3166-1 alpha-2 format, e.g. ‘US’
founded_on string, date of foundation in ISO 8601 format, e.g. ‘2021-01-11’
twitter_url string, URL of publisher’s Twitter page
facebook_url string, URL of publisher’s Facebook page
linkedin_url string, URL of publisher’s LinkedIn page
crunchbase_url string, URL of publisher’s Crunchbase page
keep_only_alive boolean, when set to true, result is filtered only to publishers with positive WW MAU (last 30 days)

The more attributes with correct data provided in query the higher is the likelihood of a correct match.

The result records attributes are

Attribute Description
score matching score, based on matched query attributes, the higher - the better
matched_attributes json object of matched attributes
publisher_data json object, represent publisher data (id, store, contacts, set of app ids, etc.) that corresponds to the matched_attributes