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:
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.
Response fields
Section titled “Response fields”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 |